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 تحدد تقريرًا يديره النظام.