ReportTypes

منبع reportType گزارش خاصی را مشخص می کند که یک کانال یا صاحب محتوا می تواند آن را بازیابی کند.

مواد و روش ها

جدول زیر روش هایی را نشان می دهد که API برای منابع 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 ترکیب شده مخاطب_حفظ_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 دستور تولید گزارش را بدهد. در واقع، اگر ویژگی reportTypeId گزارش مدیریت شده توسط سیستم را شناسایی کند، متد jobs.create یک خطا برمی‌گرداند.