نشر الفيديوهات على صفحة فيسبوك عبر واجهة برمجة التطبيقات (API)
يصل الفيديو إلى صفحة فيسبوك عبر POST /{page-id}/videos، إما بـ file_url، وهو عنوان URL تنزّله Meta بنفسها، أو بملف يرفعه التطبيق إلى Meta أولًا. يسمّي title الفيديو، وdescription هو النص الذي قد تعرضه Meta مع المنشور. ثم تعالج Meta الملف، وGET /{video-id}?fields=status يُظهر video_status بقيمة processing حتى تصبح الحالة ready وتعني جاهزًا.
ينشر easyCoexistence الفيديوهات على صفحات فيسبوك باستخدام publish_facebook_post من Claude أو ChatGPT أو من كودك الخاص، فورًا أو مجدولًا حتى 90 يومًا مقدمًا.
رمز الخطأ عندما تعجز Meta عن جلب ملف الفيديو من العنوان المرسل عبر file_url، أي العنوان الذي يقدّمه التطبيق.
رمز الخطأ لملف فيديو صغير أكثر من اللازم للرفع، فتطلب Meta ملفًا أكبر.
نافذة scheduled_publish_time على الحافة videos، وتُحسب من لحظة نشر الفيديو.
نطاق processing_progress، وهو نسبة ما أُنجز من معالجة الفيديو، ويُعرض إلى جانب video_status في الاستجابة نفسها، وذلك لتتبّع المعالجة.
المضيف المخصص لرفع الفيديو بحسب نظرة Meta العامة على Video API، التي تعدّ graph-video.facebook.com مهجورًا لهذا الغرض.
مقبض الملف الذي يعيده الرفع، ويُمرَّر إلى /{page-id}/videos بوصفه fbuploader_video_file_chunk لنشر الفيديو.
كيف يُنشر الفيديو على صفحة؟
عبر POST /{page-id}/videos مع رمز وصول الصفحة. يصل الملف إلى Meta بإحدى طريقتين: file_url، وهو رابط يمكن الوصول إليه لفيديو تجلبه Meta بنفسها، أو رفع يرسل فيه التطبيق البيانات أولًا. لا يمكن الجمع بين file_url وupload_phase، وهو المعامل الخاص بالرفع المجزّأ، لذا يستخدم الطلب طريقة واحدة منهما.
| file_url | Uploaded file | |
|---|---|---|
| Where the video is | At a URL Meta can reach | On your own system |
| On /{page-id}/videos | file_url | fbuploader_video_file_chunk with the upload's handle |
| Before publishing | Nothing: Meta fetches the file | An upload session, then the bytes |
| If it fails | Error 389 when Meta cannot fetch it | Resume from the offset Meta reports |
كيف يعمل الرفع لملف غير متاح على الإنترنت؟
يعتمد دليل نشر الفيديو لدى Meta على Resumable Upload API. يفتح الطلب POST /{app-id}/uploads مع file_name وfile_length وfile_type جلسةً، ثم يعيد POST /upload:{session-id} مع ترويسة file_offset والبيانات مقبضًا باسم h. ثم يُنشر الفيديو عبر POST /{page-id}/videos مع ضبط fbuploader_video_file_chunk على هذا المقبض، إلى جانب title وdescription. تحمل استدعاءات الرفع هذه رمز وصول المستخدم.
- يُستأنف الرفع المتقطع من قيمة
file_offsetالتي يعيدها GET /upload:{session-id}، وهي موضع المتابعة. - تذكر مرجعية الفيديو أيضًا رفعًا مجزّأً على الحافة نفسها بالمعامل
upload_phaseوقيمه start وtransfer وfinish، معstart_offsetوfile_sizeوvideo_file_chunk، وهي معاملات تحدد الإزاحة وحجم الملف والجزء.
ماذا يفعل title وdescription؟
title هو عنوان الفيديو. أما description فهو، بحسب تعبير Meta، النص الذي يصف المنشور وقد يُعرض في قصة عنه، لذلك يوضع فيه نص المنشور. كلاهما اختياري على حافة videos، وينشر publish_facebook_post نص الرسالة بوصفه description ويترك title بلا قيمة.
كيف تعرف أن الفيديو جاهز؟
تعالج Meta الفيديو بعد وصوله. يعيد GET /{video-id}?fields=status القيمة video_status، فتكون processing أثناء عمل Meta، وready بعد رفع الفيديو وترميزه وتوفر صور مصغّراته، أو error عند فشل المعالجة، مع processing_progress الذي يعطي النسبة المنجزة من 0 إلى 100. ويمكن لـ Meta أيضًا الإبلاغ عن حالة النشر عبر خطاف الويب (webhook) للصفحة على حقل videos، ولا يشترك easyCoexistence في هذه الإشعارات.
ما أكبر حجم للفيديو وأطول مدة له؟
لا تذكر مرجعية صفحات الفيديو ودليل النشر لدى Meta حدًا أقصى لحجم الملف أو مدته، والقاعدة الوحيدة المذكورة هي الرمز 382 لملف صغير أكثر من اللازم للرفع. تضع أدلة Reels وStories مدداً خاصة بها: من 3 إلى 90 ثانية للـ Reel، و60 ثانية كحد أقصى لقصة الفيديو. عندما يجدول easyCoexistence فيديو، ينسخ الملف في تلك اللحظة، ويرفض الملف الذي يزيد حجمه على 1 GB، وهو الحد الذي يضعه النظام.
ما الأذونات ومهمة الصفحة المطلوبة؟
pages_manage_posts وpages_read_engagement وpages_show_list، مع رمز وصول للصفحة من شخص يستطيع تنفيذ المهمة CREATE_CONTENT، وذلك بحسب مرجعية الفيديو ودليل النشر. تصوغ نظرة Meta العامة على Video API الشرط بصرامة أكبر: يجب أن يكون الشخص قادرًا على تنفيذ مهام المدير المكافئة على الصفحة، أو أن يحمل دور مدير يُمنح عبر أداة Business Manager المتاحة.
ما الأخطاء التي قد يعيدها نشر الفيديو؟
تسرد مرجعية الفيديو لدى Meta هذه الأخطاء الخاصة بالطلب POST /{page-id}/videos:
- 389: تعذّر جلب ملف الفيديو من عنوان URL.
- 382: الملف صغير أكثر من اللازم؛ أعد المحاولة بملف أكبر.
- 6000: مشكلة في رفع ملف الفيديو؛ أعد المحاولة بملف آخر.
- 6001: مشكلة في رفع الفيديو؛ أعد المحاولة.
- 368: اعتُبر الإجراء مسيئًا أو مرفوضًا بطريقة أخرى.
- 100: معامل غير صالح؛ 200: خطأ في الأذونات؛ 190: رمز وصول OAuth 2.0 غير صالح.
كيف ينشر publish_facebook_post فيديو؟
يأخذ video_url، وهو رابط HTTPS عام للملف، والنص message، ويرسلهما إلى /{page-id}/videos بوصفهما file_url وdescription، فتجلب Meta الفيديو بنفسها. يحمل المنشور فيديو واحدًا، ويُرفض رابط يُرسل معه، لذا ضع العنوان URL داخل نص الرسالة. يحمل post_id في النتيجة المعرّف الذي أعادته Meta، وهو للفيديو معرّفه الخاص.
كيف يُجدوَل نشر الفيديو؟
أعطِ publish_facebook_post قيمة scheduled_at بصيغة ISO 8601 مع المنطقة الزمنية، بين دقيقة واحدة و90 يومًا قادمة. ينسخ easyCoexistence الفيديو لحظة الجدولة وينشره على الصفحة في ذلك الوقت. تعرض list_scheduled_posts المنشور المجدول، ويغيّر update_scheduled_post موعده أو نصه، ويوقفه cancel_scheduled_post. ويسمح scheduled_publish_time الخاص بـ Meta على حافة videos بمدة تتراوح من 10 دقائق إلى 6 أشهر.
الأخطاء الشائعة
- توجيه file_url إلى صفحة تشغّل الفيديو بدلًا من الملف نفسه. تنزّل Meta العنوان بنفسها، والعنوان الذي لا تستطيع جلبه يعيد الخطأ 389.
- الرفع إلى graph-video.facebook.com خطأ، إذ تعدّ نظرة Meta العامة على Video API هذا المضيف مهجورًا لرفع الفيديو، وتطلب الانتقال إلى مضيف graph.facebook.com المعتمد.
- الإعلان عن الفيديو قبل جاهزيته. تحقّق من الحالة حتى تصبح video_status بقيمة ready، لأن المعالجة تستمر بعد أن يعود استدعاء النشر.
- إرسال رابط مع الفيديو. يرفض publish_facebook_post رابطًا بجانب ملف؛ اكتب الرابط داخل نص الرسالة بدلًا من ذلك.
تستطيع منصتك فعل الشيء نفسه عبر POST /channels/:id/posts في Partner API. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويقل السعر كلما أضفت اتصالات، مع أول 3 أيام مجانًا.
الأسئلة الشائعة
هل يمكنني رفع فيديو من حاسوبي إلى صفحة فيسبوك عبر API؟
نعم، عبر Resumable Upload API لدى Meta، الذي يعيد مقبضًا لـ /{page-id}/videos، أو عبر الرفع المجزّأ على الحافة نفسها. أما publish_facebook_post فيأخذ رابط HTTPS عامًا بدلًا من ذلك، لذا استضف الملف أولًا.
هل يمكن رفع فيديو دون أن يظهر في خلاصة الصفحة؟
نعم. ضبط published على false يحجز المنشور، وno_story يمنع قصة الخلاصة والجدول الزمني، وsecret يُبقي الفيديو بعيدًا عن فيسبوك وخارج نتائج البحث.
هل يمكن نشر فيديو واحد على عدة صفحات؟
نعم، عبر crossposting: يمكن إرسال فيديو منشور إلى صفحات أخرى يديرها الشخص دون رفعه من جديد، ويحصل على معرّف فيديو خاص به في كل صفحة.
كم تكلفة easyCoexistence لصفحة فيسبوك؟
من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، يحدده إجمالي عدد اتصالاتك، مع أول 3 أيام مجانًا. تمثل كل صفحة اتصالًا واحدًا.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في