مربع حوار الأخبار

يمكنك إضافة مربع حوار الأخبار إلى تطبيقك حتى يمكن للأشخاص نشر أحداث فردية مع تعليقات على اليوميات.

لا تتطلب مشاركة الأحداث عبر مربع حوار الأخبار طلب أي أذونات موسعة.

الدمج

يمكن استخدام مربع الحوار هذا مع مجموعات Facebook SDK for JavaScript ولنظام iOS ولنظام Android من خلال إجراء إعادة توجيه للصفحة بالكامل إلى عنوان URL. وفيما يلي بعض الأمثلة على أجزاء الرمز البرمجي التي يمكن استخدامها لتشغيل مربع الحوار هذا.

لغة JavaScript

لتشغيل مربع حوار الأخبار، قم باستدعاء الدالة FB.ui واستخدم القيمة feed في المعلمة method.

FB.ui({
  method: 'feed',
  link: 'https://developers.facebook.com/docs/'
}, function(response){});

نظام iOS

اقرأ دليل مربع الحوار مشاركة لنظام iOS الذي يسمح لك أيضًا بنشر أحداث Open Graph.

نظام Android

اقرأ حول مربع الحوار مشاركة لنظام Android الذي يسمح لك أيضًا بنشر أحداث Open Graph.

إعادة التوجيه لعنوان URL

https://www.facebook.com/dialog/feed?
  app_id=145634995501895
  &display=popup
  &link=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2F
  &redirect_uri=https://developers.facebook.com/tools/explorer

ملاحظة

في حالة تعيين الإعداد "مَن يمكنه النشر على يومياتك؟" لدى أي شخص إلى "أنا فقط" ويحاول شخص آخر إنشاء منشور في يوميات الشخص الأول باستخدام مربع حوار الأخبار، سيظهر الخطأ "تعذر النشر".

المعلمات

ملاحظة: إذا كان تطبيقك يشارك روابط في iTunes أو متاجر Google Play أو في ملف شخصي أو صفحة على فيسبوك، فإننا لا ننشر أي صور أو أوصاف تحددها في المشاركة مع المعلمات أدناه. وبدلًا من نشر بعض المعلومات عن التطبيق، فإننا نحصل عليها من متجر التطبيقات أو صفحة فيسبوك مباشرة باستخدام Webcrawler. قد لا يتضمن ذلك صورًا. لمعاينة مشاركة الرابط في iTunes أو Google Play، أدخل عنوان URL في أداة تصحيح أخطاء المشاركة.

المعلمة	الوصف
`app_id`	يمثل معرف تطبيقك الفريد. ويلزم توفيره.
`redirect_uri`	يمثل عنوان URL الذي تتم إعادة التوجيه إليه بعد أن ينقر شخص على زر في مربع الحوار. ويلزم توفيره عند استخدام ميزة إعادة التوجيه لعنوان URL.
`display`	يمكن تحديد طريقة عرض مربع الحوار. إذا كنت تستخدم تنفيذ مربع حوار إعادة التوجيه لعنوان URL، فستكون طريقة العرض المُستخدمة هي عرض صفحة بالكامل كما هو موضح في Facebook.com. ويُعرف نوع العرض هذا بالاسم `page`. إذا كنت تستخدم مجموعة Facebook SDK لنظام iOS أو نظام Android من أجل استدعاء مربع الحوار، فيتم تحديد ذلك تلقائيًا واختيار نوع عرض مناسب للجهاز. إذا كنت تستخدم مجموعة Facebook SDK for Javascript، فسيتم تعيين العرض افتراضيًا إلى نوع `iframe` مشروط بالنسبة للأشخاص الذين سجّلوا الدخول إلى تطبيقك أو `async` عند استخدامه في إحدى الألعاب على Facebook.com ونافذة `popup` بالنسبة لأي شخص آخر. ويمكنك أيضًا فرض استخدام النوع `popup` أو `page` عند استخدام مجموعة Facebook SDK for Javascript إذا لزم الأمر. يتم دائمًا تعيين تطبيقات ويب الهواتف المحمولة افتراضيًا إلى نوع العرض `touch`.
`from`	يمثل معرف الشخص الذي ينشر الرسالة. وإذا لم يتم تحديده، فيتم التعيين افتراضيًا إلى الشخص الحالي. أما إذا تم تحديده، فيجب أن يكون معرف الشخص أو الصفحة التي يتمتع الشخص بدور المسؤول فيها.
`to`	يمثل معرف الملف الشخصي الذي سيتم فيه نشر هذا الحدث. إذا لم يتم تحديده، فيتم التعيين افتراضيًا إلى قيمة `from`. ويجب أن يكون المعرف صديق يستخدم أيضًا تطبيقك.
`link`	يمثل الرابط المرفق بهذا المنشور.
`source`	يمثل عنوان URL لملف وسائط (SWF أو MP3) مرفق بهذا المنشور. وفي حالة استخدام ملف SWF، يجب عليك أيضًا تحديد `picture` لتوفير صورة مصغرة للفيديو.
`ref`	هذه الوسيطة عبارة عن قائمة مفصولة بفواصل وتتكون من 5 عناصر مميزة بحد أقصى يصل طولها إلى حرف واحد على الأقل و15 حرفًا كحد أقصى يتم الحصول عليها من المجموعة '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_'. ويتم استخدام كل فئة في رؤى فيسبوك لمساعدتك في قياس أداء أنواع المنشورات المختلفة

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

المعلمة	الوصف
`post_id`	يمثل معرف الحدث المنشور إذا اختار الشخص نشره في يومياته.
`properties`	يمثل كائن بلغة JSON خاص بأزواج المفتاح/القيمة التي ستظهر في مرفق البث أسفل الوصف مع كل خاصية في السطر الخاص بها. ويجب أن تكون المفاتيح عبارة عن سلاسل ويمكن أن تكون القيم إما سلاسل أو كائنات بلغة JSON مع المفتاحين `text` و`href`.
`actions`	يمثل مصفوفة بلغة JSON تحتوي على كائن واحد يصف رابط الإجراء الذي سيظهر بجانب رابط "التعليق" و"الإعجاب" ضمن المنشورات. ويجب أن يحتوي الكائن المضمن على المفتاحين `name` و`link`.
`picture`	يمثل عنوان URL لصورة مرفقة بهذا المنشور. ويجب أن تكون الصورة بحجم 200 بيكسل في 200 بيكسل على الأقل. لمزيد من المعلومات حول الأحجام، يمكنك الرجوع إلى الوثائق المتوفرة حول أفضل ممارسات المشاركة.
`name`	يمثل اسم مرفق الرابط.
`caption`	يمثل الشرح التوضيحي للرابط (يظهر أسفل اسم الرابط). وإذا لم يتم تحديده، فسيتم ملء هذا الحقل تلقائيًا بعنوان URL للرابط.
`description`	يمثل وصف الرابط (يظهر أسفل الشرح التوضيحي للرابط). وإذا لم يتم تحديده، فسيتم ملء هذا الحقل تلقائيًا بالمعلومات التي تم الحصول عليها من الرابط وتكون عادة هي عنوان الصفحة.
`thumbnail`	يمثل ملف الصورة المحلية الذي تم تحميلها، مثل `.jpg` أو `.jpeg` أو `.gif` أو `.png`.