‏‎Graph API‎‏

الإصدار 2.5

واجهة Graph API | API التسويق

الإصدار 2.5 من واجهة Graph API

تم الطرح في 7 أكتوبر 2015 | متوفر حتى 12 أبريل 2018

انتهت صلاحية هذا الإصدار في 12 أبريل 2018. يُرجى استخدام أداة ترقية API لترقية تطبيقاتك قبل هذا التاريخ. تعرف على المزيد حول ترقية التطبيقات في دليل الترقية.

الميزات الجديدة

الصفحات

  • الأذونات

    • يتطلب GET {user_id}/accounts الآن توفير الإذن manage_pages أو pages_show_list؛ الأخير هو إذن جديد في الإصدار 2.5.
    • يتطلب كل من POST {page_id}/call_to_actions وPOST/DELETE {call-to-action-id} توفير الإذن الجديد pages_manage_cta الذي نقدمه في الإصدار 2.5.

  • إدارة أزرار الدعوة لاتخاذ إجراء - بإمكان الصفحات الآن إدارة أزرار الدعوة لاتخاذ إجراء في الصفحة:

    • GET page/call_to_actions أو GET {call-to-action-id} لقراءة الدعوة لاتخاذ إجراء.
    • POST page/call_to_actions لإضافة دعوة لاتخاذ إجراء في الصحفة.
    • POST {call-to-action-id} للتحديث.
    • DELETE {call-to-action-id} لحذف دعوة لاتخاذ إجراء من الصفحة.

  • عقدة المكان - تمت إضافة الحقل التالي إلى العقدة Place:

    • overall_rating - يوفر هذا متوسط التقييم استنادًا إلى مراجعات العامة لمكان.

مقاطع الفيديو

  • تحميل الفيديو - تمت إضافة المعلمات التالية:

    • slideshow_spec - تنشئ مقاطع فيديو تتضمن عرض شرائح عن طريق تحميل الصور.
    • secret - لن يظهر الفيديو المنشور في علامة التبويب "آخر الأخبار" أو "اليوميات" أو "فيديو الصفحة" في فيسبوك ولا يمكن البحث عنه. يمكن عرض مقطع الفيديو ومشاركته باستخدام الرابط الثابت فقط. لمستخدمي الصفحات فقط.
    • social_actions - تمكين استخدام إجراءات التواصل الاجتماعي على فيسبوك أو حظرها مثل تسجيلات الإعجاب والتعليقات والمشاركة في مقطع فيديو مخفي. لمستخدمي الصفحات فقط.

  • تعديل الفيديو - تمت إضافة المعلمات التالية:

    • publish_to_videos_tab - تعمل على نشر عناصر الفيديو بشكل عام في علامة تبويب مقاطع فيديو الصفحة، وليس في صفحة آخر الأخبار أو اليوميات.
    • publish_to_news_feed - تعمل على نشر عناصر الفيديو بشكل عام قي علامة تبويب "آخر الأخبار" و"اليوميات" و"مقاطع فيديو الصفحة".

التغييرات

الصفحات

  • نقطة نهاية المنشورات التي تمت الإشارة إليها - سيتضمن GET /{page-id}/tagged كل المنشورات العامة التي تمت الإشارة فيها إلى الصفحة. يلزم توفير رمز وصول الصفحة يتضمن الإذن manage_pages.

المنشورات

  • story_tags - يتم الآن إرجاع مصفوفة، وليس كائنًا.

المستخدمون

  • يرجع GET /{user-id}?fields=address خطأً - سيرجع الحقل address، الذي كان متوفرًا في الإصدارات السابقة، ويرجع قيمة فارغة، خطأً بدءًا من الإصدار 2.5.

أحداث Webhooks (التحديثات الفورية سابقًا)

  • تعطيل الاشتراكات تلقائيًا - نعمل الآن على تعطيل اشتراكات Webhooks تلقائيًا إذا فشل عنوان URL الاستدعاء لمدة 7 أيام متواصلة. يمكنك إعادة تمكينها عن طريق إرسال طلب POST إلى /subscriptions. لا ينطبق هذا التغيير على اشتراكات عمليات الدفع.

  • تحديث الاشتراكات الحالية - يمكن تعديل اشتراكات Webhooks الحالية عبر API /subscriptions. وسيعمل طلب POST /subscriptions على تعديل الاشتراك لموضوع معين من دون استبدال الحقول الموجودة. يمكنك حذف حقول محددة من اشتراكك عن طريق تضمين معلمة الحقول عند استدعاء DELETE /subscriptions.

حالات إيقاف الاستخدام

  • لا توجد حالات إيقاف استخدام.

التغييرات العاجلة على مدى 90 يومًا

الصفحات

  • تنسيق محدد URI لتطبيقات علامة تبويب الصفحة - لن يعمل تنسيق محدد URI لتطبيقات علامة تبويب الصفحة https://www.facebook.com/{vanity}?v={app_id} بعد 90 يومًا من هذا الإصدار. يُرجى استخدام https://www.facebook.com/{vanity}?sk={app_id} أو https://www.facebook.com/{vanity}/{app_id}.

Webhooks

  • تحديثات فورية عبر HTTPS فقط - لا يمكن إنشاء اشتراكات جديدة من خلال عنوان URL استدعاء ليس بتنسيق HTTPS. وهذا يؤثر على تحديثات User وPage وApp وPayment.