یک مورد از لیست پخش را حذف می کند.
تاثیر سهمیه ای: فراخوانی به این روش هزینه سهمیه ای 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 Creator Studio پیوند داده شود. | |
درخواست بدن
هنگام فراخوانی این روش، بدنه درخواست ارائه نکنید.
پاسخ
در صورت موفقیت آمیز بودن، این روش کد وضعیت HTTP 204 No Content برمی گرداند.
خطاها
جدول زیر پیام های خطایی را مشخص می کند که API می تواند در پاسخ به تماس با این روش بازگرداند. برای جزئیات بیشتر، YouTube Data API - Errors را ببینید.
| نوع خطا | جزئیات خطا | توضیحات |
|---|---|---|
forbidden (403) | playlistItemsNotAccessible | درخواست به درستی مجاز به حذف آیتم لیست پخش مشخص شده نیست. |
notFound (404) | playlistItemNotFound | مورد لیست پخش شناسایی شده با پارامتر id درخواست یافت نمی شود. |
invalidValue (400) | playlistOperationUnsupported | API از توانایی حذف ویدیوها از لیست پخش مشخص شده پشتیبانی نمی کند. برای مثال، نمی‌توانید ویدیویی را از لیست پخش ویدیوهای آپلود شده خود حذف کنید. |
آن را امتحان کنید!
از APIs Explorer برای فراخوانی این API و مشاهده درخواست و پاسخ API استفاده کنید.
یک مورد از لیست پخش را حذف می کند.
تاثیر سهمیه ای: فراخوانی به این روش هزینه سهمیه ای 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 Creator Studio پیوند داده شود. | |
درخواست بدن
هنگام فراخوانی این روش، بدنه درخواست ارائه نکنید.
پاسخ
در صورت موفقیت آمیز بودن، این روش کد وضعیت HTTP 204 No Content برمی گرداند.
خطاها
جدول زیر پیام های خطایی را مشخص می کند که API می تواند در پاسخ به تماس با این روش بازگرداند. برای جزئیات بیشتر، YouTube Data API - Errors را ببینید.
| نوع خطا | جزئیات خطا | توضیحات |
|---|---|---|
forbidden (403) | playlistItemsNotAccessible | درخواست به درستی مجاز به حذف آیتم لیست پخش مشخص شده نیست. |
notFound (404) | playlistItemNotFound | مورد لیست پخش شناسایی شده با پارامتر id درخواست یافت نمی شود. |
invalidValue (400) | playlistOperationUnsupported | API از توانایی حذف ویدیوها از لیست پخش مشخص شده پشتیبانی نمی کند. برای مثال، نمی‌توانید ویدیویی را از لیست پخش ویدیوهای آپلود شده خود حذف کنید. |
آن را امتحان کنید!
از APIs Explorer برای فراخوانی این API و مشاهده درخواست و پاسخ API استفاده کنید.