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

نطرح اليوم الإصدار 10.0 لواجهة Graph API من Facebook والإصدار 10.0 لواجهة API التسويق.

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

تتوفر المعلومات التفصيلية المتعلقة بكل التغييرات أدناه. وبالنسبة للمواصفات الفنية، يرجى زيارة سجل تغييرات الإصدار 10.0.

لمعرفة المزيد عن منصة المطوّر لدينا، تفضل بزيارة مركز مبادرات المنصة.

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

شهادة فحص استخدام البيانات

لتجنب فقدان الوصول إلى واجهة API منصة Facebook، يرجى إكمال فحص استخدام البيانات (DUC) في غضون 60 يومًا من التسجيل. ويمكنك إكمال فحص استخدام البيانات (DUC) من خلال الانتقال إلى الصفحة "تطبيقاتي" في لوحة معلومات التطبيق لديك.

في الخريف الماضي، طرحت Facebook فحص استخدام البيانات (DUC) وهو متطلب جديد يتم إجراؤه سنويًا للمطوّرين من أجل ضمان امتثال الوصول إلى واجهة API واستخدام البيانات لشروط منصة Facebook وسياسات المطوّرين.

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

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

قيود البيانات ومستويات الوصول إلى البيانات لمدة 90 يومًا لواجهة API المجموعات:

اعتبارًا من 24 مايو 2021 وعند استخدام واجهة API المجموعات، سيقتصر ظهور نافذة الوصول إلى البيانات المتاحة في التطبيقات على مدة 90 يومًا.

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

اليوم، يمكن للتطبيقات في وضع التطوير الوصول إلى كل محتويات المجموعات العامة والمجموعات الخاصة حيث يتمتع المطوِّر بدور المسؤول. وبعد الانتهاء من عملية مراجعة التطبيقات، يمكن لهذه التطبيقات الوصول إلى كل المحتويات من المجموعات التي قامت بتثبيت التطبيق.

اعتبارًا من 24 مايو 2021، يمكن للتطبيقات في وضع التطوير الوصول فقط إلى محتواها الخاص في المجموعات العامة والمجموعات الخاصة حيث يتمتع المطوِّر بدور المسؤول. ويعني ذلك أن التطبيق لن يتمكّن من الوصول إلى المحتوى الذي نشره مستخدمو المجموعات الآخرون (الذين لا يتمتعون بأدوار في التطبيق)، مثل المنشورات والتعليقات.

تعرف على المزيد في سجل تغييرات الإصدار 10.0.

مستويات الوصول لأذونات public_profile والبريد الإلكتروني في تطبيقات الأنشطة التجارية

كجزء من مبادراتنا المستمرة لتأمين بيانات المستخدم وحمايتها، لقد أضفنا أذونات public_profile (أي حقول الملف الشخصي العام الافتراضي) والبريد الإلكتروني إلى نموذج مستويات الوصول الذي أعلنا عنه باستخدام الإصدار 8.0 من Graph في تطبيقات نوع النشاط التجاري الحالية والجديدة.

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

تعرف على المزيد في سجل تغييرات الإصدار 10.0.

تذكيرات طلبات حذف البيانات

وفقًا لما تم الإعلان عنه في 10 نوفمبر 2020، سيتم طلب أنواع تطبيقات الألعاب والمستهلكين التي يتم إرسالها لإجراء عملية مراجعة التطبيقات أو التي يتم انتقالها من وضع التطوير إلى وضع البث المباشر لتوفير استدعاء طلب حذف البيانات أو عنوان URL مع تعليمات واضحة للمستخدمين حول كيفية طلب حذف بياناتهم. ونحن نخطط لتنفيذ هذا المتطلب بحلول 10 نوفمبر 2022 وسنقوم بتذكير مطوّري التطبيقات قبل 60 يومًا من هذ التنفيذ.

خيارات تغيير واجهة Graph AdsInsight API لمشروع تقليل الاحتفاظ

لن تقوم واجهة مستخدم مدير الإعلانات بعد الآن بدعم الإبلاغ عن بيانات أدوات قياس رؤى الإعلانات الأقدم من 37 شهرًا. وستقوم واجهة API بإرجاع خطأ عندما يحتوي الطلب على نطاقات التواريخ التي تتجاوز مدة احتفاظ تبلغ 37 شهرًا. ونقوم بتعطيل 'date_preset = lifetime'، واستبداله بـ 'date_preset = maximum.'

ستنطبق تغييرات الإصدار 10.0 لواجهة Graph API التي تطرأ على AdsInsight، باستتثناء 'date_preset = lifetime,' على كل الإصدارات الأخرى لواجهة Graph API بعد مرور 90 يومًا. ولا يحتاج الحقل الخاص الذي تم استدعاؤه إلى إجراء أي تغيير. وستوفر أداء وظيفيًا تم تعيينه مسبقًا، وسيتم تعيين كل الاستدعاءات "الدائمة" افتراضيًا إلى فترة احتفاظ مدتها 37 شهرًا كحد أقصى.

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

• يوم الإصدار 2/23/2021:
  • الإصدار 10.0
    • تمكين 'date_preset = maximum'
    • تعطيل 'date_preset = lifetime'
    • إرجاع الخطأ عندما يحتوي الطلب على نطاقات تواريخ واضحة تتجاوز مدة احتفاظ تبلغ 37 شهرًا
  • الإصدارات 9.0 والإصدارات السابقة
    • بلا تغيير على الوظيفة الحالية
• إصدار المنشور لمدة 90 يومًا - 05/24/2021:
  • الإصدارات 9.0 والإصدارات السابقة
    • تمكين 'date_preset = maximum' (مثل الإصدار الجديد)
    • إرجاع الخطأ عندما يحتوي الطلب على نطاقات تواريخ واضحة تتجاوز مدة احتفاظ تبلغ 37 شهرًا (مثل الإصدار الجديد)
    • لا يزال بإمكان date_preset = lifetime' العمل، ولكنه يقوم فقط بإرجاع البيانات الخاصة بمدة 37 شهرًا، مما يعني أنه يعمل مثل الحد الأقصى

تعرف على المزيد في سجل تغييرات الإصدار 10.0.

سياسة الحذف الجديدة للبيانات المملوكة خارجيًا في منصة ThreatExchange

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

في السابق، كان الحذف "المبدئي" يعني أننا نسمي المحتوى الذي انتهت صلاحيته باسم "منتهي الصلاحية". ولم نعد ندعم عمليات الحذف المبدئية وبعد انتهاء صلاحية المحتوى، سيتم حذفه نهائيًا ولن يظهر بعد الآن في منصة ThreatExchange.

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

انقر هنا لمعرفة المزيد حول التغييرات

استهداف التغييرات في واجهة API الجديدة

اعتبارًا من 24 مايو 2021، لن نطلب بعد الآن المعلمتين location_spec والبلد عند إنشاء جمهور مخصص مشابه عبر كل إصدارات واجهة API.

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

طرح صفحة جديدة لحالة البث المباشر على المنصة

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

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

إيقاف استخدام مربع حوار البث المباشر

اعتبارًا من 24 مايو 2021، سنقوم بإيقاف استخدام مجموعة SDK لمربع حوار البث المباشر (GLD). وسيتم إيقاف استخدام أداة إنتاج البث المباشر القديمة هذا عبر كل إصدارات واجهة API. وسيؤثر هذا التغيير فقط على البث المباشر على Facebook. ونشجع المطوّرين على استخدام Live Producer وواجهةLive API في كل حلول إنتاج البث المباشر المطلوبة.

تتوفر حلول البث المباشر بمجرد إيقاف استخدام مجموعة SDK لمربع حوار البث المباشر (GLD):

• الوصول إلى Live Producer مباشرة عبر facebook.com/live/producer (أو نقاط الإدخال الأخرى على Facebook، مثل زر "فيديو البث المباشر" على الصفحة أو الملف الشخصي)
• دمج أي حلول مخصصة مع واجهة Live API

تعرف على المزيد في سجل تغييرات الإصدار 10.0.

إيقاف استخدام استهداف الاتصالات

اعتبارًا من 24 مايو 2021، لن يتم دعم استهداف الاتصالات بعد الآن عند إنشاء/تعديل أية مجموعة إعلانية. وسيؤثر هذا المطلب فقط على الحملات الإعلانية الجديدة والمُعدلة، ولكنه لن يؤثر على الحملات الإعلانية الحالية.

تعرف على المزيد في سجل تغييرات الإصدار 10.0.

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

إلغاء إيقاف استخدام نقطة النهاية gr:delete:Page/tabs

عند طرح الإصدار 8.0 لواجهة Graph API، قمنا بإيقاف استخدام نقطة النهاية gr:delete:Page/tabs لعلامات تبويب الصفحات. ولقد اتخذنا قرارًا بإلغاء إيقاف استخدام نقطة النهاية هذه في الإصدار 10.0 لواجهة Graph API على الفور، وسنستعيد الوصول في 24 مايو 2021 في كل إصدارات Graph الأخرى.

تعرف على المزيد في سجل تغييرات الإصدار 10.0.

إلغاء إيقاف استخدام نقاط النهاية gr:post:Business/business_users وgr:post:Business/system_users وgr:post:User/access_tokens

عند طرح الإصدار 9.0 لواجهة Graph API، قمنا بتقييد الوصول إلى ثلاث نقاط نهاية للأنشطة التجارية:

• gr:post:Business/business_users
• gr:post:Business/system_users
• gr:post:User/access_tokens

اعتبارًا من تاريخ طرح Graph بالإصدار 10.0، سنعيد فتح نقاط النهاية هذه إلى عمليات استدعاء واجهة API عندما تلبي التطبيقات أحد هذين الشرطين:

• النشاط التجاري المستهدف هو النشاط التجاري المالك لتطبيق الاستدعاء
• النشاط التجاري المستهدف هو نشاط تجاري تابع (نموذج أعمال مكوّن من طبقتين) للنشاط التجاري المالك لتطبيق الاستدعاء

تعرف على المزيد في سجل تغييرات الإصدار 10.0.

تقويم عنصر الإجراء

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

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

• 3 مارس 2021: سيتم إيقاف استخدام الإصدار 7.0 لواجهة API التسويق وإزالته من المنصة
• 4 مايو 2021: سيتم إيقاف استخدام الإصدار 8.0 لواجهة API التسويق وإزالته من المنصة
• 25 أغسطس 2021: سيتم إيقاف استخدام الإصدار 9.0 لواجهة API التسويق وإزالته من المنصة

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

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

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

• 4 مايو 2021: سيتم إيقاف استخدام الإصدار 3.2 لواجهة Graph API وإزالته من المنصة
• 3 أغسطس 2021: سيتم إيقاف استخدام الإصدار 3.3 لواجهة Graph API وإزالته من المنصة

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

• 24 مايو 2021:
  • سيتم إيقاف استخدام مربع حوار البث المباشر وإزالته من المنصة
  • سيتم إيقاف استخدام استهداف الاتصالات وإزالته من المنصة

إجراء المطوّر المطلوب

• طرح التسجيل: شهادة فحص استخدام البيانات
  • بمجرد التسجيل، يلزم إكمال الفحص في غضون 60 يومًا
  • قسم الأسئلة المتكررة المخصص لفحص استخدام البيانات (DUC).
• 23 فبراير 2021: طرح تغييرات واجهة Graph AdsInsight API فقط للإصدار 10.0 من Graph
• 24 مايو 2021:
  • طرح تغييرات واجهة Graph AdsInsight API للإصدار 9.0 من Graph والإصدارات السابقة
  • يتم تفعيل التغييرات على مستويات الوصول القائمة على عملية مراجعة التطبيقات
    • يقتصر الوصول إلى بيانات واجهة API المجموعات على مدة 90 يومًا
    • تم تنفيذ مستويات البيانات المتدرجة لواجهة API المجموعات
    • يتم تفعيل التغيير على أذونات public_profile والبريد الإلكتروني في تطبيقات الأنشطة التجارية
  • يتم تنفيذ سياسة بيانات "الحذف النهائي" الجديدة في منصة ThreatExchange
• 10 نوفمبر 2022: الموعد النهائي لطلبات حذف البيانات