الإصدار 8.0

واجهة Graph API

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

رموز الوصول

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

تم إيقاف الاستخدام في الإصدار 8.0 والإصدارات الأحدث. وسيتم إيقاف الاستخدام في كل الإصدارات اعتبارًا من 2 نوفمبر 2020.

• GET /token_deprecation_check

الألبومات

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

تنطبق على جميع الإصدارات.

• GET /{album-id}/likes

تكوين التطبيق

أنواع التطبيقات

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

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

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

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

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

تنطبق على كل الإصدارات.

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

إزالة وضع التطوير ووضع البث المباشر

تنطبق على كل الإصدارات.

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

ميزة جديدة للوصول إلى الملف الشخصي لمستخدم أصل النشاط التجاري

تنطبق على كل الإصدارات.

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

التعليقات

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

تنطبق على كل الإصدارات.

• GET /{comment-id}/likes

الأجهزة

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

تم إيقاف الاستخدام في الإصدار 8.0 والإصدارات الأحدث. وسيتم إيقاف الاستخدام في كل الإصدارات اعتبارًا من 2 نوفمبر 2020.

• POST /device/share

المجموعات

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

تم إيقاف الاستخدام في الإصدار 8.0 والإصدارات الأحدث.

• GET /{group-id}/posts

تم إيقاف الاستخدام في الإصدار 8.0 والإصدارات الأحدث. وسيتم إيقاف الاستخدام في كل الإصدارات اعتبارًا من 2 نوفمبر 2020.

• GET /{group-post-id}/likes

Instagram

نقطة نهاية oEmbed الجديدة في Instagram

تنطبق على كل الإصدارات.

تم إدخال نقطة نهاية GET /instagram_oembed جديدة. كما أنها توفر الأداء الوظيفي نفسه مثل نقاط نهاية oEmbed القديمة في Instagram والتي سيتم إيقاف استخدامها اعتبارًا من 24 أكتوبر 2020. وتتطلب نقطة النهاية الجديدة توفير رمز وصول، لذلك ستحتاج إلى حساب مطوّر على Facebook وتطبيق مسجّل للوصول إليها. وللحصول على إرشادات حول الاستخدام وتفاصيل إضافية، يمكنك الرجوع إلى مستند oEmbed في Instagram.

الأحداث الشخصية

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

تم إيقاف الاستخدام في الإصدار 8.0 والإصدارات الأحدث.

• GET /{life-event-id}
• GET /{life-events-id}/photos

الروابط

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

تم إيقاف الاستخدام في الإصدار 8.0 والإصدارات الأحدث.

• GET /{link-id}/reactions

مقاطع فيديو البث المباشر

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

تم إيقاف الاستخدام في الإصدار 8.0 والإصدارات الأحدث.

• GET /{live-video-id}/likes

استخدم نقطة النهاية GET /{live-video-id}/reactions للحصول على تسجيلات الإعجاب على LiveVideo.

معلمة save_vod

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

تم إيقاف استخدام المعلمة save_vod لعناصر الربط التالية:

• POST /{user_id}/live_videos
• POST /{group_id}/live_videos
• POST /{page_id}/live_videos
• POST /{event_id}/live_videos

منصة Messenger

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

تم إيقاف الاستخدام في الإصدار 8.0 والإصدارات الأحدث.

• GET /{page-id}/thread_settings
• POST /{page-id}/thread_settings
• DELETE /{page-id}/thread_settings

مراجعة التطبيقات

تنطبق على كل الإصدارات.

تم نقل عملية مراجعة التطبيقات لتطبيق Messenger من المنتجات > Messenger > الإعدادات إلى مراجعة التطبيقات في لوحة معلومات التطبيق. ولطلب الحصول على أذونات محددة مثل pages_messaging وpages_user_gender وpages_user_locale وpages_user_timezone، انتقل إلى مراجعة التطبيقات > الأذونات والميزات. ولمزيد من التفاصيل، يمكنك الرجوع إلى وثائق مراجعة التطبيقات على Messenger.

عنصر ربط الملف الشخصي في Messenger

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

تم إيقاف استخدام نوع القائمة الدائمة المتداخلة لدى POST /{page-id}/messenger_profile.

الميزة الجديدة: Messenger للمتاجر

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

يمكن دعم إرسال المنتجات واستلامها على Messenger للمتاجر. ويتضمن ذلك قالب المنتج الذي يمكن استخدامه في إرسال المنتجات في الرسائل، وأحداث Webhooks للرسائل التي تتضمن قالب المنتج والرسائل من صفحة تفاصيل المنتج لدى متاجر Facebook، وأحداث echo Webhooks للرسائل التي تتضمن منتجات.

• GET /{message_id}/access_requests
• POST {page_id}/message
• message_echo Webhook
• messages Webhook

العروض الأصلية

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

تم إيقاف الاستخدام في الإصدار 8.0 والإصدارات الأحدث.

• GET /{native-offer-id}/nativeofferviews?photos

Open Graph

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

تم إيقاف الاستخدام في الإصدار 8.0 والإصدارات الأحدث. وسيتم إيقاف الاستخدام في كل الإصدارات اعتبارًا من 2 نوفمبر 2020.

• GET /{open-graph-action-id}/comments
• POST /{open-graph-action-id}/comments

الصفحات

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

تم إيقاف الاستخدام في الإصدار 8.0 والإصدارات الأحدث.

• DELETE /{page-id}/tabs
• GET /{group-id}/posts
• GET /{page-id}/place_topics
• GET /{page-about-story-id}
• POST /{page-about-story-id}
• POST /{page-id}/page_about_story

منشور الصفحة

تم إيقاف الاستخدام في كل الإصدارات.

تم إيقاف استخدام تنسيق معرف التعليق على منشور الصفحة والتنسيق {page-id}_{post_id}_{comment-id}. وبدلاً من ذلك، يمكنك استخدام التنسيق {pagepost-id}_{comment-id}.

الصور

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

تم إيقاف الاستخدام في كل الإصدارات.

• GET /{photo-id}/sharedposts

الأماكن

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

تم إيقاف الاستخدام في الإصدار 8.0 والإصدارات الأحدث.

• GET /{place-information-id} (مراجعة التصحيحات)

المنشورات

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

تم إيقاف الاستخدام في الإصدار 8.0 والإصدارات الأحدث. وسيتم إيقاف الاستخدام في كل الإصدارات اعتبارًا من 2 نوفمبر 2020.

• GET /{post-id}/likes

استخدم نقطة النهاية GET /post/reactions للحصول على تسجيلات الإعجاب على أي منشور.

البحث

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

تم إيقاف الاستخدام في الإصدار 8.0 والإصدارات الأحدث. وسيتم إيقاف الاستخدام في كل الإصدارات اعتبارًا من 2 نوفمبر 2020.

• GET /search?type=place
• GET /search?type=audience_interest

إعدادات الأمان

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

تم إيقاف الاستخدام في الإصدار 8.0 والإصدارات الأحدث. وسيتم إيقاف الاستخدام في كل الإصدارات اعتبارًا من نوفمبر 2020.

• secure_browsing

المكونات الإضافية للتواصل الاجتماعي

نقاط نهاية oEmbed في Facebook

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

سيتم إيقاف استخدام نقاط نهاية oEmbed في Facebook والتي تسمح للتطبيقات بالحصول على HTML مُضمن للمنشورات ومقاطع الفيديو العامة على Facebook اعتبارًا من 24 أكتوبر 2020. وتم إدخال ثلاث نقاط نهاية جديدة توفر الأداء الوظيفي نفسه على غرار نقاط النهاية القديمة التي تحل محلها:

• GET /oembed_page
• GET /oembed_post
• GET /oembed_video

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

المستخدمون

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

تم إيقاف الاستخدام في الإصدار 8.0 والإصدارات الأحدث.

• GET /{user-id}/taggable_friends

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

تم إيقاف الاستخدام في الإصدار 8.0 والإصدارات الأحدث. وسيتم إيقاف الاستخدام في كل الإصدارات اعتبارًا من نوفمبر 2020.

• security_settings
• test_group
• viewer_can_send_gift
• is_shared_login

تم إيقاف الاستخدام في كل الإصدارات.

• can_review_measurement_request
• is_famedeeplinkinguser

إعادة التصريح

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

اعتبارًا من 24 أكتوبر 2020، ستتطلب الحقول التالية إعادة تصريح الوصول إلى البيانات بعد مرور 90 يومًا من عدم النشاط:

• is_eligible_promo
• payment_mobile_pricepoint
• payment_pricepoints

صورة المستخدم

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

اعتبارًا من 24 أكتوبر 2020، ستتطلب نقطة النهاية GET /{user-id}/picture (GET /{user-id}?fields=picture) توفير معرف مستخدم على مستوى التطبيق (ASID) للطلبات المتوفرة بدون رمز. وإذا كنت تستعلم عن مستخدم لا يتوفر لديه معرف مستخدم على مستوى التطبيق (ASID)، فيجب تضمين رمز وصول خاص بتطبيق أو عميل أو مستخدم في الطلب. وللحصول على التفاصيل، يمكنك الرجوع إلى مرجع صورة المستخدم.

أسئلة الفيديو

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

تم إيقاف الاستخدام في الإصدار 8.0 والإصدارات الأحدث.

• GET /{question-id}
• GET /{question-id}/options
• GET /{question-id}/votes
• GET /{question-option-id}

Workplace

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

تم إيقاف الاستخدام في الإصدار 8.0 والإصدارات الأحدث. وسيتم إيقاف الاستخدام في كل الإصدارات اعتبارًا من 2 نوفمبر 2020.

• GET /{company-id}/access_requests
• GET /access_requests

API التسويق

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

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

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

تم إيقاف الاستخدام في الإصدار 8.0 والإصدارات الأحدث.

• GET /AdReportSchedule
• DELETE act_{ad-account-id}/adsets

الأذونات

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

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

قواعد تخصيص الأصول

التحقق

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

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

علمًا بأن هذا التغيير يؤثر على تخصيص أصول المواضع والإعلانات متعددة اللغات وتخصيص أصول الشرائح.

تخصيص أصول الشرائح

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

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

عروض الأسعار

إستراتيجية عرض الأسعار للتكلفة المستهدفة

ينطبق على الإصدار 8.0 والإصدارات الأحدث

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

مدير الأعمال

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

تم إيقاف الاستخدام في الإصدار 8.0 والإصدارات الأحدث.

• GET{system-user-id}/updated_by

نقاط نهاية اتفاقيات المشاركة المُعاد إدخالها

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

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

• /{business-id}/received_sharing_agreements
• /{business-id}/initiated_sharing_agreements

تم إيقاف استخدام نقطتي النهاية من قبل بالتزامن مع طرح واجهة Graph API بالإصدار 6.0.

اللوحة

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

• /{canvas-id}/collection_hero_image
• /{canvas-id}/collection_hero_video
• /{canvas-id}/collection_thumbnails

API الكتالوج

الأذونات

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

لم تعد بحاجة إلى الإذن ads_management للوصول إلى نقاط نهاية كتالوج المنتجات. وللمضي قدمًا، ستحتاج إلى الإذن catalog_management لاستدعاء نقاط النهاية هذه. وسيتم تلقائيًا ترحيل المطوّرين الذين تمكّنوا من الوصول إلى نقاط نهاية الكتالوج عبر ads_management خلال آخر 90 يومًا إلى أذونات catalog_management بحلول 14 أغسطس 2020.

اعتبارًا من الآن وحتى 28 فبراير 2021، سيظل بإمكان المطوّرين الذين يستخدمون إصدارات سابقة من واجهة API استدعاء نقاط نهاية كتالوج المنتجات من خلال الإذن ads_management. وإذا كنت تستخدم الإصدار 8.0، فيجب أن يتوفر لديك الإذن catalog_management.

بعد انقضاء الموعد النهائي في شهر فبراير، لن يعد الإذن catalog_management مرتبطًا بالإذن ads_management بعد الآن، لذا سيتعين على المستخدمين منح الإذن catalog_management لتطبيقك بشكل واضح.

المصادقة

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

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

عندما يتمكّن مستخدم التطبيق الحالي من الوصول إلى الكتالوج من خلال نشاط تجاري شريك، فإننا نتقيد بمتطلبات المصادقة من جانب مدير الأعمال لدى الشريك. ولا يتعين على مستخدمي النظام استخدام المصادقة الثنائية.

• POST /{business-id}/owned_product_catalogs
• POST /{destination-id}
• POST /{home-listing-id}
• DELETE /{home-listing-id}
• POST /{hotel-id}
• DELETE /{hotel-id}
• POST /{hotel-id}/hotel_rooms
• POST /{hotel-room-id}
• DELETE /{hotel-room-id}
• POST /{page-id}/product_catalogs
• POST /{product-catalog-id}
• DELETE /{product-catalog-id}
• POST /{product-catalog-id}/agencies
• DELETE /{product-catalog-id}/agencies
• POST /{product-catalog-id}/assigned_users
• DELETE /{product-catalog-id}/assigned_users
• POST /{product-catalog-id}/batch
• POST /{product-catalog-id}/categories
• POST /{product-catalog-id}/destinations
• POST /{product-catalog-id}/external_event_sources
• DELETE /{product-catalog-id}/external_event_sources
• POST /{product-catalog-id}/flights
• POST /{product-catalog-id}/home_listings
• POST /{product-catalog-id}/hotel_rooms_batch
• POST /{product-catalog-id}/hotels
• POST /{product-catalog-id}/items_batch
• /{product-catalog-id}/pricing_variables_batch
• POST /{product-catalog-id}/product_groups
• POST /{product-catalog-id}/product_feeds
• POST /{product-catalog-id}/product_sets
• POST /{product-catalog-id}/products
• POST /{product-catalog-id}/vehicles
• POST /{product-feed-rule-id}
• DELETE /{product-feed-rule-id}
• POST /{product-feed-id}
• DELETE /{product-feed-id}
• POST /{product-feed-id}/rules
• POST /{product-feed-id}/uploads
• POST /{product-feed-id}/upload_schedules
• POST /{product-feed-schedule-id}
• DELETE /{product-feed-schedule-id}
• POST /{product-feed-upload-id}/error_report
• POST /{product-group-id}
• DELETE /{product-group-id}
• POST /{product-group-id}/products
• POST /{product-item-id}
• DELETE /{product-item-id}
• POST /{product-set-id}
• DELETE /{product-set-id}
• POST /{vehicle-id}

إعداد التقارير

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

ينطبق على الإصدار 8.0 والإصدارات الأحدث

• GET /{ad-study-id}?fields=split_test_config
• GET /{ad-study-id}?fields=iterative_split_test_config

الاستهداف

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

ينطبق على الإصدار 8.0 والإصدارات الأحدث

• GET /search?type=adzipcode

التصحيحات

• 28 سبتمبر 2020 — تم تحديث إدخال مصادقة واجهة API الكتالوج للتوضيح.
• 23 أكتوبر 2020 — تم تحديث إدخال واجهة API الكتالوج:

  • تم تمديد الموعد النهائي عندما وجدنا أنه لا يزال بإمكان المطوّرين الذين يستخدمون إصدارات سابقة من واجهة API استدعاء نقاط نهاية كتالوج المنتجات من خلال الإذن ads_management. وتم تحديد الموعد النهائي الجديد على أن يكون في 28 فبراير 2021.
  • أضفنا توضيحًا بشأن مصادقة مستخدم النظام.
• 17 مايو 2021 — تم تغيير نقطة النهاية التي تم إيقاف استخدامها من GET /{place-id} إلى GET /{place-information-id}. ولم يتم إيقاف استخدام GET /{place-id}.