موردی را از فهرست پخش حذف می‌کند.
تأثیر سهمیه: فراخوانی این روش هزینه سهمیه ۵۰ واحدی دارد.
موارد استفاده رایج
درخواست
درخواست 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 برای فراخوانی این API و دیدن درخواست و پاسخ API استفاده کنید.