Introducing Facebook Graph API v12.0 and Marketing API v12.0

١٤ سبتمبر ٢٠٢١بواسطة‏‎Mengjiao Zhu‎‏

نطرح اليوم واجهة Graph API من Facebook بالإصدار 12.0 وواجهة API التسويق بالإصدار 12.0. وقد تم تسليط الضوء أدناه على التغييرات التي ستؤثر على أجزاء من مجتمع المطوّرين لدينا. وتتضمن هذه التغييرات إعلامات وتحديثات المنتج وتذكيرات من عمليات الطرح السابقة وإشعارات حول عمليات إيقاف الاستخدام واسعة النطاق التي قد تؤثر على دمج التطبيق (التطبيقات) لديك مع منصتنا.

للحصول على قائمة كاملة بكل التغييرات وتفاصيلها، يُرجى زيارة سجل التغييرات.

التحديثات والإعلامات العامة

واجهة API التحويلات: توسيع نطاق الحد الأدنى للإصدار القابل للاستدعاء

التوافق مع الإصدارات السابقة من واجهة Graph API للتطبيقات التي تم إنشاؤها باستخدام رموز الوصول بنقرة واحدة بدءًا من الإصدار 12.0، أصبحت رموز الوصول التي تم إنشاؤها حديثًا والتي تم إنشاؤها ضمن علامة تبويب إعدادات واجهة API التحويلات في مدير الأحداث مدعومة بواسطة جميع إصدارات واجهة Graph API المتوفرة (راجع الإصدارات المدعومة هنا).

يُرجى ملاحظة أنه سيتم حل عمليات الاستدعاء التي تم إجراؤها باستخدام هذه الرموز على إصدار واجهة Graph API التي تم إيقاف استخدامه تلقائيًا وصولاً إلى أقدم إصدار متوفر. ولا ينطبق هذا السلوك إلا على نقاط نهاية واجهة Graph API. كما أن نقاط نهاية واجهة API التسويق، بما في ذلك واجهة API التحويلات، لا تدعم سلوك الترقية التلقائية وستطرح استثناءً.

واجهة API الملف الشخصي للمستخدم للمراسلة على Instagram: الحقول الجديدة

نعمل على إجراء تحسينات على واجهة API الملف الشخصي للمستخدم للمراسلة على Instagram. في السابق، دعمت واجهة API الملف الشخصي للمستخدم على Instagram حقلين: 1) الاسم و2) عنوان URL لصورة الملف الشخصي. وللسماح للأنشطة التجارية بإضفاء طابع شخصي على الرسائل وتحديد أولوياتها بشكل أفضل استنادًا إلى معلومات المستخدم المتوفرة للعامة، تم تحديث واجهة API لتشمل أيضًا المعلومات التالية:

1. عدد المتابعين
2. الشارة المُحقّقة
3. يتابع النشاط التجاري حساب المستخدم [نعم/لا]
4. يتابع حساب المستخدم حساب الأعمال [نعم/لا]

يُرجى الرجوع إلى وثائق المطوّرين لمزيد من التفاصيل.

الاستهداف التفصيلي لفرص جديدة

لمساعدة المعلنين في العثور على فرص إضافية لم تكن متاحة لهم في الأصل، عندما يستفيد المعلنون من الاستهداف التفصيلي ويحاولون تحسين التحويلات أو القيمة أو أحداث التطبيق باستخدام هدف التحويلات، سيتم تضمينهم تلقائيًا في توسيع الاستهداف. لمزيد من المعلومات، يُرجى الرجوع إلى مقالة مركز المساعدة لتوسيع الاستهداف التفصيلي.

واجهة API الفيديو: الحقول الجديدة

لقد أضفنا حقلين جديدين هما، طرق العرض وpost_views، إلى عقدة [الفيديو]. يُرجى الاطّلاع على وثائق مطوّري واجهة API الفيديو لمعرفة المزيد.

عمليات إيقاف الاستخدام والتغييرات العاجلة

شفافية الخطأ

يتمثل السلوك الافتراضي لواجهة Graph API وواجهة API التسويق في إرجاع خطأ عندما يطلب أحد التطبيقات حقلاً أو عنصر ربط في عقدة تُرجع عقدة أو عقدًا مرتبطة، ولكنها تفتقر إلى الأذونات المناسبة التي تتطلبها العقد المرتبطة. ومع ذلك، يوجد عدد من هذه الحقول وعناصر الربط لا تتبع هذا البروتوكول وبدلاً من ذلك يتم حذفها من استجابات واجهة API إذا كان التطبيق الذي يُجري عملية الاستدعاء يفتقر إلى الأذونات المناسبة.

بدءًا من الإصدار 12.0، ستتوافق هذه الحقول وعناصر الربط مع السلوك الافتراضي. علمًا بأن هذا التغيير سينطبق على جميع الإصدارات اعتبارًا من 13 ديسمبر 2021.

أدوار التطبيق ومستخدمي النظام

نحن بصدد إيقاف قدرة مستخدمي النظام على الحصول على أدوار في التطبيقات ما لم يكن كل من المستخدمين والتطبيقات ينتمون إلى الأنشطة التجارية نفسها. ولمنع أي تعطل لتطبيقك ونشاطك التجاري، نوصيك بإزالة مستخدمي النظام هؤلاء من تطبيقك واستخدام النشاط التجاري نيابةً عن واجهة API بدلاً من ذلك. وسيصبح هذا التغيير العاجل ساريًا اعتبارًا من 13 ديسمبر 2021.

البث المباشر المجدول

نحن بصدد إيقاف استخدام المعلمة planned_start_time ضمن إمكانية الجدولة في واجهة Live API وسيصبح هذا التغيير العاجل ساريًا اعتبارًا من 13 ديسمبر 2021. وسيتم الإعلان عن معلمة جديدة في تاريخ لاحق.

منصة Messenger: واجهة API المحادثة

نحن بصدد إيقاف استخدام الحقل user_id من بيانات تعريف سلسلة الرسائل في واجهة API المحادثة. وسيحتاج كل المطوّرين إلى ترحيل أي مراجع إلى حقل user_id في (IGID) والاعتماد بشكل كامل على IGSID باعتباره معرفًا رئيسيًا لسلسلة الرسائل بين المستخدم والنشاط التجاري.

سيصبح هذا التغيير العاجل ساريًا في إصدارات واجهة Graph API السابقة اعتبارًا من 13 ديسمبر 2021. يُرجى الاطّلاع على وثائق مطوّري واجهة API المحادثة لمعرفة المزيد.

منصة Messenger: أحداث Webhooks في Instagram

نُجري تحديثًا لواجهة Messenger API لحدث webhook للتفاعل على IG لدعم التفاعلات بالرموز التعبيرية بشكل أفضل. ويعرض الإصدار الحالي حقل الرموز التعبيرية باعتباره سلسلة، وباستخدام هذا التحديث، سترجع أحداث webhooks الخاصة بالتفاعلات تنسيق unicode جديد. لاحظ أن حقل "التفاعل" سيدعم الرموز التعبيرية الافتراضية فقط. وبالنسبة لكل الرموز التعبيرية الأخرى، سيُرجع حقل التفاعل "أخرى"، تمامًا مثل MSGR.

سيصبح هذا التغيير العاجل ساريًا في إصدارات واجهة Graph API السابقة اعتبارًا من 13 ديسمبر 2021. لمتابعة دعم التفاعلات بالرموز التعبيرية، يحتاج كل المطوّرين إلى الترحيل إلى ترميز unicode الجديد الذي سنقدمه بحلول 13 ديسمبر 2021. يُرجى الرجوع إلى وثائق مطوّري Webhook لمزيد من التفاصيل.

حالات إيقاف استخدام إصدار واجهة API:

كجزء من جدول تعيين الإصدارات على Facebook لواجهة Graph API وواجهة API التسويق، يُرجى ملاحظة حالات إيقاف الاستخدام القادمة:

واجهة Graph API

2 نوفمبر 2021: سيتم إيقاف استخدام واجهة Graph API بالإصدار 4.0 وإزالتها من المنصة
3 فبراير 2022: سيتم إيقاف استخدام واجهة Graph API بالإصدار 5.0 وإزالتها من المنصة
22 مايو 2022: سيتم إيقاف استخدام واجهة Graph API بالإصدار 6.0 وإزالتها من المنصة

لتجنب تعطُل أعمالك، نوصيك بترحيل كل الاستدعاءات إلى أحدث إصدار من واجهة API الذي تم طرحه اليوم.

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

سيتم إيقاف استخدام واجهة API التسويق بالإصدار 10.0 اعتبارًا من 10/04/2021
سيتم إيقاف استخدام واجهة API التسويق بالإصدار 11.0 اعتبارًا من 02/23/2022

لتجنب تعطُل أعمالك، نوصيك بترحيل كل الاستدعاءات إلى أحدث إصدار من واجهة API التسويق الذي تم طرحه اليوم. (تفضل بزيارة سجل التغييرات لمزيد من التفاصيل).

مجموعة SDK لمنصة Facebook

في 19 يناير 2021، أعلنا عن جدول إيقاف الاستخدام لمدة عامين لمجموعة SDK لمنصة Facebook بالإصدار 8.x والإصدارات السابقة. سيتوقف العمل بهذه الإصدارات اعتبارًا من يناير 2023.
في 8 يونيو 2021، تم طرح مجموعة SDK لمنصة Facebook بالإصدار 11.0، الأمر الذي بدأ إيقاف الاستخدام لمدة عامين لمجموعة SDK لمنصة Facebook بالإصدار 9.0. وسيتوقف العمل بمجموعة SDK بالإصدار 9.0 اعتبارًا من يونيو 2023.