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

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

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

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

قبل البدء

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

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

أرسل طلب GET إلى نقطة النهاية /<PAGE_ID>/videos للحصول على قائمة بجميع مقاطع الفيديو بالصفحة.

curl -i -X GET "https://graph.facebook.com/&lt;PAGE_ID>/videos?access_token=&lt;PAGE_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، فهذا يعني أن منشور الفيديو لم يكن يحتوي على نص مرفق.

راجع أيضًا