استرداد قائمة بالأسباب التي يمكن استخدامها للإبلاغ عن الفيديوهات المسيئة
التأثير في الحصة: تبلغ تكلفة الحصة لكل طلب لهذه الطريقة وحدة واحدة.
حالات الاستخدام الشائعة
طلب
طلب HTTP
GET https://www.googleapis.com/youtube/v3/videoAbuseReportReasons
التفويض
يتطلّب هذا الطلب الحصول على إذن باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات حول المصادقة والتفويض).
| النطاق |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
https://www.googleapis.com/auth/youtube.readonly |
المعلمات
يعرض الجدول التالي المَعلمات التي يتيحها هذا الطلب. جميع المَعلمات المدرَجة هي مَعلمات طلب البحث.
| المعلمات | ||
|---|---|---|
| المَعلمات المطلوبة | ||
part |
stringتحدّد المَعلمة part أجزاء المورد videoAbuseReportReason التي سيتضمّنها الردّ من واجهة برمجة التطبيقات. القيمتان المسموح بهما هما id وsnippet. |
|
| المَعلمات الاختيارية | ||
hl |
stringتحدّد المَعلمة hl اللغة التي يجب استخدامها لقيم النصوص في ردّ من واجهة برمجة التطبيقات. تكون القيمة التلقائية en_US. |
|
نص الطلب
لا تقدّم نص طلب عند استدعاء هذه الطريقة.
الردّ
في حال نجاح هذه الطريقة، ستعرض نص استجابة بالبنية التالية:
{
"kind": "youtube#videoAbuseReportReasonListResponse",
"etag": etag,
"items": [
videoAbuseReportReason resource
]
}الخصائص
يحدّد الجدول التالي السمات التي تظهر في هذا المرجع:
| الخصائص | |
|---|---|
kind |
stringيحدّد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#videoAbuseReportReasonListResponse. |
etag |
etagتمثّل هذه السمة علامة Etag الخاصة بهذا المرجع. |
items[] |
listقائمة بموارد videoAbuseReportReason يحدّد كلّ منها سببًا للإبلاغ عن فيديو يتضمّن محتوًى مسيئًا. استخدِم هذه المعلومات عند استدعاء طريقة videos.reportAbuse للإبلاغ فعليًا عن الفيديوهات التي تتضمّن محتوًى مسيئًا. |
الأخطاء
يحدّد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات استجابةً لطلب هذه الطريقة. يُرجى الاطّلاع على مستندات رسالة الخطأ لمزيد من التفاصيل.
| نوع الخطأ | تفاصيل الخطأ | الوصف |
|---|---|---|
forbidden (403) |
forbidden |
جرِّبها الآن.
استخدِم APIs Explorer لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة.