Comments: delete

نظری را حذف می‌کند.

تأثیر سهمیه: فراخوانی این روش هزینه سهمیه ۵۰ واحدی دارد.

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

درخواست

درخواست HTTP

DELETE https://www.googleapis.com/youtube/v3/comments

صدور مجوز

این درخواست به مجوز با حداقل یکی از دامنه‌های زیر نیاز دارد (درباره اصالت‌سنجی و مجوز بیشتر بخوانید).

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

پارامترها

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

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

متن درخواست

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

پاسخ

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

خطاها

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

نوع خطا جزئیات خطا شرح
badRequest (400) processingFailure سرور «میانای برنامه‌سازی کاربردی» نتوانست درخواست را با موفقیت پردازش کند. اگرچه این خطا می‌تواند گذرا باشد، اما معمولاً نشان می‌دهد که ورودی درخواست نامعتبر است.
forbidden (403) forbidden نظر به‌دلیل کافی نبودن اجازه‌ها حذف نشد. ممکن است درخواست به‌درستی مجاز نشده باشد.
notFound (404) commentNotFound نظر مشخص‌شده پیدا نشد. مقدار پارامتر id درخواست را بررسی کنید تا مطمئن شوید درست است.

امتحان کنید!

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