‏المشاركة‏

مربع الحوار إرسال

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

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

يجب توفير مربع الحوار إرسال في المواقف التي يرغب فيها الشخص في إرسال رسالة بريد إلكتروني.

نماذج للتكامل

يمكنك إضافة مربع الحوار هذا إلى موقعك على الويب باستخدام Facebook SDK للغة Javascript وبتنفيذ إعادة توجيه كاملة إلى عنوان URL. وهذا الأمر غير مدعوم على الأجهزة المحمولة.

JavaScript

يمكنك تحميل نفس عنوان URL لمربع الحوار إرسال باستخدام Facebook SDK للغة Javascript:

FB.ui({
  method: 'send',
  link: 'http://www.nytimes.com/interactive/2015/04/15/travel/europe-favorite-streets.html',
});

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

http://www.facebook.com/dialog/send?
  app_id=123456789
  &link=http://www.nytimes.com/interactive/2015/04/15/travel/europe-favorite-streets.html
  &redirect_uri=https://www.domain.com/

المعلمات

المعلمة الوصف

app_id

المعرف الفريد لتطبيقك. ويجب إدخال هذه المعلمة.

redirect_uri

عنوان URL الوجهة الذي يتم توجيه الشخص إليه بعد النقر على زر في مربع الحوار. يجب إدخال هذه المعلمة عند استخدام إعادة توجيه عنوان URL.

display

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

  • في حالة استخدامك لمربع حوار إعادة توجيه عنوان URL، سيتم عرض صفحة كاملة تظهر في Facebook.com. ويطلق على نوع العرض هذا اسم page.
  • إذا كنت تستخدم Facebook SDK للغة JavaScript، يتم تعيين الإعداد الافتراضي على نوع iframe شرطي للأشخاص المسجل دخولهم إلى تطبيقك أو async عند استخدام لعبة على Facebook.com، ونافذة popup لأي شخص آخر.

to

معرف المستخدم للمستلِم. بمجرد ظهور مربع الحوار، يمكن للمرسل تحديد أشخاص إضافيين كمستلمين.

link

وهي معلمة مطلوبة. وهي تمثل عنوان URL الذي يتم إرساله في الرسالة.

بيانات الاستجابة

لا توجد بيانات استجابة من مربع الحوار هذا.