المكونات
عناوين URL للمضيف
https://graph-video.facebook.com— يُستخدم حصريًا لنشر مقاطع الفيديو على الصفحات والمجموعات.https://graph.facebook.com— يُستخدم للإجراءات الأخرى (مثل إنشاء استطلاعات الرأي والحصول على الرؤى، وغير ذلك).
بروتوكولات التحميل
تدعم واجهة API بروتوكولات التحميل القابل للاستئناف وغير القابل للاستئناف. ويتم استخدام بروتوكول التحميل القابل للاستئناف لتحميل أجزاء الفيديو تباعًا، بينما يتم استخدام بروتوكول التحميل غير القابل للاستئناف لتحميل مقاطع الفيديو بالكامل. ونوصي باستخدام بروتوكول التحميل القابل للاستئناف نظرًا لأنه يدعم ملفات الفيديو الأكبر حجمًا ويتيح لك معالجة حالات انقطاع الاتصال بكفاءة أكبر.
الموارد
تستخدم واجهة API العُقد التالية.
مقاطع الفيديو
تمثل عقدة الفيديو المورد الأساسي لواجهة API. وعند تحميل مقطع فيديو موجود، تنشئ واجهة API كيان فيديو وتنشره على صفحة أو مجموعة حسب العقدة التي تستهدفها عند بدء عملية النشر. ويجب نشر مقاطع الفيديو بعقدة مستهدفة.
الصفحات
يمكن نشر مقاطع الفيديو على مجموعة طالما أن التطبيق يحتوي على الأذونات والميزات المناسبة. بالإضافة إلى ذلك، يجب أن يكون مستخدم التطبيق قادرًا على تنفيذ مهام مكافئة لدور المسؤول على الصفحة، أو أن يتم منحه دور مسؤول على الصفحة عبر مدير الأعمال.
المجموعات
يمكن نشر مقاطع الفيديو على مجموعة طالما أن التطبيق يحتوي على الأذونات والميزات المناسبة وأن مستخدم التطبيق يتمتع بدور المسؤول عن المجموعة.
مقاطع الفيديو المنشورة في منشورات متعددة
يمكن أيضًا إعادة نشر مقاطع الفيديو المنشورة مسبقًا على الصفحات الأخرى التي يديرها مستخدم التطبيق دون الحاجة إلى إعادة تحميلها. ويمكن إرجاع الرؤى حول مقاطع الفيديو المنشورة في منشورات متعددة في صورة قيم مجمّعة (مثل، إجمالي عدد المشاهدات عبر كل الصفحات) أو قيم مُقسمة حسب الصفحة.
عروض الشرائح
يمكنك استخدم واجهة API لإنشاء فيديو عرض شرائح من مجموعة من الصور المُستضافة على خادم عام.
استطلاعات الرأي
يمكنك استخدام واجهة API لإنشاء استطلاعات رأي حول مقاطع الفيديو المنشورة والحصول على نتائجها.
الإعلانات
يمكن استخدام مقاطع الفيديو المنشورة مع نقطة النهاية تصميم الإعلان في واجهة API التسويق لإنشاء إعلانات الفيديو.
الرؤى
يمكنك الحصول على رؤى حول أي مقطع فيديو منشور. ويمكن إرجاع الرؤى حول مقاطع الفيديو المنشورة في منشورات متعددة في صورة قيم مجمّعة أو قيم مُقسمة حسب الصفحة.
أحداث Webhooks
بالنسبة لمقاطع الفيديو المنشورة على الصفحات، يمكنك تلقي إشعارات فورية بشأن التغييرات التي طرأت على حالة نشر الفيديو وتفاعلات المشاهد من خلال إعداد أحداث Webhooks للصفحة. ويمكنك إعداد استدعاء، ثم الاشتراك في حقلي feed وvideos لموضوع الصفحة من أجل تلقي الإشعارات. ولاحظ أنه لن يتم إرسال إشعارات لمقاطع الفيديو التي تم تحميلها على أنها secret أو no_story.
إدارة الحقوق
بالنسبة لمقاطع الفيديو المنشورة على الصفحة، يمكنك استخدام واجهة API إدارة الحقوق لإنشاء قواعد حقوق النشر وتطبيقها من أجل استكشاف مقاطع الفيديو الأخرى المنشورة والتي قد تمثل انتهاكًا، والإبلاغ عنها.
المتطلبات
الأذونات
للنشر على صفحة، يجب على مستخدم التطبيق منح تطبيقك الأذونات pages_show_list وpages_read_engagement وpages_manage_posts.
أما للنشر على مجموعة، فيجب على مستخدم التطبيق منح تطبيقك الإذن publish_to_groups.
الميزات
لا يلزم توفير ميزات للنشر على الصفحة. وللنشر على مجموعة، يجب اعتماد تطبيقك للحصول على ميزة واجهة API المجموعات.
دور المسؤول
يجب أن يتمكّن مستخدم التطبيق من تنفيذ مهام مكافئة لمهام ADMIN على الصفحة المستهدفة، أو يتمتع بدور المسؤول عن المجموعة المستهدفة.
مراجعة التطبيقات
تتطلب جميع الأذونات والميزات الخضوع لعملية مراجعة التطبيقات.
طريقة العمل
يتمثل الدفق العام لنشر فيديو على صفحة أو مجموعة في:
- الحصول على رمز الوصول والأذونات المناسبة من جانب مستخدم تطبيقك.
- الحصول على قائمة بالصفحات أو المجموعات التي يمكن لمستخدم التطبيق تنفيذ مهام مكافئة لدور المسؤول عليها.
- توفير طريقة لمستخدم التطبيق من أجل تحديد الصفحة أو المجموعة حيث يريد عرض الفيديو بها.
- توفير طريقة لمستخدم التطبيق لتحديد فيديو سيتم نشره.
- تقسيم الفيديو إلى أجزاء أصغر.
- بدء جلسة التحميل، وتحميل الأجزاء الفردية.
- إنهاء جلسة التحميل.