LiveChatBans: delete

ممنوعیتی را که مانع از مشارکت یک کاربر خاص در یک چت زنده می‌شود، حذف می‌کند و در نتیجه کاربر را قادر می‌سازد دوباره به چت ملحق شود. درخواست API باید توسط مالک کانال یا ناظر چت زنده مرتبط با ممنوعیت مجاز باشد.

موارد استفاده رایج

درخواست

درخواست HTTP

DELETE https://www.googleapis.com/youtube/v3/liveChat/bans

مجوز

این درخواست نیاز به مجوز با حداقل یکی از حوزه های زیر دارد. برای مطالعه بیشتر درباره احراز هویت و مجوز، به اجرای احراز هویت OAuth 2.0 مراجعه کنید.

محدوده
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

مولفه های

جدول زیر پارامترهایی را که این کوئری پشتیبانی می کند فهرست می کند. تمام پارامترهای لیست شده پارامترهای پرس و جو هستند.

مولفه های
پارامترهای مورد نیاز
id string
پارامتر id ممنوعیت چت برای حذف را مشخص می کند. مقدار به طور منحصربه‌فرد هم ممنوعیت و هم چت را مشخص می‌کند.

درخواست بدن

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

واکنش

در صورت موفقیت آمیز بودن، این روش کد وضعیت HTTP 204 No Content برمی گرداند.

خطاها

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

نوع خطا جزئیات خطا شرح
forbidden (403) forbidden ممنوعیت مشخص شده قابل حذف نیست. این خطا ممکن است در صورتی رخ دهد که درخواست توسط یکی از ناظران مجاز باشد که در حال تلاش برای حذف ممنوعیت مدیر دیگری است.
forbidden (403) insufficientPermissions شما مجوزهای لازم برای حذف ممنوعیت مشخص شده را ندارید.
invalidValue (400) invalidLiveChatBanId پارامتر id یک مقدار نامعتبر را مشخص می کند.
notFound (404) liveChatBanNotFound ممنوعیت مشخص شده یافت نمی شود.

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

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