ReportTypes
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
یک منبع reportType گزارش خاصی را شناسایی میکند که یک کانال یا مالک محتوا میتواند آن را بازیابی کند.
روشها
جدول زیر متدهایی را که API برای منابع report پشتیبانی میکند، نشان میدهد.
| روشها |
|---|
list | فهرستی از انواع گزارشهایی را که مالک کانال یا محتوا میتواند بازیابی کند، برمیگرداند. |
خواص
جدول زیر ویژگیهایی را که در این منبع ظاهر میشوند، تعریف میکند:
| خواص |
|---|
id | string شناسهای که یوتیوب برای شناسایی منحصر به فرد گزارش استفاده میکند. مقدار ویژگی حداکثر ۱۰۰ کاراکتر دارد. جدول زیر جدیدترین نسخه هر نوع گزارش پشتیبانی شده (حداکثر ۱۰۰ کاراکتر) را مشخص میکند.
گزارشهای پشتیبانیشده برای کانالها را ببینید| شناسه گزارش | توضیحات |
|---|
| channel_basic_a2 | فعالیت کاربر | | channel_province_a2 | فعالیت کاربران بر اساس استان | | channel_playback_location_a2 | مکانهای پخش | | channel_traffic_source_a2 | منابع ترافیک | | channel_device_os_a2 | دستگاه و سیستم عامل | | channel_demographics_a1 | جمعیتشناسی | | سرویس_اشتراک_کانال_a1 | سرویسهای اشتراکگذاری | | channel_annotations_a1 | حاشیهنویسیها | | کارتهای_کانال_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 | فعالیت کاربران بر اساس استانها | | مکان_پخش_مالک_محتوا_a2 | مکانهای پخش | | content_owner_traffic_source_a2 | منابع ترافیک | | مالک_محتوای_دستگاه_سیستم_عامل_a2 | دستگاه و سیستم عامل | | مالک_محتوای_جمعیت_a1 | جمعیتشناسی | | content_owner_sharing_service_a1 | سرویسهای اشتراکگذاری | | content_owner_annotations_a1 | حاشیهنویسیها | | content_owner_cards_a1 | کارتها | | content_owner_end_screens_a1 | صفحات پایان | | زیرنویس_مالک_محتوای_a2 | زیرنویسها | | content_owner_combined_a2 | ترکیبی | | مالک_محتوا_لیست_پخش_پایه_a1 | فعالیت کاربر در لیست پخش | | content_owner_playlist_province_a1 | فعالیت کاربران لیست پخش بر اساس استان | | مالک_محتوا_لیست_پخش_مکان_پخش_a1 | مکانهای پخش لیست پخش | | مالک_محتوا_پخش_لیست_ترافیک_منبع_a1 | منابع ترافیک لیست پخش | | مالک_محتوا_لیست_پخش_دستگاه_سیستم_عامل_a1 | دستگاه لیست پخش و سیستم عامل | | مالک_محتوای_لیست_پخش_ترکیبی_a1 | لیست پخش ترکیب شد | | نرخ تبلیغات مالک محتوا_a1 | عملکرد تبلیغات | | content_owner_estimated_revenue_a1 | درآمد تخمینی بر اساس ویدیو | | content_owner_asset_estimated_revenue_a1 | درآمد تخمینی بر اساس دارایی | | مالک_محتوای_دارایی_پایه_a2 | فعالیت کاربر برای داراییها | | content_owner_asset_province_a2 | فعالیت کاربر بر اساس استان برای داراییها | | مکان_پخش_دارایی_مالک_محتوا_a2 | مکانهای پخش دارایی | | content_owner_asset_traffic_source_a2 | منابع ترافیک دارایی | | content_owner_asset_device_os_a2 | دستگاه دارایی و سیستم عامل | | content_owner_asset_demographics_a1 | آمار جمعیتی داراییها | | سرویس اشتراکگذاری دارایی_مالک_محتوای_a1 | خدمات اشتراکگذاری دارایی | | content_owner_asset_annotations_a1 | حاشیهنویسی داراییها | | content_owner_asset_cards_a1 | کارتهای دارایی | | content_owner_asset_end_screens_a1 | صفحات پایان دارایی | | مالک_محتوای_دارایی_ترکیبی_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 نام گزارش. مقدار ویژگی حداکثر ۱۰۰ کاراکتر دارد. |
deprecateTime | timestamp تاریخ و زمانی که گزارش منسوخ شده یا منسوخ خواهد شد. اگر کاری برای نوع گزارش منسوخ شده دارید، یوتیوب گزارشهای جدیدی را برای آن کار به مدت سه ماه پس از اعلام تاریخ منسوخ شدن تولید میکند.
برای مثال، اعلام منسوخ شدن گزارش content_owner_basic_a1 در تاریخ ۱۹ می ۲۰۱۶ بود. بنابراین، فیلد deprecateTime برای آن نوع گزارش، زمانی را در ۱۹ آگوست ۲۰۱۶ مشخص میکند که پس از آن، یوتیوب تولید گزارشهایی از آن نوع را متوقف خواهد کرد. |
systemManaged | boolean این مقدار در صورتی true است که یوتیوب به طور خودکار گزارش را برای مالکان محتوای یوتیوب تولید کند، بدون اینکه مالکان محتوا نیاز داشته باشند ابتدا متد jobs.create را برای دستور دادن به یوتیوب جهت تولید گزارش فراخوانی کنند. در واقع، اگر ویژگی reportTypeId یک گزارش مدیریتشده توسط سیستم را شناسایی کند، متد jobs.create خطایی را برمیگرداند. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2026-09-15 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2026-09-15 بهوقت ساعت هماهنگ جهانی."],[],["A `reportType` resource defines a retrievable report for channels or content owners. The API supports listing available `reportTypes`. Each `reportType` has an `id`, `name`, `deprecateTime`, and `systemManaged` status. The `id` property identifies the report's type, such as user activity or demographics. `SystemManaged` reports are generated automatically, whereas other reports have to be called using the `jobs.create` method. The deprecation date marks when report generation stops.\n"]]