نشر Reels على Instagram عبر واجهة برمجة التطبيقات (API)
تنشر واجهة API الخاصة بـ Instagram مقطع Reel من ملف MOV أو MP4 متاح عبر عنوان URL عام: تنشئ حاوية مع media_type بقيمة REELS، وتنتظر حتى تعالج Meta الفيديو، ثم تنشره. يتراوح طول Reel بين 3 ثوانٍ و15 دقيقة، وبحجم يصل إلى 300 ميغابايت، وتوصي Meta بإطار بنسبة 9:16 لتفادي القص أو المساحات الفارغة.
تنشر easyCoexistence مقاطع Reels عبر publish_instagram_post من Claude أو ChatGPT أو من شيفرتك الخاصة: أعطها عنوان URL للفيديو والتعليق، وبينما يكون الفيديو قيد المعالجة تُكمل النشر من تلقاء نفسها.
أطول Reel تنشره واجهة API، والأقصر مدته 3 ثوانٍ.
أكبر ملف Reel، بصيغة MOV أو MP4 مع فيديو H.264 أو HEVC وصوت AAC.
الفاصل الذي تقترح Meta عنده التحقق من حالة حاوية قيد المعالجة، لمدة لا تتجاوز 5 دقائق.
المدة التي يمكن أن تبقى فيها حاوية Reel دون نشر قبل انتهاء صلاحيتها.
كيف يُنشر Reel؟
يتم ذلك على ثلاث خطوات. أولًا، أرسل POST /<IG_ID>/media مع ضبط media_type على REELS، و video_url يشير إلى الملف، ومع تعليق (caption) إن أردت؛ تجلب Meta الفيديو وتعيد معرّف الحاوية (container ID). ثانيًا، انتظر أثناء معالجة Instagram للفيديو، مع التحقق من status_code للحاوية. ثالثًا، أرسل POST /<IG_ID>/media_publish مع creation_id يساوي معرّف الحاوية، فتحمل الاستجابة معرّف الوسائط الجديد.
توثّق Meta الرفع القابل للاستئناف، الذي يمكنه إرسال ملف من جهاز كمبيوتر، للإعدادات المبنية على Facebook Login for Business فقط، بما فيها Unified Login. مع Instagram Login يأتي الفيديو دائمًا من عنوان URL عام.
ما متطلبات الفيديو؟
مواصفات Meta للـ Reels، وهي شروط يجب أن يستوفيها الملف قبل أن تعالجه Instagram:
- الصيغة: MOV أو MP4 (MPEG-4 Part 14)، دون قوائم تحرير، مع وضع الذرة moov في بداية الملف.
- الفيديو: H.264 أو HEVC، بمسح تدريجي، وGOP مغلق، وأخذ عينات الكروما 4:2:0، وبمعدل 23 إلى 60 إطارًا في الثانية، وبعرض يصل إلى 1920 بكسل ومعدل 25 Mbps.
- الصوت: AAC، حتى 48 kHz، أحادي أو ستيريو، بمعدل 128 kbps.
- نسبة العرض إلى الارتفاع: من 0.01:1 إلى 10:1، ويُوصى بالنسبة 9:16.
- الطول والحجم: من 3 ثوانٍ إلى 15 دقيقة، وحتى 300 ميغابايت.
ماذا يحدث أثناء معالجة الفيديو؟
تبقى قيمة status_code للحاوية IN_PROGRESS إلى أن تعالج Instagram الفيديو، ثم تصبح FINISHED، وعندها فقط يمكن نشره. النشر قبل ذلك يفشل بالرمز 9007 والرمز الفرعي 2207027، ويعني ذلك الانتظار لا الإصلاح. تقترح Meta التحقق من الحالة مرة كل دقيقة، لمدة لا تتجاوز 5 دقائق.
تعني ERROR أن الحاوية لم تُكمل المعالجة، وتعني EXPIRED أنها بقيت دون نشر لمدة 24 ساعة؛ وفي الحالتين تحتاج إلى حاوية جديدة. وتعني PUBLISHED أن Reel منشور بالفعل.
ما خيارات Reel التي تتيحها واجهة API؟
إضافةً إلى الفيديو والتعليق، تقبل حاوية Reel في Meta هذه المعاملات:
share_to_feed: القيمة true تُظهر Reel في Feed إلى جانب تبويب Reels، أما false فتُبقيه في تبويب Reels فقط. ولا تضمن أي من القيمتين مكانًا في تبويب Reels.cover_url: صورة JPEG بحجم يصل إلى 8 ميغابايت، تُستخدم غلافًا في تبويب Reels، وتُقص إلى منتصف الإطار بنسبة 9:16، وإلى مربع عند المشاركة في Feed.thumb_offset: الإطار بالمللي ثانية الذي يُستخدم صورةً مصغّرة عند غياب الغلاف؛ القيمة 0 تعني الإطار الأول.audio_name: اسم لصوت Reel، ولا يمكن تعيينه إلا مرة واحدة.trial_params: ينشر Reel تجريبيًا، ولا يُعرض إلا على من لا يتابعون الحساب، إلى أن يُعتمد نهائيًا.
ما القواعد الأخرى التي تنطبق على Reel؟
تنطبق بعض القواعد على Reel منذ لحظة إنشاء حاويته:
- لا يمكن أن يكون Reel عنصرًا في ألبوم، إذ يُنشر دائمًا وحده.
- تنطبق إعدادات الخصوصية للحساب عند النشر: إذا كان Allow remixing مفعّلًا، يسمح Reel الجديد بإعادة المزج أيضًا.
- وسم الموسيقى متاح للصوت الأصلي فقط.
- عند قراءته لاحقًا، يُبلغ Reel عن
media_typeبالقيمة VIDEO، مثل أي فيديو آخر. - يُحتسب منشورًا واحدًا من حد 100 منشور نُشرت عبر API خلال 24 ساعة للحساب.
ما المقاييس التي يعرضها Reel؟
عبر نقطة النهاية الخاصة برؤى الوسائط (media insights endpoint)، يعرض Reel مقاييس الوصول والمشاهدات والإعجابات والتعليقات والحفظ والمشاركات، إضافةً إلى total_interactions وreposts. ويعرض ثلاثة مقاييس خاصة به: ig_reels_avg_watch_time وig_reels_video_view_total_time وreels_skip_rate، وهو النسبة المئوية للمشاهدات التي تُخطّيت خلال أول 3 ثوانٍ. وتُحتسب الإعجابات والتعليقات والمشاهدات للنشاط العضوي فقط، وقد تتأخر البيانات خلفها حتى 48 ساعة.
الأخطاء الشائعة
- نشر الحاوية فور إنشائها. انتظر حتى تصبح قيمة status_code هي FINISHED، وإلا فشل الطلب بالرمز الفرعي 2207027.
- إرسال ملف WebM أو AVI. يجب أن يكون Reel بصيغة MOV أو MP4، وإلا رفضته Meta بالرمز 352 والرمز الفرعي 2207026.
- توقّع أن يضع share_to_feed مقطع Reel في تبويب Reels. إنه يضيفه إلى Feed فقط، وتقرر Instagram ما يعرضه تبويب Reels.
- ترك حاوية دون نشر طوال الليل. تنتهي صلاحيتها بعد 24 ساعة من إنشائها، وعندها يلزم إنشاء حاوية جديدة.
ويمكن أيضًا جدولة Reels من قائمة انتظارها الخاصة. السعر من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، وينخفض كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
ما المدة التي يمكن أن يكون عليها Reel عبر API؟
من 3 ثوانٍ حتى 15 دقيقة، كملف MOV أو MP4 لا يتجاوز حجمه 300 ميغابايت.
هل يمكنني رفع Reel من جهاز الكمبيوتر؟
لا مع Instagram Login. تجلب API الفيديو من عنوان URL عام، لذا ضع الملف في مكان يمنحه رابطًا عامًا أولًا.
هل يظهر Reel المنشور عبر API في Feed أيضًا؟
يمكن ذلك. يحدد المعامل share_to_feed ما إذا كان Reel سيظهر في Feed إلى جانب تبويب Reels.
لماذا يفشل نشر Reel بالرمز 9007؟
لأن Instagram ما زالت تعالج الفيديو. تحقق من status_code للحاوية وانشر حين تصبح قيمته FINISHED، فلا يحتاج الطلب نفسه إلى أي إصلاح.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في