الإبلاغ عن فيديو لاحتوائه على محتوى مسيء
التأثير على الحصة: إنّ استدعاء هذه الطريقة له تكلفة حصة قدرها 50 وحدة.
طلب
طلب 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 إلى أن بيانات اعتماد تفويض الطلب تحدد مستخدم YouTube CMS الذي يتصرف نيابةً عن مالك المحتوى المحدد في قيمة المعلمة. هذه المعلمة مخصصة لشركاء محتوى YouTube الذين يملكون ويديرون العديد من قنوات YouTube المختلفة. تتيح هذه الميزة لمالكي المحتوى المصادقة مرة واحدة والوصول إلى كل بيانات الفيديو والقناة بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة على حدة. يجب ربط حساب نظام إدارة المحتوى الذي يصادق المستخدم عليه بمالك محتوى 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
).
الأخطاء
يحدد الجدول أدناه رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات ردًا على استدعاء لهذه الطريقة. يرجى الاطلاع على وثائق رسالة الخطأ لمزيد من التفاصيل.
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
badRequest (400) |
invalidAbuseReason |
تضمّن الطلب قيمة غير متوقعة للخاصية reasonId ، أو تركيبة غير صالحة من الخاصيتين reasonId وsecondaryReasonId . |
badRequest (400) |
rateLimitExceeded |
أرسل المستخدم عددًا كبيرًا جدًا من الطلبات في إطار زمني محدد. |
forbidden (403) |
forbidden |
|
notFound (404) |
videoNotFound |
تعذّر العثور على الفيديو الذي تحاول الإبلاغ عن إساءة استخدامه. |
جرِّب هذه الميزة الآن.
يمكنك استخدام APIs Explorer لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة له.