‏واجهة API الفيديو‏

الحصول على مقاطع الفيديو

يوضح هذا المستند كيفية الحصول على مقاطع الفيديوبالصفحات والمجموعات ولدى المستخدمين.

الحصول على مقاطع فيديو المجموعة

قبل البدء

للحصول على مقاطع الفيديو بمجموعة المستخدم، ستحتاج إلى ما يلي:

للحصول على مقاطع الفيديو بمجموعة الصفحة، ستحتاج إلى ما يلي:

أرسل طلب GET إلى نقطة النهاية /{group-id}/videos:

curl -i -X GET "https://graph.facebook.com/{group-id}/videos?access_token={access-token}"

عند نجاح العملية، يتلقى تطبيقك الاستجابة التالية:

{ "data": [ { "updated_time": "2020-05-18T18:51:15+0000", "id": "{video-id-1}" }, { "description": "Sunshine", "updated_time": "2020-05-18T18:35:09+0000", "id": "{video-id-2}" } ... ], "paging": { "cursors": { "before": "...", "after": "..." } } }

الحصول على مقاطع الفيديو بالصفحة

قبل البدء

بالنسبة للصفحات التي يمكنك تنفيذ المهمة MANAGE بها، ستحتاج إلى ما يلي:

بالنسبة للصفحات العامة التي لا يمكنك تنفيذ المهمة MANAGE بها، ستحتاج إلى ما يلي:

أرسل طلب GET إلى نقطة النهاية /{page-id}/videos للحصول على قائمة بجميع مقاطع الفيديو بالصفحة.

curl -i -X GET "https://graph.facebook.com/{page-id}/videos?access_token={access-token}"

عند نجاح العملية، يتلقى تطبيقك الاستجابة التالية:

{ "data": [ { "description": "Clouds", "updated_time": "2019-09-25T17:18:30+0000", "id": "2153206464921154" }, { "updated_time": "2020-03-26T23:45:11+0000", "id": "2232477747039197" }, ... ], "paging": { "cursors": { "before": "MjE1MzIwNjQ2NDkyMTE1NAZDZD", "after": "MTQwOTU5MTg4NTc2MzM0MwZDZD" } } }

الحصول على مقاطع الفيديو لدى المستخدمين

قبل البدء

ستحتاج إلى ما يلي:

  • رمز وصول المستخدم المطلوب من جانب المستخدم الذي تعود إليه ملكية الفيديو
  • الإذن user_videos

أرسل طلب GET إلى /{user-id}/videos?type=uploaded للحصول على جميع مقاطع الفيديو التي قام شخص ما بتحميلها، أو أرسل الطلب إلى /{user-id}/videos?type=tagged للحصول على جميع مقاطع الفيديو التي تمت الإشارة إلى شخص ما بها.

curl -i -X GET "https://graph.facebook.com/{user-id}/videos ?type=uploaded &access_token={user-access-token}"

عند نجاح العملية، يتلقى تطبيقك الاستجابة التالية:

{ "data": [ { "description": "Rain", "updated_time": "2020-05-18T20:07:47+0000", "id": "{video-id-1}" }, { "updated_time": "2020-05-20T12:26:19+0000", "id": "{video-id-2}" }, ... ] "paging": { "cursors": { "before": "...", "after": "..." } } }

التقييدات

  • سيؤدي إرسال طلب GET دون تحديد type، افتراضيًا، إلى إرجاع مقاطع الفيديو التي تمت الإشارة إلى شخص ما بها.
  • إذا لم يتم إرجاع description، فإن منشور الفيديو لم يكن يحتوي على نص مرفق.

راجع أيضًا