ReportTypes
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Ресурс reportType определяет конкретный отчет, который может получить владелец канала или контента.
Методы
В таблице ниже показаны методы, которые API поддерживает для ресурсов report .
| Методы |
|---|
list | Возвращает список типов отчетов, которые может получить владелец канала или контента. |
Представление ресурсов в формате JSON
Приведенная ниже структура JSON демонстрирует формат ресурса reportType :
{
"id": string,
"name": string,
"deprecateTime": timestamp,
"systemManaged": boolean
} Характеристики
В следующей таблице описаны свойства, которые отображаются в этом ресурсе:
| Характеристики |
|---|
id | string Идентификатор, который YouTube использует для уникальной идентификации отчета. Максимальная длина значения свойства — 100 символов. В таблице ниже указана самая последняя версия каждого поддерживаемого типа отчета (максимум 100 символов).
См. поддерживаемые отчеты для каналов.| Идентификатор отчета | Описание |
|---|
| channel_basic_a2 | Активность пользователей | | канал_провинция_а2 | Активность пользователей по провинциям | | 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 | Субтитры | | канал_комбинированный_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 автоматически генерирует отчет для владельцев контента без необходимости предварительного вызова метода jobs.create для указания YouTube на генерацию отчета. Фактически, метод jobs.create возвращает ошибку, если свойство reportTypeId указывает на отчет, управляемый системой. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2026-09-15 UTC.
[[["Прост для понимания","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"]],["Последнее обновление: 2026-09-15 UTC."],[],["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"]]