محرومیتی را که مانع مشارکت کاربر خاص در گپ مستقیم می‌شود برمی‌دارد و به این ترتیب کاربر می‌تواند دوباره به گپ بپیوندد. درخواست میانای برنامه‌سازی کاربردی باید توسط مالک کانال یا گرداننده گپ مستقیم مرتبط با ممنوعیت مجاز شود.
موارد استفاده رایج
درخواست
درخواست 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 را برمی‌گرداند.
خطاها
جدول زیر پیام‌های خطایی را که ممکن است «میانای برنامه‌سازی کاربردی» در پاسخ به فراخوانی این روش برگرداند مشخص می‌کند. برای جزئیات بیشتر، پیام خطا را ببینید.
| نوع خطا | جزئیات خطا | شرح |
|---|---|---|
forbidden (403) |
forbidden |
ممنوعیت مشخص‌شده برداشته نمی‌شود. این خطا ممکن است زمانی رخ دهد که درخواست توسط یک ناظر مجاز شده باشد که در تلاش است ممنوعیت ناظر دیگری را لغو کند. |
forbidden (403) |
insufficientPermissions |
اجازه‌های لازم را برای برداشتن ممنوعیت مشخص‌شده ندارید. |
invalidValue (400) |
invalidLiveChatBanId |
پارامتر id مقدار نامعتبری را مشخص می‌کند. |
notFound (404) |
liveChatBanNotFound |
ممنوعیت مشخص‌شده پیدا نشد. |
امتحان کنید!
برای فراخوانی این API و دیدن درخواست و پاسخ API، از APIs Explorer استفاده کنید.