تحذف هذه الأداة فيديو على YouTube.
التأثير في الحصة: يتطلّب طلب هذه الطريقة تكلفة حصة تبلغ 50 وحدة.
حالات الاستخدام الشائعة
طلب
طلب HTTP
DELETE https://www.googleapis.com/youtube/v3/videos
التفويض
يتطلّب هذا الطلب الحصول على إذن باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات حول المصادقة ومنح الإذن).
| النطاق |
|---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
المعلمات
يعرض الجدول التالي المَعلمات التي يتيحها هذا الطلب. جميع المَعلمات المدرَجة هي مَعلمات طلب البحث.
| المعلمات | ||
|---|---|---|
| المَعلمات المطلوبة | ||
id |
stringتحدّد المَعلمة id معرّف الفيديو على YouTube للمرجع الذي يتم حذفه. في مورد video، تحدّد السمة id معرّف الفيديو. |
|
| المَعلمات الاختيارية | ||
onBehalfOfContentOwner |
stringلا يمكن استخدام هذه المَعلمة إلا في طلب مصرَّح به بشكل صحيح. ملاحظة: هذه المَعلمة مخصّصة حصريًا لشركاء المحتوى في YouTube. تشير المَعلمة onBehalfOfContentOwner إلى أنّ بيانات اعتماد التفويض الخاصة بالطلب تحدّد مستخدمًا لنظام إدارة محتوى YouTube يتصرّف نيابةً عن مالك المحتوى المحدّد في قيمة المَعلمة. هذه المَعلمة مخصّصة لشركاء المحتوى في YouTube الذين يملكون ويديرون العديد من قنوات على YouTube المختلفة. تتيح هذه الميزة لمالكي المحتوى المصادقة مرة واحدة والوصول إلى جميع بيانات الفيديوهات والقنوات، بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة على حدة. يجب ربط حساب نظام إدارة المحتوى الفعلي الذي يصادق عليه المستخدم بمالك المحتوى المحدّد على YouTube. |
|
نص الطلب
لا تقدِّم نص الطلب عند استدعاء هذه الطريقة.
الردّ
في حال نجاح هذه الطريقة، ستعرض رمز استجابة HTTP 204 (No Content).
الأخطاء
يحدّد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات استجابةً لطلب هذه الطريقة. يُرجى الاطّلاع على مستندات رسائل الخطأ لمزيد من التفاصيل.
| نوع الخطأ | تفاصيل الخطأ | الوصف |
|---|---|---|
forbidden (403) |
forbidden |
لا يمكن حذف الفيديو الذي تحاول حذفه. قد لا يكون الطلب مصرّحًا به بشكل صحيح. |
notFound (404) |
videoNotFound |
تعذّر العثور على الفيديو الذي تحاول حذفه. تحقَّق من قيمة المَعلمة id للطلب للتأكّد من صحتها. |
جرِّبها الآن.
استخدِم APIs Explorer لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة.