دليل الفيديو
نشر الفيديو على YouTube و Instagram و Facebook و Threads
ارفع الفيديو مرة واحدة ثم أعِد منشوراً لكل وجهة. يغطي الدليل فحوص الوسائط وخيارات المنصات وخصوصية YouTube وفحص النشر الفعلي. روجع عقد النشر في 20 أكتوبر 2026.
اقرأ بصيغة Markdownراجعه فريق SosoAPI ·
1. إعداد أصل فيديو واحد جاهز
ارفع فيديو محلياً أواستورد URL فيديو عاماً إلى مساحة عملك. افحص الرفع أوالاستيراد حتى يصبح جاهزاً، ثم استخدم asset_id المسجّل و asset_url الأساسي في منشورك.
يفحص SosoAPI حاوية الفيديو ومدته وأبعاده وترميزه الفعلية حيث تتطلبها المنصة. لا يكفي اسم ملف أو MIME من المستدعي أومعاينة تعمل لإثبات الأهلية. افحص حقوق الفيديو والصوت والإفصاحات اللازمة قبل الجدولة.
- احتفظ بالفيديو الأصلي وأصول الغلاف في مساحة العمل المفوّضة نفسها.
- فحص أهلية المسودة الكاملة للحساب المحدد والصيغة المقصودة.
- إذا فشل الإعداد، افحص حالته الموجودة؛ لا تبدأ استيرادات مكررة لمجرد بطء الاستجابة.
2. اختيار صيغة الفيديو للوجهة
اختر الصيغة والخيارات التي يدعمها حساب الوجهة. يمكنك استخدام أصل جاهز مجدداً، لكن كل منصة تحتاج provider_payload خاصاً بها.
| الوجهة | اختيار provider_payload | المراجعة قبل الجدولة |
|---|---|---|
| platform: instagram؛ VIDEO أو REELS أو STORY_VIDEO حسب الحالة. | حساب احترافي وإمكانات مرصودة؛ تحتاج القصص إلى أهلية Business. يجب حصر خيارات Reels الخاصة في Reels. | |
| صفحة Facebook | platform: facebook؛ VIDEO أو REELS أو STORY_VIDEO حسب الحالة. | هوية الصفحة وإذن النشر ومهمة CREATE_CONTENT؛ وخيارات الوسائط والصيغ المدعومة. |
| Threads | platform: threads; VIDEO. | حساب نشر مؤهل وفيديو جاهز؛ المرفقات النصية فقط لا تنطبق على حمولة VIDEO. |
| قناة YouTube | platform: youtube; VIDEO. | عنوان وفئة وخصوصية ووضع إلغاء صريحة؛ وإذن إدارة للجدولة الأصلية لدى المنصة. |
3. جدولة فيديو YouTube تمت مراجعته
استخدم مساعد الخادم من مرجع API. استبدل asset_id بالعدد الصحيح الموجب المسجّل و asset_url برابطه الأساسي. اختر معرّف حساب القناة الفعلي ووقت نشر مستقبلياً.
يطلب المثال نشراً عاماً بالوقت المختار. أكّد الظهور مع المستخدم قبل التشغيل. اضبط contains_synthetic_media حسب الفيديو؛ false مثال فقط. يطلب UNSCHEDULE_KEEP_PRIVATE من YouTube إبقاء جدولة أصلية غير منشورة خاصةً إن أُلغيت.
await sosoPost("/studio-api/scheduled-posts/create", {
"workspace_id": "<workspace-uuid>",
"social_account_id": "<youtube-channel-account-uuid>",
"caption": null,
"hashtags": [],
"media": [
{
"kind": "video",
"asset_id": "<ready-video-asset-id>",
"url": "<canonical-video-asset-url>"
}
],
"provider_payload": {
"platform": "youtube",
"publish_options": {
"post_type": "VIDEO",
"title": "A reviewed product walkthrough",
"description": "Our team introduces the product in one short walkthrough.",
"category_id": "24",
"privacy_status": "public",
"cancellation_mode": "UNSCHEDULE_KEEP_PRIVATE",
"contains_synthetic_media": false
}
},
"scheduled_at": "<future-ISO-8601-instant-with-offset>",
"display_timezone": "Asia/Hong_Kong",
"idempotency_key": "<stable-key-for-this-one-video-intent>"
});4. إبقاء الخصوصية و Shorts وحدود مزوّد الخدمة واضحة
استخدم post_type VIDEO لـ YouTube. يمكنك ضبط surface_expectation: SHORT، لكن YouTube يقرر أهلية الرفع كـ Short. لا يكفي اسم الملف أوالاتجاه العمودي لإثبات ذلك.
إذن الرفع وإذن إدارة الجداول الأصلية منفصلان. افحص دعم القناة للميزات الاختيارية كالصور المصغرة؛ فقد يكون غير معروف. يشرح مرجع رفع Google متطلبات التفويض والبيانات الوصفية، ويفحص SosoAPI أيضاً حقوله المدعومة والحساب المتصل.
قد يستغرق YouTube وغيره معالجة الفيديو أومراجعته، وتظل حصصهم سارية. قبول الرفع لا يعني أن الفيديو مرئي للعامة.
5. التحقّق من النتيجة النهائية للمنشور نفسه
احفظ معرّف Scheduled Post وافحص تسليمه ونتيجته النهائية. افتح رابط المزوّد إن توفر. تعني scheduled أو publishing أن النتيجة النهائية معلّقة.
يستمر الجدول المقبول على الخادم إذا انقطع عميلك. اقرأ المنشور نفسه قبل أي تغيير. للإلغاء، استخدم إصداره الحالي وإجراء cancel متاحاً. حذف فيديو منشور بالفعل له قواعد أخرى.
افحص متطلبات كل وجهة عند استخدام فيديو عبر منصات متعددة. تعرض الأمثلة صيغ الطلبات؛ ولا تشغّل أوتنشر فيديو من هذه الصفحة.