واجهة برمجة نشر منشورات صفحات Facebook: نص وروابط وصور وفيديوهات
تنشر Graph API من Meta، وهي واجهة برمجة التطبيقات (API)، أربعة أنواع من منشورات الصفحة: النص والروابط عبر POST /{page-id}/feed، والصورة عبر /{page-id}/photos من عنوان URL موجود بالفعل على الإنترنت، والفيديو عبر /{page-id}/videos من عنوان URL لملف متاح. تظهر المنشورات بصوت الصفحة، وتحتاج إلى رمز الوصول (token) الخاص بالصفحة مع الصلاحية pages_manage_posts، ويمكن أن تبقى غير منشورة حتى موعد مجدول.
ينشر easyCoexistence على صفحات Facebook عبر publish_facebook_post من Claude أو ChatGPT أو من كودك الخاص: نص أو رابط أو صورة أو فيديو، الآن أو مجدولاً حتى 90 يوماً مقدماً من قائمة انتظار easyCoexistence، ويقرأ list_social_posts المنشورات.
أكبر حجم لملف صورة تقبله Meta لصفحة، وتوصي بإبقاء ملفات PNG دون 1 MB حتى لا تظهر الصور مشوشة.
أنواع ملفات الصور التي تدرجها Meta لصور الصفحة: JPEG، BMP، PNG، GIF، وTIFF.
رمز الخطأ عندما تتعذر على Meta جلب ملف الفيديو من عنوان URL المُعطى إلى /{page-id}/videos.
عدد المنشورات المنشورة المرتبة سنوياً التي تعيدها API عند قراءة خلاصة الصفحة، بحد أقصى 100 في كل طلب.
ما الذي يمكن أن يحمله منشور الصفحة؟
أربعة أنواع من المحتوى، عبر ثلاث حواف (edges) في الصفحة، وتظهر المنشورات بصوت الصفحة. يتشارك النص والروابط حافة /feed، حيث يجب توفر message أو link؛ ولكل من الصورة والفيديو حافته الخاصة:
كيف يختار publish_facebook_post الحافة؟
من خلال ما يُمرَّر إليه. إذا كان video_url موجوداً يُرسل إلى /videos مع message بوصفه الوصف؛ وإلا إذا كان image_url موجوداً يُرسل إلى /photos مع message بوصفه نصه؛ وإلا يُرسل message و link إلى /feed. لا يُرفق الرابط إلا مع منشور نصي، لذا عند وجود صورة أو فيديو ضع عنوان URL داخل message. بدون scheduled_at يُنشر المنشور فوراً، وتحمل النتيجة المعرّف post_id الذي أعادته Meta، ورابط المنشور url على Facebook. ومع scheduled_at يحتفظ easyCoexistence بالمنشور في قائمة انتظاره، من دقيقة واحدة إلى 90 يوماً مقدماً، وينشره في موعده.
أين يجب أن تكون الوسائط؟
في عنوان تستطيع Meta الوصول إليه، لأن Meta تجلب الملف بنفسها. بالنسبة للصورة، يكون url صورة مرفوعة بالفعل على الإنترنت؛ وبالنسبة للفيديو، يكون file_url عنوان URL متاحاً للملف، ويفشل الفيديو الذي لا تستطيع Meta جلبه بالخطأ 389. يفشل منشور الرابط عندما لا يستطيع التطبيق رؤية عنوان الرابط المُضمَّن، ويعني الخطأ 1609005 أن Meta لم تتمكن من استخراج البيانات من الرابط.
ما ملفات الصور التي تقبلها Meta؟
ملفات JPEG، BMP، PNG، GIF، وTIFF بحجم يصل إلى 10 MB، بحسب مرجع الصور لدى Meta، الذي يوصي بإبقاء ملفات PNG دون 1 MB لأن الملفات الأكبر قد تظهر مشوشة. تزيل Meta البيانات الوصفية للموقع من الصورة قبل النشر، وتعيد تحجيم الصور لتظهر بعدة أحجام. تفشل الصورة المفقودة أو غير الصالحة بالخطأ 324.
ماذا يحتاج منشور الفيديو؟
ملف تستطيع Meta تنزيله من file_url، ويُكتب نص المنشور في description، وقد تعرضه Meta مع المنشور. العنوان اختياري، ويتركه publish_facebook_post غير مُعيَّن. تنص نظرة عامة على Video API لدى Meta على أن الشخص صاحب الرمز ينبغي أن يكون قادراً على تنفيذ مهام تعادل صلاحيات المشرف على الصفحة، ويتولى Resumable Upload API الملفات الكبيرة، مستأنفاً الرفعات المتقطعة.
كيف تُقرأ المنشورات ويُعدّل عليها؟
يعيد list_social_posts أحدث منشورات الصفحة، وعددها 25 افتراضياً وحتى 100 في كل استدعاء، ولكل منها معرّفه ونصه ووقت إنشائه والرابط الدائم (permalink) وصورته. يحدد مرجع Meta قراءة الخلاصة بـ100 منشور في كل طلب، ويعيد نحو 600 منشور مرتّب في السنة. تعدّل API من Meta منشوراً عبر POST /{page-post-id} مع message الجديد، وذلك فقط للمنشورات التي أُنشئت بالتطبيق نفسه؛ ولا توجد أداة في easyCoexistence لذلك، لذا يُعدَّل المنشور على Facebook أو في Meta Business Suite.
الأخطاء الشائعة
- تمرير رابط مع صورة أو فيديو. يرفض publish_facebook_post الرابط إلى جانب الملف، لذا اكتب عنوان URL داخل message عندما يحتوي المنشور على وسائط.
- نشر المحتوى نفسه مرتين متتاليتين. ترفض Meta المنشورات المكررة المتتالية بالخطأ 506، لذا غيّر النص قبل المحاولة مرة أخرى.
- الإشارة إلى ملف خلف تسجيل دخول أو إلى رابط على وشك الانتهاء. تجلب Meta الصورة أو الفيديو من عنوان URL بنفسها، لذلك يجب أن يبقى العنوان عاماً حتى يُنشر المنشور.
من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ينخفض مع إضافة الاتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
هل يمكنني نشر صورة على صفحة Facebook من عنوان URL؟
نعم. يستقبل POST /{page-id}/photos المعامل url، وهو عنوان صورة موجودة بالفعل على الإنترنت، وتجلبها Meta بنفسها.
لماذا يفشل منشور صفحة Facebook بالخطأ 506؟
ترفض Meta المنشورات المكررة المتتالية بالخطأ 506، لذا غيّر النص قبل النشر مرة أخرى.
هل يمكن أن يحمل منشور Facebook واحد عدة صور؟
ليس عبر easyCoexistence: تقبل publish_facebook_post صورة واحدة. تُوثّق Meta المنشورات متعددة الصور، المبنية من صور مرفوعة دون نشر ومرفقة بمنشور في الخلاصة، وهو ما لا تغطيه أدواتها.
هل يمكنني تعديل منشور صفحة Facebook عبر API؟
نعم، عبر POST إلى معرّف المنشور، لكن فقط للمنشورات التي أُنشئت بالتطبيق نفسه. لا توجد أداة في easyCoexistence لذلك، لذا عدّل المنشور على Facebook أو في Meta Business Suite.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في