أحداث Open Graph

احرص على نشر أحداث جيدة البنية ومنسقة من تطبيقك باستخدام API محددة النوع بدقة.

أحداث Open Graph في نظام التشغيل iOS انشر أحداث Open Graph من تطبيقك على iOS.

أحداث Open Graph في نظام التشغيل Android انشر أحداث Open Graph من تطبيقك على Android.

أحداث Open Graph على الويب انشر أحداث Open Graph من تطبيقك على الويب أو موقعك على الويب.

طريقة العمل

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

لنشر أحداث Open Graph باستخدام مربع الحوار مشاركة، لا يتعين عليك تنفيذ تسجيل دخول فيسبوك أو طلب أذونات إضافية. لمزيد من المعلومات، راجع مربع الحوار مشاركة.

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

تشتمل أحداث Open Graph على أربعة عناصر أساسية:

  • المنفّذ - الشخص الذي ينشر الحدث

  • التطبيق - يشتمل كل حدث على إسناد إلى التطبيق الذي أنشأه

  • الإجراء - النشاط الذي يؤديه المنفّذ

  • الكائن - الشيء الذي يتفاعل معه المنفّذ

الخصوصية

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

استخدام الإجراءات

الإجراءات عبارة عن 'الأفعال' أو الأشياء التي يمكن للأشخاص القيام بها في تطبيقك ونشرها كأحداث. ويتم نشر الإجراءات واسترجاعها وتعديلها باستخدام Graph API.

استخدام الكائنات

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

أفضل الممارسات

راجع أفضل ممارسات المشاركة للحصول على أفضل تجربة مشاركة تفاعلية.

المرجع

وثائق Open Graph المرجعية.

تم إيقاف استخدام أحداث Open Graph المخصصة في الإصدار Graph API 2.8. يستمر دعم الإصدار Graph API 2.7 والإصدارات السابقة له لأحداث Open Graph المخصصة وفقًا للجدول الزمني التالي:

  • ينتهي دعم إنشاء كائنات جديدة في يناير 2017.
  • ينتهي دعم نشر كائنات موجودة في أكتوبر 2017.

إنشاء أحداث Open Graph مخصصة

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