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