لحذف عنصر قائمة تشغيل.
تأثير الحصة: تحتوي إحدى المكالمات إلى هذه الطريقة على تكلفة حصة تبلغ 50 وحدة.
حالات الاستخدام الشائعة
الطلب
طلب HTTP
DELETE https://www.googleapis.com/youtube/v3/playlistItems
التفويض
يتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات عن المصادقة والترخيص).
| النطاق |
|---|
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).
الأخطاء
يحدّد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات استجابةً لطلب بيانات إلى هذه الطريقة. يُرجى الاطّلاع على وثائق رسالة الخطأ للحصول على مزيد من التفاصيل.
| نوع الخطأ | تفاصيل الخطأ | الوصف |
|---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
الطلب غير مصرح له بحذف عنصر قائمة التشغيل المحدد بشكل صحيح. |
notFound (404) |
playlistItemNotFound |
يتعذّر العثور على عنصر قائمة التشغيل المحدّد باستخدام مَعلمة id الخاصة بالطلب. |
invalidValue (400) |
playlistOperationUnsupported |
لا تتيح واجهة برمجة التطبيقات إمكانية حذف الفيديوهات من قائمة التشغيل المحددة. على سبيل المثال، لا يمكنك حذف فيديو من قائمة تشغيل الفيديوهات التي حمّلتها. |
تجربة
يمكنك استخدام APIs Explorer لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.