واجهة برمجة تطبيقات صفحة Facebook

​

النشر على Facebook

{
  "post": "The best FB post ever #best https://www.facebook.com", // empty string is allowed
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["facebook"]
}

• سيعرض Facebook تلقائيًا معاينة للرابط في المنشور ما لم تُضمَّن صورة أو فيديو. في المثال أعلاه ستظهر الصورة. حذف الصورة سيؤدي إلى ظهور معاينة الرابط.
• إذا لم ينتهِ الفيديو بامتداد فيديو معروف مثل mp4، يرجى استخدام المعامل isVideo. راجع نقطة نهاية /post للتفاصيل.
• يدعم Facebook أيضًا إرسال الوسائط دون نص منشور. إذا لم ترغب في تضمين نص للمنشور، أرسل سلسلة فارغة post: "".
• راجع إرشادات وسائط Facebook وتصريح Facebook لمزيد من المعلومات.

​

صور Carousel

{
  "faceBookOptions": {
    "carousel": {
      // The URL of the "See More At" button - required
      "link": "URL of See More At...",
      "items": [
        // 2 min, 10 max elements in the array
        {
          "name": "Image name", // optional
          "link": "URL when image clicked", // required
          "picture": "URL of image" // required
        },
        {
          "name": "Image name",
          "link": "URL when image clicked",
          "picture": "URL of image"
        }
      ]
    }
  }
}

• معامل link على المستوى الأعلى هو الـ URL في نهاية الـ carousel.
• items مصفوفة من كائنات تحتوي على القيم التالية. حد أدنى عنصران و10 عناصر كحد أقصى في مصفوفة items.
• picture — الـ URL لصورة الـ carousel.
• link — الـ URL عند النقر على الصورة.
• name — (اختياري) الصورة المعروضة في كل بطاقة صورة.

​

Facebook Reels

{
  "post": "The description of the video",
  "platforms": ["facebook"],
  "mediaUrls": ["https://img.ayrshare.com/012/reel.mp4"],
  "faceBookOptions": {
    "reels": true,
    "title": "Super title for the Reel", // optional
    "thumbNail": "https://img.ayrshare.com/012/reel-thumbnail.jpg" // optional
  }
}

• reels: عيّن إلى true لنشر الفيديو إلى Reels. مطلوب إذا أردت النشر إلى Facebook Reels.
• title: عنوان الفيديو بحد أقصى 255 حرفًا. سيُقتطع ما يزيد عن 255 حرفًا. اختياري.
• thumbNail: الصورة المصغرة (صورة الغلاف) للفيديو. يجب أن تكون الصورة المصغرة عنوان URL لملف JPEG أو PNG. يجب أن تكون الصورة المصغرة أقل من 10 ميغابايت. اختياري.

{
  "action": "post",
  "status": "error",
  "code": 108,
  "message": "Facebook Error: Facebook cannot process your post at this time. Please try again. ",
  "detailsData": {
    "id": "104619420979033_36930641143",
    "verifyReelsUrl": "https://api.ayrshare.com/history/36930641143?searchPlatformId=true&platform=facebook",
    "verifyReelsIn": "2024-01-26T00:07:05.170Z",
    "postUrl": "https://www.facebook.com/1046194209_36930641143",
    "reels": true
  },
  "retryAvailable": true,
  "platform": "facebook"
}

​

Facebook Stories

• لا تدعم Facebook Stories نص المنشور — سيتم تجاهل أي نص مُقدَّم في حقل post، بما في ذلك الإشارات.
• الصورة أو الفيديو المرفوع لقصة لا يمكن أن يكون قد استُخدم في منشور سابق.
• لا يمكن أن يتجاوز فيديو القصة 60 ثانية.
• فعّل أرشيف القصص لتتمكن من إجراء GET على القصص.

{
  "post": "", // Ignored by stories
  "platforms": ["facebook"],
  "mediaUrls": ["https://img.ayrshare.com/012/stories.mp4"],
  "faceBookOptions": {
    "stories": true
  }
}

​

تسميات توضيحية للوسائط

{
  "faceBookOptions": {
    "mediaCaptions": ["This is my best pic", "😃 here is the next one"]
  }
}

​

وسم الموقع

// Using the Facebook Page Id - must be associated with a location
{
  "faceBookOptions": {
    "locationId": 7640348500 // Guggenheim Museum Page Id
  }
}

​

استهداف الجمهور

1. Facebook Targeting: يتيح لك هذا تحديد جمهور منشورك بناءً على عوامل مثل العمر والجنس والموقع والحالة الاجتماعية. بضبط هذه المعاملات، يمكنك ضمان عرض منشورك فقط للأشخاص الذين يستوفون المعايير المحددة.
2. Facebook Feed Targeting: يُمكّنك هذا الخيار من تحسين رؤية منشورك ضمن News Feeds لجمهورك المستهدف.

​

Targeting

• ageMin: يُحدد الحد الأدنى للعمر الذي يمكنه عرض المنشورات. القيم المقبولة 13 أو 15 أو 18 أو 21 أو 25. سيتم رفض الأعمار الأخرى.
• countries: يُعرف أيضًا بالتسييج الجغرافي (geofencing)، يمكنك تحديد البلدان التي يمكنها عرض المنشور. مصفوفة من رموز البلدان. الحد الأقصى لعدد البلدان التي يمكن استهدافها هو 25. إذا كنت بحاجة إلى استهداف أكثر من 25 دولة أو تقييد دول معينة، يُرجى الاطلاع على قيود دولة صفحة Facebook.

{
    "faceBookOptions": {
        "targeting": {
            "ageMin": 18,
            "countries": ["DE", "BR"]
    }
}

​

Feed Targeting

• ageMin: يُحدد الحد الأدنى للعمر الذي يمكنه عرض المنشورات. قيمة صحيحة 13 أو أكثر. الافتراضي هو 0.
• ageMax: يُحدد الحد الأقصى للعمر الذي يمكنه عرض المنشورات. قيمة صحيحة 65 أو أقل.
• countries: يُعرف أيضًا بالاستهداف الجغرافي، يمكنك الإشارة إلى البلدان التي ينبغي أن تكون قادرة على عرض المنشور. مصفوفة من رموز البلدان.
• collegeYears: استهدف عمر تخرج الجامعة لعرض المنشور. مصفوفة من الأعداد الصحيحة لسنة التخرج من الجامعة.
• educationStatuses: استهدف الحالة التعليمية لعرض المنشور. مصفوفة من الأعداد الصحيحة للاستهداف بناءً على مستوى التعليم. استخدم 1 للمرحلة الثانوية، و2 للمرحلة الجامعية، و3 لـ خريج.
• genders: استهدف الجنس لعرض المنشور. مصفوفة من الأعداد الصحيحة لاستهداف جنس معيّن. 1 يستهدف جميع المشاهدين الذكور و2 الإناث. الافتراضي استهداف كليهما.
• relationshipStatuses: استهدف الحالة الاجتماعية لعرض المنشور. مصفوفة من الأعداد الصحيحة للاستهداف بناءً على الحالة الاجتماعية. استخدم 1 لأعزب، و2 لـ ‘في علاقة’، و3 لـ متزوج، و4 لـ مخطوب. الافتراضي جميع الأنواع.

{
  "feedTargeting": {
    "ageMax": 30,
    "ageMin": 26,
    "countries": ["DE", "BR"],
    "genders": [1, 2],
    "relationshipStatuses": [1, 2]
  }
}

​

النص البديل

{
  "faceBookOptions": {
    // Array of Alt Texts
    "altText": ["This is my best pic", "😃 here is the next one"]
  }
}

​

الصورة المصغّرة للفيديو

{
  "faceBookOptions": {
    "thumbNail": "https://octodex.github.com/images/Fintechtocat.png"
  }
}

​

عنوان الفيديو

{
  "faceBookOptions": {
    "title": "The best video ever!"
  }
}

​

صور GIF المتحركة

{
  "randomPost": true,
  "platforms": ["facebook"],
  // Set to true if the GIF URL does not end in .gif or .GIF
  "isVideo": false,
  // Only one URL is allowed in the array
  "mediaUrls": ["https://img.ayrshare.com/012/cat.gif"]
}

​

إشارات صفحة Facebook

​

الإشارة باسم الصفحة

{
  "post": "This is the best social media api by @Ayrshare"
}

​

الإشارة بمعرّف الصفحة

{
  "post": "This is the best social media api by @[738681876342836]" // Ayrshare Page ID
}

​

العثور على معرّف صفحة Facebook

​

نقطة نهاية Brand

​

على Facebook.com

1. من News Feed في Facebook، انقر على Pages في القائمة الجانبية اليسرى.
2. انقر على اسم صفحتك للانتقال إلى صفحتك.
3. انقر على About في أعلى صفحتك. إن لم تراه، انقر على More▼.
4. مرّر لأسفل للعثور على Page ID الخاص بك أسفل MORE INFO.

• إذا كانت صفحة Facebook لها عنوان URL مثل https://www.facebook.com/ayrshare-1234567890 فإن المعرّف هو 1234567890.
• إذا كانت صفحة Facebook لها عنوان URL مثل:

​

تفعيل إشارات الصفحة

1. بعرضك كصفحتك، انقر على صورة الملف الشخصي لصفحتك في الزاوية اليمنى العليا.
2. انقر على Settings & Privacy -> Settings.
3. في قائمة Settings، انقر على Privacy.
4. انقر على Page and Tagging.
5. مرّر لأسفل إلى Reviewing.
6. بدّل الإعدادات للسماح بالوسم والإشارات.

​

Meta Business Suite

​

المنشورات كمسوّدة

{
  "faceBookOptions": {
    "draft": true
  }
}

​

وقت نشر مجدول

{
  "faceBookOptions": {
    "scheduledPublishDate": "2023-09-28T21:44:06Z" // Future date in UTC
  }
}

​

معاينة الرابط

{
  "faceBookOptions": {
    "link": "https://www.ayrshare.com/instagram-hashtag-guide/"
  }
}

​

إعلانات Facebook

​

حدود الأحرف

​

معلومات إضافية

​

كيف أُضيف فواصل الأسطر أو النص المنسّق إلى منشور Facebook؟

​

لماذا أرى “Published by Ayrshare” على منشور؟