Мы обновляем API YouTube Analytics и отчетности, чтобы они соответствовали тому, как YouTube подсчитывает просмотры коротких видео.
Узнать больше ,Мы обновляем API YouTube Analytics и отчетности, чтобы они соответствовали тому, как YouTube подсчитывает просмотры коротких видео.
Узнать больше
ReportTypes
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Ресурс reportType
идентифицирует конкретный отчет, который может получить владелец канала или контента.
Методы
В следующей таблице показаны методы, которые API поддерживает для ресурсов report
.
Методы |
---|
list | Возвращает список типов отчетов, которые может получить владелец канала или контента. |
Представление ресурса JSON
В приведенной ниже структуре JSON показан формат ресурса reportType
:
{
"id": string,
"name": string,
"deprecateTime": timestamp,
"systemManaged": boolean
}
Характеристики
В следующей таблице определены свойства, которые появляются в этом ресурсе:
Характеристики |
---|
id | string Идентификатор, который YouTube использует для уникальной идентификации отчета. Значение свойства имеет максимальную длину 100 символов. В таблице ниже указаны самые последние версии каждого поддерживаемого типа отчета (максимум 100 символов).
Просмотр поддерживаемых отчетов для каналов Отчеты |
---|
канал_basic_a2 | Активность пользователя | Channel_province_a2 | Активность пользователей по провинциям | Channel_playback_location_a2 | Места воспроизведения | канал_трафик_источник_а2 | Источники трафика | канал_device_os_a2 | Устройство и операционная система | канал_демография_а1 | Демография | канал_sharing_service_a1 | Услуги совместного использования | канал_аннотации_а1 | Аннотации | канал_cards_a1 | Карты | Channel_end_screens_a1 | Конечные заставки | Channel_subtitles_a2 | Субтитры | канал_комбинированный_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 идентифицирует отчет, управляемый системой. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-10-29 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"]],["Последнее обновление: 2024-10-29 UTC."],[[["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"]]