این روش منسوخ شده است و دیگر پشتیبانی نمی شود.
نظر تماس گیرنده را بیان می کند که یک یا چند نظر باید به عنوان هرزنامه علامت گذاری شوند.
تاثیر سهمیه ای: فراخوانی به این روش هزینه سهمیه ای 50 واحدی دارد.
موارد استفاده رایج
درخواست
درخواست HTTP
POST https://www.googleapis.com/youtube/v3/comments/markAsSpam
مجوز
این درخواست به مجوز حداقل با یکی از حوزه های زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).
| محدوده |
|---|
https://www.googleapis.com/auth/youtube.force-ssl |
مولفه های
جدول زیر پارامترهایی را که این کوئری پشتیبانی می کند فهرست می کند. تمام پارامترهای لیست شده پارامترهای پرس و جو هستند.
| مولفه های | ||
|---|---|---|
| پارامترهای مورد نیاز | ||
id | stringپارامتر id فهرستی از شناسه‌های نظرات جدا شده با کاما را مشخص می‌کند که تماس‌گیرنده معتقد است باید به عنوان هرزنامه طبقه‌بندی شوند. | |
درخواست بدن
هنگام فراخوانی این روش، بدنه درخواست ارائه نکنید.
واکنش
در صورت موفقیت آمیز بودن، این روش کد پاسخ HTTP 204 ( No Content ) را برمی گرداند.
خطاها
جدول زیر پیام های خطایی را مشخص می کند که API می تواند در پاسخ به تماس با این روش بازگرداند. لطفاً برای جزئیات بیشتر به مستندات پیام خطا مراجعه کنید.
| نوع خطا | جزئیات خطا | شرح |
|---|---|---|
badRequest (400) | operationNotSupported | نظراتی که بر اساس +Google نیستند نمی توانند به عنوان هرزنامه علامت گذاری شوند. |
badRequest (400) | processingFailure | سرور API نتوانست درخواست را با موفقیت پردازش کند. در حالی که این می تواند یک خطای گذرا باشد، معمولاً نشان می دهد که ورودی درخواست نامعتبر است. |
forbidden (403) | forbidden | یک یا چند نظر نمی توانند به عنوان هرزنامه علامت گذاری شوند زیرا مجوزهای کافی وجود ندارد. ممکن است درخواست به درستی مجاز نباشد. |
notFound (404) | commentNotFound | یک یا چند مورد از نظراتی که درخواست سعی در به روز رسانی آنها دارد، یافت نشد. مقادیر موجود در پارامتر id درخواست را بررسی کنید تا مطمئن شوید که درست هستند. |
آن را امتحان کنید!
از APIs Explorer برای فراخوانی این API و مشاهده درخواست و پاسخ API استفاده کنید.