ReportTypes

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

الطُرق

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

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

تمثيل موارد JSON

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

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

أماكن إقامة

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

أماكن إقامة
id	string المعرّف الذي يستخدمه YouTube لتحديد التقرير بشكل فريد تتألف قيمة السمة من 100 حرف كحدّ أقصى. يحدّد الجدول أدناه أحدث نسخة من كلّ نوع تقرير متوافق (100 حرف كحدّ أقصى). الاطّلاع على تقارير متوفرة للقنوات التقارير channel_basic_a2 نشاط المستخدم channel_province_a2 نشاط المستخدِم حسب المقاطعة channel_playback_location_a2 مواقع التشغيل channel_traffic_source_a2 مصادر الزيارات channel_device_os_a2 الجهاز ونظام التشغيل channel_demographics_a1 الخصائص الديمغرافية channel_sharing_service_a1 خدمات المشاركة channel_annotations_a1 التعليقات التوضيحية channel_cards_a1 البطاقات channel_end_screens_a1 شاشات النهاية channel_subtitles_a2 الترجمة channel_combined_a2 القيمة المُجمَّعة audience_retention_a1 الاحتفاظ بالجمهور على الفيديوهات playlist_basic_a1 نشاط المستخدم في قائمة التشغيل playlist_province_a1 نشاط مستخدم قائمة التشغيل حسب المقاطعة playlist_playback_location_a1 مواقع تشغيل قوائم التشغيل playlist_traffic_source_a1 مصادر زيارات قوائم التشغيل playlist_device_os_a1 جهاز قائمة التشغيل ونظام التشغيل playlist_combined_a1 قائمة تشغيل مجمّعة الاطّلاع على تقارير متاحة لمالكي المحتوى التقارير content_owner_basic_a3 نشاط المستخدم content_owner_province_a2 نشاط المستخدِم حسب المقاطعات content_owner_playback_location_a2 مواقع التشغيل content_owner_traffic_source_a2 مصادر الزيارات content_owner_device_os_a2 الجهاز ونظام التشغيل content_owner_demographics_a1 الخصائص الديمغرافية content_owner_sharing_service_a1 خدمات المشاركة content_owner_annotations_a1 التعليقات التوضيحية content_owner_cards_a1 البطاقات content_owner_end_screens_a1 شاشات النهاية content_owner_subtitles_a2 الترجمة content_owner_combined_a2 القيمة المُجمَّعة content_owner_playlist_basic_a1 نشاط المستخدم في قائمة التشغيل content_owner_playlist_province_a1 نشاط مستخدم قائمة التشغيل حسب المقاطعة content_owner_playlist_playback_location_a1 مواقع تشغيل قوائم التشغيل content_owner_playlist_traffic_source_a1 مصادر زيارات قوائم التشغيل content_owner_playlist_device_os_a1 جهاز قائمة التشغيل ونظام التشغيل content_owner_playlist_combined_a1 قائمة تشغيل مجمّعة content_owner_ad_rates_a1 أداء الإعلان content_owner_estimated_revenue_a1 الأرباح المقدَّرة حسب الفيديو content_owner_asset_estimated_revenue_a1 الأرباح المقدَّرة حسب مادة العرض content_owner_asset_basic_a2 نشاط المستخدم لمواد العرض content_owner_asset_province_a2 نشاط المستخدِم حسب المقاطعة لمواد العرض content_owner_asset_playback_location_a2 المواقع الجغرافية لتشغيل مواد العرض content_owner_asset_traffic_source_a2 مصادر زيارات مواد العرض content_owner_asset_device_os_a2 جهاز الأصول ونظام التشغيل content_owner_asset_demographics_a1 الخصائص الديمغرافية لمادة العرض content_owner_asset_sharing_service_a1 خدمات مشاركة مواد العرض content_owner_asset_annotations_a1 التعليقات التوضيحية لمادة العرض content_owner_asset_cards_a1 بطاقات مواد العرض content_owner_asset_end_screens_a1 شاشات النهاية لمواد العرض content_owner_asset_combined_a2 مادة العرض مجتمعة الاطّلاع على التقارير المتوافقة التي يديرها النظام (لمالكي المحتوى) التقارير التي يديرها النظام content_owner_ad_revenue_raw_a1 أرباح الإعلانات الدقيقة لكل فيديو content_owner_ad_revenue_summary_a1 الأرباح المجمّعة من الإعلانات لكل فيديو content_owner_asset_ad_revenue_raw_a1 أرباح الإعلانات الدقيقة لكل مادة عرض content_owner_asset_ad_revenue_summary_a1 إجمالي أرباح الإعلانات لكل مادة عرض content_owner_claim_ad_revenue_summary_a1 المطالبات (لا يحتوي هذا التقرير على بيانات الأرباح)
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 تحدّد تقريرًا يديره النظام.