این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Videos: reportAbuse

ویدیویی را به دلیل محتوای توهین آمیز گزارش می کند.

تاثیر سهمیه ای: فراخوانی به این روش هزینه سهمیه ای 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 استفاده کنید.