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

الموضوعات ذات الصلة

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

يتم تحديد الكائنات حسب ترميز HTML لبروتوكول Open Graph بصفحات الويب.

إنشاء الكائنات

يتم إنشاء الكائنات من خلال إضافة إشارات تعريف Open Graph إلى الصفحة التي تستضيف المحتوى الذي توفره.

هذه هي الإشارات الأساسية المطلوبة لتحويل صفحتك إلى كائن. ويمكنك إضافتها إلى <head> ضمن رمز HTML الموجود بصفحتك.

<meta property="fb:app_id"          content="1234567890" /> 
<meta property="og:type"            content="article" /> 
<meta property="og:url"             content="http://newsblog.org/news/136756249803614" /> 
<meta property="og:title"           content="Introducing our New Site" /> 
<meta property="og:image"           content="https://scontent-sea1-1.xx.fbcdn.net/hphotos-xap1/t39.2178-6/851565_496755187057665_544240989_n.jpg" /> 
<meta property="og:description"    content="http://samples.ogp.me/390580850990722" />

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

الاختبار

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

تحديث الكائنات

يعيد متتبع بيانات فيسبوك استخلاص (وبالتالي تحديث) الكائنات:

عند إدخال عنوان URL للكائن في أداة تصحيح أخطاء المشاركة
كل 30 يومًا بعد أول عملية استخلاص
عندما يبدأ تطبيق عملية استخلاص باستخدام نقطة نهاية API

تمثل نقطة نهاية واجهة Graph API هذه ببساطة استدعاءً إلى ما يلي:

POST /?id={object-instance-id or object-url}&scrape=true

ستكون الاستجابة من نقطة النهاية هذه عبارة عن كائن بلغة JSON يحتوي على كل المعلومات المتعلقة بالكائن الذي تم استخلاصه (البيانات نفسها التي تم إرجاعها عند قراءة معرف الكائن من جانب واجهة Graph API).

يمكن أن تكون المعلمة id عبارة عن عنوان URL متعارف عليه للكائن أو معرف مثيل الكائن في المخطط.

يمكنك دائمًا تعديل خصائص الكائن مع وجود استثناءين:

العنوان: بمجرد ربط 50 إجراءً (تسجيلات إعجاب ومشاركات وتعليقات) بكائن ما، لن تتمكّن من تحديث عنوانه
النوع: لا يمكن تغيير نوع الكائن بمجرد استخدامه في أي حدث. ولمزيد من المعلومات، راجع أنواع Open Graph.

إذا كنت تريد تحديث صورة كائن، فنقترح بشدة بأن يكون عنوان URL للصورة مختلفًا عن عنوان URL الأصلي للصورة. وللعلم، يمكن أن يمنع التخزين المؤقت تحديث الصورة.

ترحيلات الصفحات وتغيير عناوين URL

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