تم إيقاف استخدام نقاط النهاية الموجودة في هذه الصفحة اعتبارًا من 24 أكتوبر 2020 وتؤدي الآن على إرجاع رمز الخطأ 400
. يُرجى استخدام نقاط نهاية oEmbed الجديدة من فيسبوك بدلاً من ذلك.
oEmbed هو تنسيق مفتوح مُصمم خصيصًا للسماح بتضمين المحتوى من أي موقع ويب في صفحة أخرى. يمكنك استخدام معيار oEmbed لتضمين منشورات ومقاطع فيديو من فيسبوك في موقعك على الويب.
يمكنك استخدام نقطة نهاية API لطلب رمز التضمين للمنشورات ومقاطع الفيديو العامة، وتكون كل الاستجابات بتنسيق json
. استبدل {content-url}
بواسطة عنوان 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 = \"https://connect.facebook.net/en_US/sdk.js#xfbml=1&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 للمنشور أو الفيديو (مطلوب) |
| أقصى عرض للمورد الذي تم تضمينه (اختياري). يُرجى ملاحظة أن المعلمة |
| استجابة JSON المطلوب استدعاؤها (اختياري) |
| إذا تم التعيين على true، فلن يحتوي التضمين على إشارة البرنامج النصي (اختياري) |
| يمكنك التعيين على |