نقاط نهاية oEmbed لمحتوى فيسبوك القابل للتضمين

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

عناوين URL لنقطة النهاية

يمكنك استخدام نقطة نهاية API لطلب رمز التضمين للمنشورات ومقاطع الفيديو العامة، وتكون كل الاستجابات بتنسيق json. عنوان URL للمنشور أو مقطع الفيديو مكان {content-url}:

النوع عنوان URL لنقطة النهاية

المنشور

https://www.facebook.com/plugins/post/oembed.json/?url={content-url}

Video

https://www.facebook.com/plugins/video/oembed.json/?url={content-url}

عناوين URL للمحتوى

يمكن للمنشورات ومقاطع الفيديو العامة على فيسبوك استخدام أي من مخططات عناوين URL التالية:

  • المنشورات:
  • https://www.facebook.com/{page-name}/posts/{post-id}
  • https://www.facebook.com/{username}/posts/{post-id}
  • https://www.facebook.com/{username}/activity/{activity-id}
  • https://www.facebook.com/photo.php?fbid={photo-id}
  • https://www.facebook.com/photos/{photo-id}
  • https://www.facebook.com/permalink.php?story_fbid={post-id}
  • https://www.facebook.com/media/set?set={set-id}
  • https://www.facebook.com/questions/{question-id}
  • https://www.facebook.com/notes/{username}/{note-url}/{note-id}
  • مقاطع الفيديو:
  • https://www.facebook.com/{page-name}/videos/{video-id}/
  • https://www.facebook.com/{username}/videos/{video-id}/
  • https://www.facebook.com/video.php?id={video-id}
  • https://www.facebook.com/video.php?v={video-id}

ملاحظة: نظرًا للتطور المستمر لمنصتنا، يمكن أن تكون هذه القائمة غير مكتملة.

مثال

لنفترض أنك تريد الحصول على بيانات oEmbed لتضمين فيديو مطوري فيسبوك كيفية المشاركة مع الأصدقاء فقط، عليك استدعاء عنوان URL لنقطة النهاية: https://www.facebook.com/plugins/video/oembed.json/?url=https%3A%2F%2Fwww.facebook.com%2Ffacebook%2Fvideos%2F10153231379946729%2F

من المفترض أن تظهر استجابة json على النحو التالي:

{
  "author_name": "Facebook",
  "author_url": "https://www.facebook.com/facebook/",
  "provider_url": "https://www.facebook.com",
  "provider_name": "Facebook",
  "success": true,
  "height": null,
  "html": "<div id=\"fb-root\"></div>\n<script>(function(d, s, id) {\n  var js, fjs = d.getElementsByTagName(s)[0];\n  if (d.getElementById(id)) return;\n  js = d.createElement(s); js.id = id;\n  js.src = \"//connect.facebook.net/en_US/sdk.js#xfbml=1&amp;version=v2.9\";\n  fjs.parentNode.insertBefore(js, fjs);\n}(document, 'script', 'facebook-jssdk'));</script><div class=\"fb-video\" data-href=\"https://www.facebook.com/facebook/videos/10153231379946729/\"><div class=\"fb-xfbml-parse-ignore\"><blockquote cite=\"https://www.facebook.com/facebook/videos/10153231379946729/\"><a href=\"https://www.facebook.com/facebook/videos/10153231379946729/\">How to Share With Just Friends</a><p>How to share with just friends.</p>Posted by <a href=\"https://www.facebook.com/facebook/\">Facebook</a> on Friday, December 5, 2014</blockquote></div></div>",
  "type": "video",
  "version": "1.0",
  "url": "https://www.facebook.com/facebook/videos/10153231379946729/",
  "width": "100%"
}

المعلمات

يجب إرسال جميع المعلمات بعنوان URL مشفر.

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

url

عنوان URL للمنشور أو الفيديو (مطلوب)

maxwidth

أقصى عرض للمورد المضمن (اختياري). يرجى ملاحظة أن المعلمة maxheight غير مدعّمة. وذلك بسبب أن الرمز البرمجي للتضمين يعتبر من رموز الاستجابة ويختلف ارتفاعه تبعًا لاختلاف عرضه.

callback

يتم استدعاء JSON (اختياري)

omitscript

إذا تم التعيين على صحيح، فالرمز البرمجي للتضمين لا يشتمل على علامة البرنامج النصي (اختياري)