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 Creator Studio پیوند داده شود.

درخواست بدن

هنگام فراخوانی این روش، بدنه درخواست ارائه نکنید.

واکنش

در صورت موفقیت آمیز بودن، این روش کد پاسخ HTTP 204 ( No Content ) را برمی گرداند.

خطاها

جدول زیر پیام های خطایی را مشخص می کند که API می تواند در پاسخ به تماس با این روش بازگرداند. لطفاً برای جزئیات بیشتر به مستندات پیام خطا مراجعه کنید.

نوع خطا جزئیات خطا شرح
forbidden (403) playlistItemsNotAccessible درخواست به درستی مجاز به حذف آیتم لیست پخش مشخص شده نیست.
notFound (404) playlistItemNotFound مورد لیست پخش شناسایی شده با پارامتر id درخواست یافت نمی شود.
invalidValue (400) playlistOperationUnsupported API از توانایی حذف ویدیوها از لیست پخش مشخص شده پشتیبانی نمی کند. برای مثال، نمی‌توانید ویدیویی را از لیست پخش ویدیوهای آپلود شده خود حذف کنید.

آن را امتحان کنید!

از APIs Explorer برای فراخوانی این API و مشاهده درخواست و پاسخ API استفاده کنید.