تطبيق إجراء على ما يصل إلى 100 فيديو

تدعم هذه العملية مصادقة ملف ارتباط جلسة لوحة التحكم. استدعها من شيفرة خادم موثوقة فقط، ولا تنشئ المتصفحات ملف الجلسة أو تكشفه.

ينفّذ delete أو set_visibility على 1–100 معرّف ويعيد نتيجة لكل معرّف حتى عند فشل بعض العناصر. يحذف delete مثل المسار الفردي ويصدر video.deleted، وتُدمج المعرّفات المكررة. تُعاد video_not_found للمعرّفات غير المرئية وupload_completion_in_progress عند سباق الإكمال. وعند delete، يُبلّغ العنصر الذي يصادف فشلًا بنيويًا غير متوقع بالرمز internal_error وتتوقف المعالجة عنده، فيُبلّغ كل معرّف بعده بالرمز not_attempted. والطلب بأكمله آمن للتكرار فتُعاد معالجة المعرّف المتوقّف والمعرّفات غير المُعالجة عند إعادة الطلب. يحتاج المفتاح إلى write.

حد المعدّل: 30 طلبًا لكل 60 ثانية لكل مستدعٍ.

رموز الخطأ: unauthorized (401), insufficient_scope (403), account_not_approved (403), invalid_project_id (400), not_found (404), invalid_body (400).

المصادقة

• apiKey — مفتاح المشروع في ترويسة Authorization: Bearer بصيغة vh_live_... للوضع الفعلي أو vh_test_... للوضع التجريبي، ويحمل صلاحية read و/أو write.
• sessionCookie — ملف ارتباط جلسة لوحة التحكم الذي يضبطه POST /v1/auth/login. تتطلب مسارات الفيديو والتشغيل أيضًا معامل projectId عند استخدام الجلسة.

المعاملات

جسم الطلب

إلزامي

نوع المحتوى: application/json

المخطّط: VideoBulkRequest

الاستجابات

جرّبها