PlaylistItems: delete

حذف عنصر من قائمة التشغيل.

التأثير على الحصة: إنّ استدعاء هذه الطريقة له تكلفة حصة قدرها 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 لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة له.