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