VideoAbuseReportReasons: list

فهرستی از دلایلی را که می‌توان برای گزارش ویدیوهای سوءاستفاده‌گرانه استفاده کرد بازیابی کنید.

تأثیر سهمیه: تماس با این روش هزینه سهمیه ۱ واحدی دارد.

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

درخواست

درخواست 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 زبانی را مشخص می‌کند که باید برای مقادیر نوشتاری در پاسخ میانای برنامه‌سازی کاربردی استفاده شود. مقدار پیش‌فرض en_US است.

متن درخواست

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

پاسخ

درصورت موفقیت‌آمیز بودن، این روش بدنه پاسخی با ساختار زیر برمی‌گرداند:

{
  "kind": "youtube#videoAbuseReportReasonListResponse",
  "etag": etag,
  "items": [
    videoAbuseReportReason resource
  ]
}

مشخصات

جدول زیر ویژگی‌هایی را که در این منبع ظاهر می‌شوند تعریف می‌کند:

مشخصات
kind string
نوع منبع میانای برنامه‌سازی کاربردی را مشخص می‌کند. مقدار youtube#videoAbuseReportReasonListResponse خواهد بود.
etag etag
Etag این منبع.
items[] list
فهرستی از videoAbuseReportReason منابع که هرکدام دلیلی را مشخص می‌کنند که ممکن است یک ویدیو به‌دلیل داشتن محتوای توهین‌آمیز گزارش شود. از این اطلاعات هنگام فراخوانی روش videos.reportAbuse برای گزارش کردن ویدیوهایی که حاوی محتوای توهین‌آمیز هستند استفاده کنید.

خطاها

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

نوع خطا جزئیات خطا شرح
forbidden (403) forbidden

امتحان کنید!

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