ما در حال به‌روزرسانی YouTube Analytics و APIهای گزارش هستیم تا با نحوه شمارش بازدیدهای YouTube برای Shorts مطابقت داشته باشد.
بیشتر بدانید ،ما در حال به‌روزرسانی YouTube Analytics و APIهای گزارش هستیم تا با نحوه شمارش بازدیدهای YouTube برای Shorts مطابقت داشته باشد.
بیشتر بدانید
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 یک خطا برمی‌گرداند. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2024-10-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین به‌روزرسانی 2024-10-29 بهوقت ساعت هماهنگ جهانی."],[[["A `reportType` resource in the YouTube API defines a specific report that can be retrieved by a channel or content owner."],["The API supports listing available report types via the `reportTypes.list` method, enabling users to identify the reports they can access."],["Each `reportType` resource is represented in JSON and includes properties such as `id`, `name`, `deprecateTime`, and `systemManaged`, detailing the report's identifier, name, deprecation status, and whether it is system-managed."],["The `id` property of a report type can help identify the most recent version of the report, and there are different reports for channels, content owners and system managed."],["The `systemManaged` property indicates whether a report is automatically generated by YouTube for content owners, or if they need to use the jobs.create method to initiate report generation."]]],["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"]]
