فهرستی از دلایلی را که می توان برای گزارش ویدیوهای توهین آمیز استفاده کرد، بازیابی کنید.
تاثیر سهمیه ای: فراخوانی به این روش هزینه سهمیه ای 1 واحدی دارد.
موارد استفاده رایج
درخواست
درخواست HTTP
GET https://www.googleapis.com/youtube/v3/videoAbuseReportReasons
مجوز
این درخواست به مجوز حداقل با یکی از حوزه های زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).
محدوده |
---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
https://www.googleapis.com/auth/youtube.readonly |
مولفه های
جدول زیر پارامترهایی را که این کوئری پشتیبانی می کند فهرست می کند. تمام پارامترهای لیست شده پارامترهای پرس و جو هستند.
مولفه های | ||
---|---|---|
پارامترهای مورد نیاز | ||
part | string پارامتر part بخش های منبع videoAbuseReportReason را مشخص می کند که پاسخ API شامل آن خواهد شد. مقادیر پشتیبانی شده id و snippet هستند. | |
پارامترهای اختیاری | ||
hl | string پارامتر hl زبانی را مشخص می کند که باید برای مقادیر متن در پاسخ API استفاده شود. مقدار پیش فرض en_US است. |
درخواست بدن
هنگام فراخوانی این روش، بدنه درخواست ارائه نکنید.
واکنش
در صورت موفقیت آمیز بودن، این روش یک بدنه پاسخ با ساختار زیر را برمی گرداند:
{ "kind": "youtube#videoAbuseReportReasonListResponse", "etag": etag, "items": [ videoAbuseReportReason resource ] }
خواص
جدول زیر ویژگی های ظاهر شده در این منبع را تعریف می کند:
خواص | |
---|---|
kind | string نوع منبع API را مشخص می کند. مقدار youtube#videoAbuseReportReasonListResponse خواهد بود. |
etag | etag Etag این منبع |
items[] | list فهرستی از منابع videoAbuseReportReason ، که هر کدام دلیلی را مشخص میکند که ممکن است یک ویدیو به دلیل محتوای توهینآمیز گزارش شود. هنگام فراخوانی روش videos.reportAbuse از این اطلاعات برای گزارش واقعی ویدیوهایی که حاوی محتوای توهین آمیز هستند استفاده کنید. |
خطاها
جدول زیر پیام های خطایی را مشخص می کند که API می تواند در پاسخ به تماس با این روش بازگرداند. لطفاً برای جزئیات بیشتر به مستندات پیام خطا مراجعه کنید.
نوع خطا | جزئیات خطا | شرح |
---|---|---|
forbidden (403) | forbidden |
آن را امتحان کنید!
از APIs Explorer برای فراخوانی این API و مشاهده درخواست و پاسخ API استفاده کنید.