ReportTypes

يحدّد مورد reportType تقريرًا محددًا يمكن لمالك القناة أو المحتوى استرداده.

الطُرق

يعرض الجدول التالي الطرق التي تتيحها واجهة برمجة التطبيقات لموارد report.

الطُرق
list عرض قائمة بأنواع التقارير التي يمكن لمالك القناة أو المحتوى استردادها.

تمثيل موارد JSON

توضِّح بنية JSON أدناه تنسيق مورد reportType:

{
  "id": string,
  "name": string,
  "deprecateTime": timestamp,
  "systemManaged": boolean
}

أماكن إقامة

يحدد الجدول التالي الخصائص التي تظهر في هذا المورد:

أماكن إقامة
id
string المعرّف الذي يستخدمه YouTube لتحديد التقرير بشكل فريد تتألف قيمة السمة من 100 حرف كحدّ أقصى. يحدّد الجدول أدناه أحدث نسخة من كلّ نوع تقرير متوافق (100 حرف كحدّ أقصى).

name
string اسم التقرير تتألف قيمة السمة من 100 حرف كحدّ أقصى.
deprecateTime
timestamp تاريخ ووقت إيقاف التقرير نهائيًا إذا كان لديك وظيفة من نوع تقارير متوقّف نهائيًا، تُنشئ YouTube تقارير جديدة لتلك الوظيفة لمدة ثلاثة أشهر بعد الإعلان عن تاريخ الإيقاف النهائي.

على سبيل المثال، تم الإعلان عن الإيقاف النهائي لتقرير content_owner_basic_a1 في 19 أيار (مايو) 2016. وبالتالي، يحدّد الحقل deprecateTime لنوع التقرير هذا وقتًا في 19 آب (أغسطس) 2016 سيتوقف YouTube بعده عن إنشاء تقارير من هذا النوع.
systemManaged
boolean تكون هذه القيمة true إذا أنشأ YouTube التقرير تلقائيًا لمالكي المحتوى على YouTube بدون أن يحتاج مالكو المحتوى إلى استدعاء إجراء jobs.create أولاً لإرسال تعليمات إلى YouTube لإنشاء التقرير. في الواقع، تعرض الطريقة jobs.create خطأً إذا كانت السمة reportTypeId تحدّد تقريرًا يديره النظام.