الإصدار 7.0

واجهة Graph API

تم الطرح في 5 مايو 2020 | متوفر حتى 4 أغسطس 2022 | منشور المدونة

ملحق فيسبوك للأعمال بالإصدار 2

ينطبق هذا التغيير على كل الإصدارات.

تمت إضافة حقلين جديدين إلى ملحق فيسبوك للأعمال بالإصدار 2.

• معرف الحساب الإعلاني (ad_account_id) — يمثل معرف الحساب الإعلاني الذي حدده المستخدم داحل ملحق FBE. ويمكن استخدام هذا الحساب الإعلاني لإدارة الإعلانات إذا كان تطبيقك لديه أذونات ads_management.

• معرف الكتالوج (catalog_id) — معرف الكتالوج الذي حدده المستخدم داخل ملحق FBE. ويمكن استخدام هذا المعرف لإدارة كتالوج المنتجات.

Instagram

البحث بالهاشتاج

ينطبق هذا التغيير على الإصدار 7.0 والإصدارات الأحدث.

يمكنك الآن طلب الحقل timestamp في وسائط IG والذي يتم إرجاعه بواسطة استعلامات GET /{ig-hashtag-id}/top_media وGET /{ig-hashtag-id}/recent_mediaللبحث بالهاشتاج. على سبيل المثال: GET /{ig-hashtag-id}/top_media?fields=timestamp.

Messenger

المكون الإضافي "دردشة العملاء"

ينطبق هذا التغيير على الإصدار 7.0 والإصدارات الأحدث وسينطبق على كل الإصدارات اعتبارًا 2 نوفمبر 2020.

عند بدء محادثة جديدة أو متابعة محادثة موجودة عبر المكون الإضافي "دردشة العملاء"، ستحتوي إشعارات webhook الأولية messaging_postbacks وmessaging_referrals على معرف user_ref مجهول الهوية للمستخدم بدلاً من معرف المستخدم على مستوى الصفحة (PSID). بمجرد أن يرسل المستخدم رسالة، ستحتوي إشعارات webhook اللاحقة على معرف المستخدم على مستوى الصفحة.

الملفات الشخصية للصفحة في Messenger

ينطبق هذا التغيير على الإصدار 7.0 والإصدارات الأحدث.

تم إيقاف استخدام الخاصية home_url في الملفات الشخصية للصفحة في Messenger لكل العمليات (GET وPOST وDELETE).

Open Graph

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

ينطبق هذا التغيير على الإصدار 7.0 والإصدارات الأحدث وسينطبق على كل الإصدارات اعتبارًا من 3 أغسطس 2020.

• GET /{open-graph-action-type-id}
• POST /{user-id}/{open-graph-action-type-id}

الصفحات

معرفات المستخدم على مستوى التطبيق

تنطبق هذه التغييرات على الإصدار 7.0 والإصدارات الأحدث وستنطبق على كل الإصدارات اعتبارًا من 5 مايو 2021.

في 1 مايو 2018، أصبحت واجهة API الصفحات ترجع معرفات المستخدم على مستوى الصفحة بدلاً من معرفات المستخدم على مستوى التطبيق لكل التطبيقات الجديدة. وستواصل التطبيقات التي تم إنشاؤها قبل هذا التاريخ تلقي المعرفات على مستوى التطبيق ما لم تشترك لتلقي المعرفات على مستوى الصفحة. ستتلقى كل التطبيقات الآن المعرفات على مستوى الصفحة من جانب واجهة API الصفحات.

تتيح لك API المعرف على مستوى الصفحة تعيين المعرفات على مستوى التطبيق إلى المعرفات على مستوى الصفحة المكافئة لها. تم إيقاف استخدام API في الإصدار 7.0 والإصدارات الأحدث، ولكن لا يزال يمكن استخدامها مع الإصدارات الأقدم حتى 5 مايو 2021.

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

تنطبق هذه التغييرات على الإصدار 7.0 والإصدارات الأحدث وستنطبق على كل الإصدارات اعتبارًا من 3 أغسطس 2020.

سيتم إيقاف استخدام نقاط النهاية التالية:

• GET /{page-id}/featured_videos_collection
• POST /{page-id}/albums

الأذونات

تم إيقاف استخدام الإذن manage_pages واستبداله بأربعة أذونات جديدة:

• pages_manage_ads
• pages_manage_metadata
• pages_read_engagement
• pages_read_user_content

تم إيقاف استخدام الإذن publish_pages واستبداله بإذنين جديدين:

• pages_manage_posts
• pages_manage_engagement

سيتم ترحيل التطبيقات التي تم اعتمادها للحصول على الإذن manage_pages أو publish_pages أو كليهما إلى الأذونات الجديدة بحلول 1 يونيو 2020.

بالنسبة للتطبيقات التي تم إرسالها ولكن لم تتم مراجعتها بعد للحصول على الإذن manage_pages أو publish_pages أو كليهما، ستستمر عملية المراجعة كالمعتاد. بمجرد الحصول على الموافقة، سيتم ترحيل التطبيقات إلى الأذونات الجديدة بحلول 1 يونيو 2020.

لتقديم طلب مراجعة أو إعادة إرسال التطبيق، بالنسبة للحصول على أذونات الصفحة، قبل 1 يونيو 2020، حدّد الأذونات التي تظهر في لوحة معلومات التطبيق، إما manage_pages أو publish_pages أو كليهما أو الأذونات الجديدة. سيتم ترحيل تطبيقك تلقائيًا إلى استخدام الأذونات الجديدة بحلول 1 يونيو 2020 إذا لزم الأمر.

بعد 1 يونيو 2020، لن يتوفر الإذنين manage_pages وpublish_pages عند تحديد مراجعة التطبيقات > الأذونات والميزات في لوحة معلومات التطبيق.

سيتم إيقاف استخدام الإذنين manage_pages وpublish_pages بشكل كامل في مايو 2022. يجب تطبيق التغييرات المطلوبة على الرمز قبل هذا التاريخ.

مجموعات SDK

يُرجى زيارة سجل تغييرات مجموعة iOS SDK وسجل تغييرات مجموعة Android SDK للتعرف على أهم التغييرات القادمة على مجموعات SDK هذه.

المستخدم

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

تنطبق هذه التغييرات على الإصدار 7.0 والإصدارات الأحدث وستنطبق على كل الإصدارات اعتبارًا من 3 أغسطس 2020.

سيتم إيقاف استخدام نقاط النهاية التالية:

• GET /{user-id}/books
• GET /{user-id}/games
• GET /{user-id}/movies
• GET /{user-id}/television

API التسويق

تم الطرح في 5 مايو 2020 | متوفر حتى 3 مارس 2021 | منشور المدونة

الحملات الإعلانية

تحسين ميزانية الحملة الإعلانية

ينطبق هذا التغيير على الإصدار 7.0 والإصدارات الأحدث.

فيما يتعلق بحملة إعلانية محددة، لم يعد بإمكانك تعيين كل من lifetime_budget وspend_cap في الوقت ذاته. ولا يمكنك سوى تحديد lifetime_budget.

يتم توزيع ميزانية الحملة الإعلانية كلها على مدار تشغيل حملتك الإعلانية. عند استخدام lifetime_budget على مستوى الحملة الإعلانية، يتم تضمين معلومات الحد الأقصى للإنفاق بالفعل. ولذلك، لا يوحد سبب لإضافة حد أقصى آخر للإنفاق.

يمكنك متابعة استخدام spend_cap للحملات الإعلانية التي لا تستخدم تحسين ميزانية الحملة الإعلانية.

الفئة الإعلانية الخاصة

ينطبق هذا التغيير على الإصدار 7.0 والإصدارات الأحدث.

تم إيقاف استخدام المعلمة special_ad_category في نقطة النهاية POST /act_<AD_ACCOUNT_ID>/campaigns واستبدالها بمعلمة special_ad_categories جديدة.

المعلمة special_ad_categories الجديدة مطلوبة وتقبل مصفوفة. إذا حصلت على المعلمة special_ad_category، فستظل ترجع سلسلة، ولكن يجب استخدام GET /{campaign-id}?fields=special_ad_categories للحصول على مصفوفة مرة أخرى.

لمزيد من التفاصيل، راجع الفئة الإعلانية الخاصة.

تعرف على المزيد حول الفئات الإعلانية الخاصة، مركز مساعدة الإعلانات.

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

ينطبق هذا التغيير على الإصدار 7.0 والإصدارات الأحدث.

تم إيقاف استخدام المعلمة budget_rebalance_flag. نوصي باستخدام تحسين ميزانية الحملة الإعلانية بدلاً من ذلك.

حملات Atlas الإعلانية

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

ينطبق هذا التغيير على الإصدار 7.0 والإصدارات الأحدث.

• GET /{atlas-ad-campaign-id}/cumulative_edited_date

كتالوج المنتجات

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

ينطبق هذا التغيير على الإصدار 7.0 والإصدارات الأحدث.

تم إيقاف استخدام المعلمة cpas_parent_catalog_settings في عنصر الربط POST /PRODUCT_CATALOG_ID للتطبيقات التابعة لجهات خارجية.