‏‎Graph API‎‏

الإصدار 3.1

تم الإصدار في 26 يوليو 2018 | متوفر حتى 27 أكتوبر 2020 | منشور المدونة

عام

تنطبق هذه التغييرات على الإصدار 3.1 والإصدارات الأعلى، وستنطبق على جميع الإصدارات في 24 أكتوبر 2018.

تقوم الآن كل نقاط النهاية في واجهة Graph API بإرجاع كل الهياكل الفارغة مثل {}، وكل القوائم الفارغة مثل [].

واجهة Live API

تنطبق هذه التغييرات على الإصدار 3.1 والإصدارات الأعلى، وستنطبق على جميع الإصدارات في 24 أكتوبر 2018.

تم التوقف عن استخدام المعلمة type لعناصر الربط التالية. وتم استبدالها بمعلمة source جديدة.

  • /event/live_videos
  • /group/live_videos
  • /official_events/live_videos
  • /page/live_videos
  • /user/live_videos

لا يمكن للمعلمة source الجديدة قبول إحدى القيمتين التاليتين وهما target وowner. الاستعلام عن عنصر ربط /live_videos للعقدة وقيام source=target بإرجاع مقاطع فيديو بث مباشر يتم بثها إلى هذه العقدة، أثناء الاستعلام عن source=owner الذي يقوم بإرجاع مقاطع فيديو بث مباشر يتم بثها من خلال هذه العقدة.

لا تدعم عُقد الحدث والمجموعة إلا استعلامات target، وقد تفشل بعض استعلامات target إذا لم تتمتع بإذن لعرض العقدة المستهدفة.

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

تم الإصدار في 26 يوليو 2018 | متوفر حتى 14 مايو 2019 | منشور المدونة

إدارة الإعلانات

  • فئات الاستهداف المستند إلى السلوك - لقد أوقفنا استخدام بعض خيارات الاستهداف المستند إلى السلوك والمُستخدمة في behaviors. إذا كنت تحاول إنشاء الإعلانات باستخدام إحدى هذه الفئات، فستحصل على الخطأ The category you selected is no longer available.، وللتحقق من الفئات الصالحة المتوفرة للاستهداف، استخدم الاستهداف بمعايير البحث.

  • تم إيقاف استخدامPAGE_ENGAGEMENTباعتبارهoptimization_goal - قمنا بإيقاف استخدام PAGE_ENGAGEMENT باعتباره optimization_goal للحملات الإعلانية. اعتبارًا من الإصدار 3.1، لن يكون بإمكانك بعد ذلك إنشاء الحملات الإعلانية أو تحديثها أو تكرارها باستخدام optimization_goal المعيَّن إلى PAGE_ENGAGEMENT. إذا كانت لديك حملات إعلانية تم إنشاؤها قبل الإصدار 3.1، فلا يزال بإمكانك تشغيل هذه الحملات باستخدام الإعداد الحالي. كذلك لا يزال بإمكانك استخدام PAGE_ENGAGEMENT باعتباره تقسيمًا لواجهة API الرؤى للبيانات في الحملات الإعلانية الحالية باستخدام optimization_goal.

  • تم إيقاف استخدام إعلانات تسجيل الإعجاب بالصفحة التي تتضمن صورة واحدة بدون منشور - اعتبارًا من الإصدار 3.1، لن تتمكّن بعد الآن من إنشاء إعلانات تسجيل الإعجاب بالصفحة التي تتضمن صورة واحدة بدون منشور الصفحة. وبدلاً من ذلك، يجب إنشاء إعلان تسجيل الإعجاب بالصفحة باستخدام منشور، لذا يرجى الرجوع إلى التصميم والموضع والمعاينة، إنشاء إعلانات تسجيل الإعجاب بالصفحة.

  • عدم استرجاع إعلانات تجميع بيانات العملاء المحتملين عبر Webhooks لمستوى المطوّرين - سنتوقف عن إرسال البيانات التي تم تجميعها في نماذج إعلانات تجميع بيانات العملاء المحتملين عبر webhooks إلى التطبيقات في وضع التطوير. سنبدأ فرض هذا التغيير في 1 فبراير 2019.

    • إذا اشتركت في تحديثات الإصدار 3.1، فلن نرسل أي تحديثات ما لم يكن تطبيقك في مرحلة الإنتاج وفي وضع النشر.

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

    • وإذا كان لديك تطبيق بالفعل، فسيتعين أن يكون في وضع النشر قبل 1فبراير 2019. وحتى ذلك التاريخ، ستستمر في تلقي التحديثات في وضع التطوير.

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

رؤى الإعلانات والقياس

  • أعدنا تسمية كل من cost_per_store_visit وstore_visits الخاصة بواجهة API الرؤى لتصبح cost_per_store_visit_actions وstore_visit_actions. وهذا يؤثر فيما يلي:

    • GET {adaccount-id}/insights,

    • GET {campaign-id}/insights,

    • GET {adset-id}/insights,

    • GET {ad-id}/insights,

    • POST {adaccount-id}/insights,

    • POST {campaign-id}/insights,

    • POST {adset-id}/insights و

    • POST {ad-id}/insights.

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

واجهة API مدير الأعمال

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

الدور المهام الوصف

ADMIN

['MANAGE', 'ADVERTISE', 'ANALYZE']

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

GENERAL_USER

['ADVERTISE', 'ANALYZE']

إنشاء الإعلانات باستخدام مصدر التمويل المقترن بحساب الإعلان. تشغيل التقارير.

GENERAL_USER

['ANALYZE']

تشغيل التقارير.

يحل هذا محل الأدوار التالية في واجهة API مدير الأعمال المتوفر بها المهام التالية:

الدور المهام

MANAGER

['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

CONTENT_CREATOR

['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

MODERATOR

['MODERATE', 'ADVERTISE', 'ANALYZE']

ADVERTISER

['ADVERTISE', 'ANALYZE']

INSIGHTS_ANALYST

['ANALYZE']

بالنسبة لإدارة بيكسل فيسبوك، يؤثر هذا في الأدوار الحالية ويقدم مهام جديدة.

الدور المهام

PIXEL_EDITOR

['EDIT', 'ANALYZE']

PIXEL_ANALYST

['ANALYZE']

باعتبار ما يلي جزءًا من التغيير، سنوقف استخدام الحقول التالية في واجهة API إدارة الأعمال ويحل محلها الحقول التالية:

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

GET {adaccount-id}/users

permissions, role

tasks

POST {adaccount-id}/users

role, uidRoles, emailRoles

tasks

GET {user-id}/adaccounts

permissions, role

tasks

GET {user-id}/assigned_ad_accounts

role, permitted_role

tasks, permitted_tasks

GET {user-id}/assigned_pages

role, permitted_role

tasks, permitted_tasks

GET {adaccount-id}/assigned_users

role, permitted_role

tasks, permitted_tasks

POST {adaccount-id}/assigned_users

role

tasks

GET {page-id}/assigned_users

role, permitted_role

tasks, permitted_tasks

POST {page-id}/assigned_users

role

tasks

GET {fb-pixel-id}/assigned_users

role, permitted_role

tasks, permitted_tasks

GET {adaccount-id}/userpermissions

role

tasks

POST {adaccount-id}/userpermissions

role

tasks

GET {page-id}/userpermissions

role

tasks

POST {page-id}/userpermissions

role

tasks

GET {business-id}/client_ad_accounts

permitted_role

permitted_tasks

POST {business-id}/client_ad_accounts

permitted_role

permitted_tasks

GET {business-id}/client_pages

permitted_role

permitted_tasks

POST {business-id}/client_pages

permitted_role

permitted_tasks

GET {business-id}/client_pixels

permitted_role

permitted_tasks

GET {adaccount-id}/agencies

permitted_role

permitted_tasks

POST {adaccount-id}/agencies

permitted_role

permitted_tasks

GET {page-id}/agencies

permitted_role

permitted_tasks

POST {page-id}/agencies

permitted_role

permitted_tasks

GET {business-id}/pending_client_pages

permitted_role

permitted_tasks

GET {business-id}/pending_client_ad_accounts

permitted_role

permitted_tasks

يؤثر هذا التصميم الجديد أيضًا في واجهة API الصفحات، راجع واجهة Graph API الإصدار 3.1، واجهة API الصفحات، التغييرات الحديثة. وللاطلاع على وثائق واجهة API مدير الأعمال، راجع:

منصة Messenger

بالنسبة للتطبيقات التي تم إنشاؤها قبل 26 يوليو 2018، ستسري هذه التغييرات في 8 يناير 2019. وبالنسبة للتطبيقات التي تم إنشاؤها بعد 26 يوليو 2018، ستسري هذه التغييرات على الفور.

والآن تقوم واجهة API الملف الشخصي للمستخدم بإرجاع الحقول first_name وlast_name وprofile_pic افتراضيًا. وتتطلب الحقول الإضافية الآن إجراء مراجعة المنتج من خلال علامة التبويب منصة Messenger في لوحة معلومات التطبيق.

تم إيقاف استخدام الحقلين last_ad_referral وis_payment_enabled، وستتم إزالتهما من واجهة API في 30 أكتوبر 2018.

واجهة API للأصدقاء المشتركين

تنطبق هذه التغييرات على الإصدار 3.1 والإصدارات الأعلى، وستنطبق على جميع الإصدارات في 24 أكتوبر 2018.

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

  • /user-context/all_mutual_friends
  • /user-context/mutual_friends
  • /user-context/three_degree_mutual_friends

واجهة API الصفحات

الأذونات

تنطبق التغييرات التالية على الإصدار v3.1 والإصدارات الأعلى، وستنطبق على جميع الإصدارات في 1 فبراير 2019.

يتطلب الإذن pages_manage_cta الآن إجراء مراجعة التطبيق لكل طلبات POST وDELETE. يمكن للتطبيقات التي تم إنشاؤها قبل 26 يوليو 2018 متابعة استخدام هذا الإذن، ولكن يجب تقديمها للمراجعة قبل 1 فبراير 2019 لمتابعة استخدام pages_manage_cta.

أدوار الصفحة

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

تخضع أدوار الصفحة للتوقف عن الاستخدام، ويتم استبدالها بمهام الصفحة. وبدلاً من منح المستخدم دورًا في الصفحة، يجب عليك الآن منح المستخدم ما يماثل هذا الدور في المهام.

الدورالمهام المتكافئة

Admin

ADVERTISE, ANALYZE, CREATE_CONTENT, MANAGE, MODERATE

Advertiser

ADVERTISE, ANALYZE

Analyst

ANALYZE

Editor

ADVERTISE, ANALYZE, CREATE_CONTENT, MODERATE

Moderator

ADVERTISE, ANALYZE, MODERATE

حتى يتم الانتهاء بالكامل من عملية استبدال الأذونات المستندة إلى الدور بالأذونات المستندة إلى المهمة، يجب عليك منح كل المهام المماثلة للدور عند منح مهام عبر /page/roles، وإلا فستفشل العملية POST.

ولدعم هذه التغييرات، تم التوقف عن استخدام الحقلين perms وrole واستبدالهما بحقل tasks جديد. يؤثر ذلك على عناصر الربط التالية:

  • /me/accounts
  • /page/roles
  • /user/accounts

يرجى الرجوع إلى سجل تغييرات واجهة API التسويق لمعرفة كيفية تأثير هذه التغييرات على واجهة API التسويق وواجهة API مدير الأعمال.

Webhooks

تنطبق هذه التغييرات على الإصدار 3.1 والإصدارات الأعلى، وستنطبق على جميع الإصدارات في 24 أكتوبر 2018.

تم التوقف عن استخدام حقول webhook التالية الخاصة بالمستخدم:

  • pic_big_with_logo
  • pic_small_with_logo
  • pic_square_with_logo
  • pic_with_logo

تستخدم الآن حقول webhook التالية الخاصة بالمستخدم عناوين URL لـ HTTPS بدلاً من HTTP.

  • pic
  • pic_big
  • pic_small
  • pic_square
  • picture

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