الإصدار 10.0

واجهة Graph API

تم الطرح في 23 فبراير 2021 | متوفر حتى 8 يونيو 2023 | منشور المدونة

تطبيقات الأعمال

مستويات الوصول

تنطبق على كل التطبيقات التي تم إنشاؤها بعد 16 فبراير 2021.

سيتم منح كل التطبيقات من النوع النشاط التجاري والتي تم إنشاؤها بعد تاريخ 16 فبراير 2021 الوصول القياسي تلقائيًا إلى الإذنين email وpublic_profile.

ينطبق ذلك على كل التطبيقات الحالية التي تم إنشاؤها بعد 16 فبراير 2021.

سيتم منح كل التطبيقات من النوع "النشاط التجاري" والتي تم إنشاؤها قبل 16 فبراير 2021 الوصول المتقدم تلقائيًا إلى الإذنين email وpublic_profile. وسيتم إرجاع التطبيقات التي لا تستخدم الإذن email أو public_profile إلى استخدام الوصول القياسي بالنسبة لهذين الإذنين.

يمكن للتطبيقات من النوع "النشاط التجاري" الترقية إلى الوصول القياسي للحصول على الإذنين email وpublic_profile دون الخضوع إلى عملية مراجعة التطبيقات.

المجموعات

تنطبق على الإصدار 10.0 والإصدارات الأحدث. وستنطبق على كل الإصدارات اعتبارًا من 25 مايو 2021.

• للتوافق مع سياسات الاحتفاظ ببيانات Facebook الأخرى، ستشمل واجهة API المجموعات فقط البيانات التي تم إنشاؤها خلال آخر 90 يومًا من تاريخ إجراء استعلاماتك. وتعتمد البيانات التي يتم إرجاعها على مستوى الوصول أو وضع تطبيقك ودورك في التطبيق.
• تستخدم واجهة API المجموعات الآن اثنين من أنظمة مستويات الوصول المتدرج لواجهة API وهما المستوى القياسي والمستوى المميز، بدلًا من الوصول إلى وضع التطوير ووضع البث المباشر. علمًا بأن الوصول بالمستوى القياسي سيتيح لك فقط الحصول على بيانات للمستخدمين الذين يتمتعون بدور في تطبيقك، بينما سيتيح لك الوصول بالمستوى المميز الحصول على بيانات من جميع المستخدمين في المجموعة التي تم تثبيت التطبيق فيها.

الصفحات

نقطة النهاية التي تمت استعادتها

تنطبق على الإصدار 10.0 والإصدارات الأحدث. وستنطبق على كل الإصدارات اعتبارًا من 25 مايو 2021.

تمت استعادة نقطة النهاية DELETE /{page-id}/tabs، التي تم إيقاف استخدامها بالإصدار 8.0، في الإصدار 10.0 وستتم استعادتها في كل الإصدارات اعتبارًا من 25 مايو 2021.

Threat Exchange

حذف البيانات منتهية الصلاحية

سينطبق ذلك على كل الإصدارات اعتبارًا من 25 مايو 2021.

البيانات التي تم تحميلها إلى منصة ThreatExchange بقيم expire_time غير صفرية سيتم حذفها نهائيًا في وقت انتهاء الصلاحية المحدد. وإذا كنت تريد حذف البيانات التي لم تعد صالحة، فيمكنك تعيين الحقل expired_on إلى الوقت الحالي لحذف البيانات على الفور.

بالإضافة إلى ذلك، سيتم حذف كل واصفات ThreatDescriptors غير التابعة لـ Facebook نهائيًا بمجرد وصولها إلى تاريخ انتهاء الصلاحية الذي حدده المنشئ. وإذا كان تطبيقك يحتوي حاليًا على واصفات ThreatDescriptors منتهية الصلاحية ولا تريد حذفها، فيجب عليك تمديد تاريخ انتهاء الصلاحية أو تعيينه إلى ‘0’ لضمان عدم انتهاء صلاحية البيانات أبدًا.

عنوان URL

تنطبق على الإصدار 10.0 والإصدارات الأحدث. وستنطبق على كل الإصدارات اعتبارًا من 25 مايو 2021.

التفاعل

• نظرًا لاعتبارات تتعلق بالخصوصية، قد لا تتطابق الأعداد التي تم إرجاعها بواسطة طلب GET /?id={url}/engagement مع الأعداد البسيطة.
• كما ستقتصر الطلبات الخاصة بالحقل GET /?id={url}/engagement لعنوان URL ذاته على 10 طلبات في الساعة.

API التسويق

تم الطرح في 23 فبراير 2021 | متوفر حتى 4 أكتوبر 2021 | منشور المدونة

الحساب الإعلاني

تغييرات الحقول

تنطبق على الإصدار 10.0 والإصدارات الأحدث. وستنطبق على كل الإصدارات اعتبارًا من 25 مايو 2021.

يتطلب الحقل agency_client_declaration في العقدة AdAccount الآن امتيازات المسؤول لتنفيذ كل العمليات.

واجهة API رؤى الإعلانات

المعلمة المُحدثة date_preset

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

• تم تعطيل المعلمة lifetime (date_preset=lifetime) واستبدالها بـ date_preset=maximum والتي يمكن استخدامها لاسترداد 37 شهرًا كحد أقصى من البيانات. وستعرض واجهة API خطأ عندما تحتوي الطلبات على نطاقات تواريخ تتجاوز مدتها 37 شهرًا.
• بالنسبة للإصدار 9.0 والإصدارات الأقدم، لن يطرأ أي تغيير في الوظائف حتى 25 مايو 2021. وفي هذا الوقت، سيتم تمكين date_preset=maximum وسيتم تعيين أي استدعاءات lifetime افتراضيًا إلى maximum، وسيتم إرجاع 37 شهرًا فقط من البيانات.

النشاط التجاري

تخفيف القيود المفروضة على الوصول إلى نقطة النهاية السابقة

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

في الإصدار 9.0، تم تقييد الوصول إلى نقاط النهاية أدناه. وتمت استعادة الوصول إلى كل التطبيقات، ولكن يمكن للتطبيقات الآن أن تستهدف فقط الأنشطة التجارية (أو الأنشطة التجارية التابعة لهذه الأنشطة التجارية) التي طالبت بها:

• POST /<APP_SCOPED_SYSTEM_USER_ID>/access_tokens
• POST /{business-id}/business_users
• POST /{business-id}/system_users

الاستهداف

الاستهداف حسب جهات التواصل

سينطبق ذلك على كل الإصدارات اعتبارًا من 24 مايو 2021.

لن تقبل نقاط النهاية التالية بعد الآن الاستهداف حسب جهات التواصل عند إنشاء الحملات الإعلانية أو تعديلها:

• POST /<ad_account_id>/adsets
• POST /<adset_id>

لن يؤثر هذا التغيير على أي حملات إعلانية قيد التشغيل حاليًا.

الجماهير المشابهة

ستتم إزالة المعلمتين location_spec وcountry من عملية إنشاء الجمهور المشابه. وسيتم تحديد موقع الجماهير المشابهة حسب موقع البلد الموجود ضمن مواصفات استهداف الحملة الإعلانية.

لن يكون هناك أي تأثير على الحملات الإعلانية الحالية عند إجراء هذا التغيير. وسيؤثر هذا المتطلب فقط على الحملات الإعلانية الجديدة والمُعدلة.

ستتأثر نقاط النهاية والحقول التالية:

• POST /<ad_account_id>/customaudiences
• POST /<ad_account_id>/adsets
• POST /<ad_account_id>/adaccounts?adaccounts=<SHARED_TO_AD_ACCOUNT_ID>
• GET /<ad_account_id>/reachestimate
• GET /<ad_account_id>/delivery_estimate
• GET /<ad_account_id>?fields=approximate_count
• GET /<ad_account_id>?fields=delivery_status
• GET /<ad_account_id>?fields=operation_status

راجع الجماهير المشابهة: تغييرات الجماهير المشابهة القادمة لمزيد من المعلومات حول هذه التحديثات.