ممنوعیتی را که مانع از مشارکت یک کاربر خاص در یک چت زنده می‌شود، حذف می‌کند و در نتیجه کاربر را قادر می‌سازد دوباره به چت ملحق شود. درخواست API باید توسط مالک کانال یا ناظر چت زنده مرتبط با ممنوعیت مجاز باشد.
موارد استفاده رایج
درخواست
درخواست HTTP
DELETE https://www.googleapis.com/youtube/v3/liveChat/bans
مجوز
این درخواست به مجوز حداقل با یکی از حوزه های زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).
| محدوده |
|---|
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 استفاده کنید.