لحذف عنصر من قائمة تشغيل
تأثير الحصة: تبلغ تكلفة الحصة لمكالمة هذه الطريقة 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 - Errors.
| نوع الخطأ | تفاصيل الخطأ | الوصف |
|---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
الطلب غير مصرّح به بشكل صحيح لحذف عنصر قائمة التشغيل المحدّد. |
notFound (404) |
playlistItemNotFound |
تعذّر العثور على عنصر قائمة التشغيل الذي تم تحديده باستخدام المَعلمة id في الطلب. |
invalidValue (400) |
playlistOperationUnsupported |
لا تتيح واجهة برمجة التطبيقات إمكانية حذف الفيديوهات من قائمة التشغيل المحدّدة. على سبيل المثال، لا يمكنك حذف فيديو من قائمة تشغيل الفيديوهات التي حمّلتها. |
جرّب الآن
استخدِم APIs Explorer لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات والاستجابة.