واجهة برمجة التطبيقات (API) لـ Facebook Reels: نشر Reels إلى صفحة
تنشر واجهة Facebook Reels API مقطع Reel إلى صفحة في ثلاث خطوات: يعيد الاستدعاء POST /{page-id}/video_reels مع upload_phase بقيمة start معرّف video_id، ثم يُرفع الفيديو إلى rupload.facebook.com، ثم يُنشر الاستدعاء POST /{page-id}/video_reels مع upload_phase بقيمة finish وvideo_state بقيمة PUBLISHED. مواصفات Meta هي فيديو بنسبة 9:16 ومدة من 3 إلى 90 ثانية، ويمكن لأي صفحة نشر 30 Reel عبر API خلال 24 ساعة.
ينشر easyCoexistence الفيديوهات على صفحة Facebook كمنشورات فيديو عادية عبر publish_facebook_post، من Claude أو ChatGPT أو كودك الخاص، إلى جانب النصوص والروابط والصور.
عدد Reels المنشورة عبر API لكل صفحة ضمن فترة متحركة مدتها 24 ساعة، ويُطبَّق على POST /{page_id}/video_reels.
مدة Reel التي تقبلها Meta؛ لا يمكن أن تتجاوز مدة Reel المنشور كقصة على صفحة 60 ثانية.
الحد الأدنى لدقة Reel؛ توصي Meta بدقة 1080 x 1920 بكسل بنسبة عرض إلى ارتفاع 9 x 16.
أبعد وقت يمكن أن تضبطه scheduled_publish_time لمقطع Reel، لا يقل عن 10 دقائق من الآن، مع video_state بقيمة SCHEDULED.
رمز الخطأ الخاص بـ Reel لا تدعم Facebook مدته؛ يجب أن تتراوح مدة Reels بين 3 و90 ثانية.
كيف تنشر واجهة Reels API مقطع Reel؟
على ثلاث خطوات عبر مضيفين. تذهب استدعاءات البدء والإنهاء إلى المسار video_reels الخاص بالصفحة على graph.facebook.com، بينما يُرفع الفيديو نفسه إلى rupload.facebook.com، على عنوان upload_url الذي يعيده استدعاء البدء. يتحقق فحص الحالة على معرّف الفيديو بين الرفع والإنهاء مما إذا كانت Meta قد استلمت الملف كاملاً وعالجته.
ما الفيديو الذي يحتاجه Reel؟
تنشر Meta مواصفات Reels في دليل Reels Publishing، وأي رفع لا يطابقها في نسبة العرض إلى الارتفاع أو الدقة أو المدة أو معدل الإطارات يُرفض برمز خطأ خاص به. يجب أن يبقى Reel المخصص لقصة على الصفحة ضمن 60 ثانية أيضاً.
كيف يُرفع الفيديو؟
بطلب POST إلى upload_url على rupload.facebook.com، يحمل رمز الوصول (token) للصفحة في ترويسة Authorization: OAuth. الملف الموجود على جهازك يُرسل كجسم الطلب، مع ترويسة offset بقيمة 0 وترويسة file_size بقيمة حجمه بالبايت. أما الملف المتاح على الإنترنت فيُرسل بترويسة file_url بدلاً من ذلك، وتجلبه Meta بنفسها؛ ويعيد الرفع الناجح القيمة success بقيمة true.
- تقبل
file_urlعناوين http أو https؛ ولا تُدعم العناوين التي تتطلب مصادقة. - يجب أن يسمح المضيف للعميل facebookexternalhit/1.1 بجلب الملف، لأن Meta ترفض الملفات على المواقع التي تحظره في robots.txt.
- تُرفض الملفات الموجودة على خوادم Meta نفسها، مثل روابط fbcdn؛ وتوصي Meta بالنشر المتقاطع لإعادة استخدام الفيديو على صفحة أخرى.
# <UPLOAD_URL> is the upload_url the start call returned
curl -X POST "<UPLOAD_URL>" \
-H "Authorization: OAuth <PAGE_ACCESS_TOKEN>" \
-H "file_url: https://example.com/reel.mp4"كيف تفحص حالة Reel؟
بالطلب GET /{video-id}?fields=status على graph.facebook.com. تحتوي الإجابة على video_status، وتكون قيمته uploading أو upload_complete أو processing أو ready أو upload_failed أو expired أو error، وكائناً لكل مرحلة: uploading_phase مع bytes_transfered، وprocessing_phase مع أي رسالة خطأ، وpublishing_phase مع publish_status (draft أو scheduled أو published أو error) وpublish_time. وحالة كل مرحلة هي not_started أو in_progress أو completed أو error.
كيف يُستأنف رفع توقف؟
بإرسال طلب الرفع من جديد مع ترويسة offset بقيمة uploading_phase.bytes_transfered من فحص الحالة، أي البايتات التي تملكها Meta مسبقاً. الإزاحة التي لا تقبلها Meta تُعيد OffsetInvalidError، وجسم لا يطابق طول الملف يُعيد PartialRequestError، وإذا لم تنجح إعادة الرفع فنصيحة Meta هي البدء من الخطوة الأولى.
ماذا يتضمن استدعاء الإنهاء؟
معرّف video_id من استدعاء البدء، وupload_phase بقيمة finish، وvideo_state بقيمة PUBLISHED أو DRAFT أو SCHEDULED. يحمل description النص ويدعم الوسوم، أما title وplace لتحديد موقع الصفحة وis_ai_generated، الذي يُفصح عن أن Reel أُنشئ أو عُدّل بالذكاء الاصطناعي، فاختيارية. ويضيف Reel المجدول scheduled_publish_time، وهو طابع زمني UNIX يكون أكثر من 10 دقائق وفي غضون 29 يوماً قادمة. تجيب Meta بالقيمة success بقيمة true.
كم عدد Reels التي يمكن لصفحة نشرها عبر API؟
30 ضمن فترة متحركة مدتها 24 ساعة. تُطبّق Meta الحد على POST /{page_id}/video_reels عند نشر Reel، وتوصي التطبيقات بتطبيقه بنفسها أيضاً، خصوصاً التطبيقات التي تتيح للناس جدولة المنشورات لاحقاً. ولدعوات المتعاونين حد خاص بها، 10 لكل صفحة في 24 ساعة، ويذكر مرجع video_reels الخطأ 613: تجاوزت الاستدعاءات لهذه API حد المعدل.
ما الأذونات ومهمة الصفحة التي يحتاجها؟
رمز وصول للصفحة من شخص يستطيع تنفيذ مهمة CREATE_CONTENT على الصفحة، مع منح pages_show_list وpages_read_engagement وpages_manage_posts عبر Facebook Login. وتطلب Meta من التطبيقات أيضاً أن تُظهر للشخص إفصاحاً عن كيفية استخدام Reels على Facebook، مع خيارات للتحكم فيه، وألا تقدم سوى جمهور Public، لأن النشر على صفحة يحمل نطاقاً عاماً ضمنياً.
ما الأخطاء التي تعيدها Reels API؟
الرمز 100 يعني أن معلمة مطلوبة مفقودة، مثل upload_phase، وتسرد رسالة Meta المعلمات المفقودة. وترفض أربعة رموز أخرى فيديو يخرج عن المواصفات:
- 1363040: نسبة العرض إلى الارتفاع غير مدعومة؛ يجب أن تكون الفيديوهات بين 16x9 و9x16.
- 1363127: الدقة غير مدعومة؛ والحد الأدنى هو 540 x 960 بكسل.
- 1363128: المدة غير مدعومة؛ تتراوح مدة Reels بين 3 و90 ثانية.
- 1363129: متوسط معدل الإطارات غير مدعوم؛ تحتاج Reels إلى 24 إلى 60 إطاراً في الثانية.
كيف تسرد Reels صفحة؟
بالطلب GET /{page-id}/video_reels، الذي يعيد Reels المنشورة للصفحة مع معرّفاتها وتواريخ تحديثها وأوصافها. تقصر since وuntil القائمة على تواريخ تُعطى كـ today أو yesterday أو طابع زمني UNIX أو yyyy-mm-dd، مع أن يكون until لاحقاً لـ since. ويشير مرجع الخلاصة في Meta إلى هذه النقطة لمقاطع Reels المنشورة على صفحة.
كيف تنشر Reel عبر easyCoexistence؟
ليس كـ Reel حاليًا. ترسل publish_facebook_post الفيديوهات إلى المسار videos الخاص بالصفحة، كمنشورات فيديو عادية، ولا توجد في easyCoexistence أداة لاستدعاءات video_reels؛ ولا تُسلَّم رموز الصفحات، لذا لا يمكن تنفيذ الخطوات الثلاث من كودك الخاص عبر اتصاله أيضًا. انشر الـ Reel من Facebook أو Meta Business Suite، أو انشر الفيديو كمنشور فيديو عادي.
الأخطاء الشائعة
- إرسال الرفع إلى graph.facebook.com. يُرسل الفيديو إلى rupload.facebook.com بترويسة Authorization: OAuth، أما استدعاءات البدء والإنهاء والحالة فقط فتستخدم graph.facebook.com.
- استضافة الملف في مكان لا تستطيع Meta جلبه منه. يُرفض file_url الذي يتطلب تسجيل دخول، أو الموجود على موقع يحظر facebookexternalhit/1.1 في robots.txt، أو على fbcdn.
- البدء من جديد بعد رفع متوقف. اقرأ الحالة أولاً: uploading_phase.bytes_transfered هي الإزاحة التي يُستأنف منها، والجلسة الجديدة هي الملاذ الأخير.
- جدولة أكثر من 30 Reel لصفحة واحدة في يوم. تحسب Meta Reels المنشورة عبر API ضمن فترة متحركة مدتها 24 ساعة، فوزّع المجدولة منها.
ولا توجد لديه أداة لـ Reels API، لذا يُنشر الـ Reel من Facebook أو Meta Business Suite. من US$ 9 لكل رقم متصل شهرياً، ينخفض إلى US$ 0.75 مع إضافة الأرقام، مع فترة تجريبية مجانية من 3 أيام.
الأسئلة الشائعة
هل يمكن نشر Reel على ملف Facebook شخصي أو مجموعة عبر API؟
لا. تنشر Reels Publishing API من Meta مقاطع Reels إلى صفحات Facebook فقط، وتنشرها بالنشر المتقاطع إلى صفحات أخرى فقط.
هل ينشر publish_facebook_post مقاطع Reels؟
لا. ينشر النصوص والروابط والصور والفيديوهات إلى الصفحة. أما Reel فيحتاج استدعاءات video_reels، التي لا تجريها أدوات easyCoexistence.
كيف أفحص Reel لمطابقات حقوق النشر؟
اقرأ GET /{video-id}?fields=copyright_check_information مع pages_read_engagement. تُجري Meta الفحص عند الرفع وقد يستغرق بضع دقائق، ولا يرى المطابقات إلا المالك.
هل يمكن لصفحة أخرى نشر Reel الخاص بي أيضاً؟
نعم، بصفتها متعاوناً. يرسل POST /{video-id}/collaborators مع target_id بقيمة معرّف صفحتهم دعوة، وبعد قبولها يظهر Reel على صفحتهم أيضاً.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في