ویدیویی را به دلیل محتوای توهین آمیز گزارش می کند.
تاثیر سهمیه ای: فراخوانی به این روش هزینه سهمیه ای 50 واحدی دارد.
POST https://www.googleapis.com/youtube/v3/videos/reportAbuse
این درخواست به مجوز حداقل با یکی از حوزه های زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).
| دامنه |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
https://www.googleapis.com/auth/youtubepartner |
جدول زیر پارامترهایی را که این کوئری پشتیبانی می کند فهرست می کند. تمام پارامترهای لیست شده پارامترهای پرس و جو هستند.
| پارامترها | ||
|---|---|---|
| پارامترهای اختیاری | ||
onBehalfOfContentOwner | stringاین پارامتر فقط در یک درخواست مجاز به درستی قابل استفاده است. توجه: این پارامتر منحصراً برای شرکای محتوای YouTube در نظر گرفته شده است. پارامتر onBehalfOfContentOwner نشان می دهد که اعتبارنامه مجوز درخواست، کاربر YouTube CMS را شناسایی می کند که از طرف مالک محتوا مشخص شده در مقدار پارامتر عمل می کند. این پارامتر برای شرکای محتوای YouTube در نظر گرفته شده است که کانالهای مختلف YouTube را مالک و مدیریت میکنند. این به صاحبان محتوا امکان میدهد یک بار احراز هویت کنند و به تمام دادههای ویدیویی و کانال خود دسترسی داشته باشند، بدون اینکه نیازی به ارائه اعتبارنامه احراز هویت برای هر کانال جداگانه داشته باشند. حساب CMS که کاربر با آن احراز هویت میکند باید به مالک محتوای YouTube مشخص شده مرتبط باشد. | |
بدنه درخواست دارای ساختار داده زیر است:
{
"videoId": string,
"reasonId": string,
"secondaryReasonId": string,
"comments": string,
"language": string
}شما باید مقادیری را برای ویژگی های زیر تنظیم کنید:
می توانید مقادیری را برای ویژگی های زیر تنظیم کنید:
جدول زیر ویژگی های ظاهر شده در این منبع را تعریف می کند:
| خواص | |
|---|---|
videoId | stringویدیویی را که به دلیل محتوای توهین آمیز گزارش شده است شناسایی می کند. مقدار را روی شناسه ویدیوی YouTube آن ویدیو تنظیم کنید. |
reasonId | objectدلیل اینکه ویدیویی که به دلیل محتوای توهین آمیز گزارش شده است را مشخص می کند. مقدار را روی unique ID منبع videoAbuseReportReason مناسب تنظیم کنید. |
secondaryReasonId | objectدلیل ثانویه را مشخص می کند که ویدیویی که به دلیل محتوای توهین آمیز گزارش شده است. یک دلیل ثانویه توصیف خاص تری از محتوای قابل اعتراض نسبت به دلیل اصلی ارائه می دهد، که ویژگی reasonId آن را مشخص می کند. مقدار را روی unique ID دلیل ثانویه مناسب تنظیم کنید. |
comments | stringهر گونه اطلاعات اضافی را که گزارشگر می خواهد اضافه کند ارائه می دهد. |
language | objectزبانی را که گزارشگر صحبت می کند مشخص می کند. |
در صورت موفقیت آمیز بودن، این روش کد پاسخ HTTP 204 ( No Content ) را برمی گرداند.
جدول زیر پیام های خطایی را مشخص می کند که API می تواند در پاسخ به تماس با این روش بازگرداند. لطفاً برای جزئیات بیشتر به مستندات پیام خطا مراجعه کنید.
| نوع خطا | جزئیات خطا | توضیحات |
|---|---|---|
badRequest (400) | invalidAbuseReason | این درخواست حاوی مقدار غیرمنتظره ای برای ویژگی reasonId یا ترکیبی نامعتبر از ویژگی های reasonId و secondaryReasonId بود. |
badRequest (400) | rateLimitExceeded | کاربر در یک بازه زمانی معین درخواست های زیادی ارسال کرده است. |
forbidden (403) | forbidden | |
notFound (404) | videoNotFound | ویدیویی که میخواهید سوءاستفاده را برای آن گزارش کنید یافت نمیشود. |
از APIs Explorer برای فراخوانی این API و مشاهده درخواست و پاسخ API استفاده کنید.