Captions: delete

لحذف مسار ترجمة وشرح محدّد

تأثير الحصة: تبلغ تكلفة الحصة لمكالمة هذه الطريقة 50 وحدة.

حالات الاستخدام الشائعة

الطلب

طلب HTTP

DELETE https://www.googleapis.com/youtube/v3/captions

التفويض

يتطلب هذا الطلب تفويضًا بنطاق واحد على الأقل من النطاقات التالية. للاطّلاع على مزيد من المعلومات عن المصادقة والتفويض، يُرجى الاطّلاع على مقالة تنفيذ التفويض باستخدام بروتوكول OAuth 2.0.

النطاق
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtubepartner

المعلمات

يعرض الجدول التالي المَعلمات التي يتيح طلب البحث استخدامها. جميع المَعلمات المُدرَجة هي مَعلمات طلب بحث.

المعلمات
المَعلمات المطلوبة
id string
تُحدِّد المَعلمة id مسار الترجمة والشرح الذي يتم حذفه. القيمة هي معرّف مقطع ترجمة وشرح كما حدّدته السمة id في مورد caption.
المَعلمات الاختيارية
onBehalfOfContentOwner string
لا يمكن استخدام هذه المَعلمة إلا في طلب مفوَّض بشكل صحيح.

ملاحظة: هذه المَعلمة مخصّصة حصريًا لشركاء المحتوى في YouTube.

تشير المَعلمة onBehalfOfContentOwner إلى أنّ بيانات اعتماد التفويض للطلب تحدّد مستخدمًا في نظام إدارة المحتوى في YouTube يتصرّف نيابةً عن مالك المحتوى المحدّد في قيمة المَعلمة. هذه المَعلمة مخصّصة لشركاء المحتوى على YouTube الذين يملكون ويديرون العديد من القنوات المختلفة على YouTube. تتيح هذه الميزة لمالكي المحتوى المصادقة مرة واحدة والوصول إلى جميع بيانات الفيديوهات والقنوات الخاصة بهم، بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة على حدة. يجب أن يكون حساب نظام إدارة المحتوى (CMS) الفعلي الذي يستخدمه المستخدم للمصادقة مرتبطًا بحساب مالك المحتوى المحدّد على YouTube.

نص الطلب

لا تقدِّم محتوى طلب عند استدعاء هذه الطريقة.

الردّ

في حال نجاح هذه الطريقة، يتم عرض رمز حالة HTTP 204 No Content.

الأخطاء

يحدِّد الجدول التالي رسائل الخطأ التي يمكن أن تعرِضها واجهة برمجة التطبيقات استجابةً لطلب موجَّه إلى هذه الطريقة. لمزيد من التفاصيل، يُرجى الاطّلاع على YouTube Data API - Errors (أخطاء واجهة برمجة التطبيقات لبيانات YouTube).

نوع الخطأ تفاصيل الخطأ الوصف
forbidden (403) forbidden الأذونات المرتبطة بالطلب غير كافية لحذف مسار الترجمة والشرح. قد لا يكون الطلب مفوَّضًا بشكل صحيح.
notFound (404) captionNotFound تعذّر العثور على مسار الترجمة والشرح. تحقّق من قيمة مَعلمة id في الطلب للتأكّد من صحتها.

جرّب الآن

استخدِم APIs Explorer للاتّصال بهذه الواجهة والاطّلاع على طلب البيانات والاستجابة من واجهة برمجة التطبيقات.