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