پیام گپ را حذف می‌کند. درخواست API باید توسط مالک کانال یا یک مدیر گپ زنده مرتبط با ممنوعیت مجاز شود.
تأثیر بر سهمیه: تماس با این روش هزینه سهمیه ۲۰ واحدی دارد.
موارد استفاده رایج
درخواست
درخواست HTTP
DELETE https://www.googleapis.com/youtube/v3/liveChat/messages
صدور مجوز
این درخواست به مجوز با حداقل یکی از دامنه‌های زیر نیاز دارد (درباره اصالت‌سنجی و مجوز بیشتر بخوانید).
| حوزه |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
پارامترها
جدول زیر پارامترهایی را که این پُرسمان پشتیبانی می‌کند فهرست می‌کند. همه پارامترهای فهرست‌شده پارامترهای پُرسمان هستند.
| پارامترها | ||
|---|---|---|
| پارامترهای الزامی | ||
id |
stringپارامتر id شناسه پیام گپ YouTube منبعی را که درحال حذف شدن است مشخص می‌کند. |
|
متن درخواست
هنگام فراخوانی این روش، بدنه درخواست ارائه نکنید.
پاسخ
درصورت موفقیت، این روش کد پاسخ HTTP 204 (No Content) را برمی‌گرداند.
خطاها
جدول زیر پیام‌های خطایی را که ممکن است «میانای برنامه‌سازی کاربردی» در پاسخ به فراخوانی این روش برگرداند مشخص می‌کند. برای جزئیات بیشتر، مستندات پیام خطا را ببینید.
| نوع خطا | جزئیات خطا | شرح |
|---|---|---|
forbidden (403) |
forbidden |
اجازه‌های لازم برای حذف پیام مشخص‌شده را ندارید. |
forbidden (403) |
modificationNotAllowed |
منبع liveChatMessage مشخص‌شده را نمی‌توان حذف کرد. پارامتر id ممکن است پیامی را شناسایی کند که توسط یک مدیر یا کاربر دیگری ایجاد شده است و پیام‌های او قابل حذف نیستند. |
notFound (404) |
liveChatMessageNotFound |
پیامی که می‌خواهید حذف کنید پیدا نشد. مقدار پارامتر id را بررسی کنید تا مطمئن شوید درست است. |
امتحان کنید!
برای فراخوانی این API و دیدن درخواست و پاسخ API، از APIs Explorer استفاده کنید.