Videos: reportAbuse

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

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

درخواست

درخواست HTTP

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 نشان می‌دهد که اطلاعات کاربری مجوز درخواست، کاربر CMS YouTube را شناسایی می‌کند که از طرف مالک محتوای مشخص‌شده در مقدار پارامتر عمل می‌کند. این پارامتر برای شرکای محتوای YouTube است که مالک و مدیر کانال‌های مختلف YouTube هستند. این ویژگی به مالکان محتوا اجازه می‌دهد یک‌بار اصالت‌سنجی کنند و به همه داده‌های ویدیو و کانال خود دسترسی پیدا کنند، بدون اینکه نیاز باشد برای هر کانال به‌طور جداگانه اعتبارنامه‌های اصالت‌سنجی ارائه دهند. حساب CMS که کاربر با آن اصالت‌سنجی می‌کند باید به مالک محتوای YouTube مشخص‌شده پیوند داده شده باشد.

متن درخواست

متن درخواست ساختار داده زیر را دارد:

{
  "videoId": string,
  "reasonId": string,
  "secondaryReasonId": string,
  "comments": string,
  "language": string
}

مشخصات الزامی

باید برای مشخصات زیر مقدار تنظیم کنید:

• videoId
• reasonId

دارایی‌های اختیاری

می‌توانید مقادیر زیر را برای دارایی‌ها تنظیم کنید:

• secondaryReasonId
• comments
• language

مشخصات

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

مشخصات
videoId	string ویدیویی را که به‌دلیل داشتن محتوای توهین‌آمیز گزارش شده است شناسایی می‌کند. مقدار را روی شناسه ویدیو YouTube آن ویدیو تنظیم کنید.
reasonId	object دلیل گزارش شدن ویدیو به‌دلیل داشتن محتوای توهین‌آمیز را مشخص می‌کند. مقدار را روی unique ID منبع videoAbuseReportReason مناسب تنظیم کنید.
secondaryReasonId	object دلیل ثانویه گزارش ویدیو به‌دلیل داشتن محتوای توهین‌آمیز را مشخص می‌کند. دلیل ثانویه شرح دقیق‌تری از محتوای اعتراض‌برانگیز نسبت‌به دلیل اولیه ارائه می‌دهد که ویژگی reasonId آن را شناسایی می‌کند. مقدار را روی unique ID دلیل ثانویه مناسب تنظیم کنید.
comments	string هرگونه اطلاعات تکمیلی را که گزارش‌دهنده می‌خواهد اضافه کند ارائه می‌دهد.
language	object زبانی را که گزارشگر صحبت می‌کند شناسایی می‌کند.

پاسخ

درصورت موفقیت، این روش کد پاسخ HTTP 204 (No Content) را برمی‌گرداند.

خطاها

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

نوع خطا	جزئیات خطا	شرح
badRequest (400)	invalidAbuseReason	درخواست حاوی مقدار غیرمنتظره‌ای برای دارایی reasonId، یا ترکیبی نامعتبر از دارایی‌های reasonId و secondaryReasonId بود.
badRequest (400)	rateLimitExceeded	کاربر درخواست‌های زیادی در یک بازه زمانی مشخص ارسال کرده است.
forbidden (403)	forbidden
notFound (404)	videoNotFound	ویدیویی که می‌خواهید برای آن گزارش سوءاستفاده ارسال کنید پیدا نشد.

امتحان کنید!

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