Videos: reportAbuse

الإبلاغ عن فيديو يتضمّن محتوًى مسيئًا

تأثير الحصة: تحتوي إحدى المكالمات إلى هذه الطريقة على تكلفة حصة تبلغ 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" الذي يتصرّف نيابةً عن مالك المحتوى المحدَّد في قيمة المَعلمة. هذه المعلمة مخصصة لشركاء المحتوى في 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 لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.