История изменений

На этой странице перечислены изменения в API и обновления документации для YouTube Reporting API и YouTube Analytics API. Оба API позволяют разработчикам получать доступ к данным YouTube Аналитики, но разными способами.

6 ноября 2026 г.

Документация по параметрам мест воспроизведения обновлена для YouTube Reporting API и YouTube Analytics API:

  • В таблице параметров playback_location_type в YouTube Reporting API теперь есть значения 11 (просмотры в ленте вертикальных трансляций) и 12 (просмотры на вкладке "Семплы" в YouTube Music).
  • В YouTube Analytics API определение параметра insightPlaybackLocationType теперь включает IMMERSIVE_LIVE_FEED (просмотры в ленте вертикальных трансляций) и SHORTS_FEED (просмотры в ленте YouTube Shorts).

4 ноября 2026 г.

С 15 января 2027 года версия 1.0 еженедельного отчета о цифровых отпечатках для владельцев контента (content_owner_active_references_a1) больше не поддерживается. Вместо нее используется версия 1.1 (content_owner_active_references_a2). Перейдите на последнюю версию до 15 января 2027 года.

30 октября 2026 г.

Теперь YouTube Reporting API поддерживает следующие системные отчеты для владельцев контента:

Категория Название отчета Идентификатор типа отчета
Финансовые сводки Ежемесячная сводка по корректировкам каналов content_owner_channel_adjustments_summary_a1
Финансовые сводки Ежемесячный доход от транзакций за платные функции content_owner_transactions_paid_features_revenue_a1
Финансовые сводки Ежемесячный доход от транзакций TVOD по названию и стране tvod_content_owner_country_title_tvod_revenue_a1
Финансовые сводки Ежемесячный доход от транзакций TVOD по странам tvod_content_owner_country_transactions_tvod_revenue_a1
Shorts Ежемесячный отчет о создании объектов типа "видео Shorts" для музыкальных лейблов music_content_owner_shorts_asset_creations_a1
Shorts Ежемесячные просмотры объектов музыкальных лейблов в Shorts music_content_owner_shorts_asset_views_a1
Shorts Ежемесячный отчет музыкального издательства о создании объектов типа "видео Shorts" publisher_content_owner_shorts_asset_creations_a1
Shorts Ежемесячный отчет о просмотрах объектов типа "видео Shorts" для музыкальных издательств publisher_content_owner_shorts_asset_views_a1
Налоги Ежемесячный сводный отчет о возврате налогов с каналов МКС content_owner_affiliate_tax_refund_summary_a1
Объекты Еженедельный отчет SRMF publisher_content_owner_weekly_srmf
Объекты Ежедневный отчет о статусе запросов на создание официальных каналов исполнителей content_owner_oac_request_status_a1
Объекты Ежедневный отчет о качестве запросов на создание официальных каналов исполнителей content_owner_oac_quality_status_a1

13 сентября 2026 г.

YouTube Reporting API теперь поддерживает версию 1.1 еженедельного отчета о цифровых отпечатках для владельцев контента (content_owner_active_references_a2).

В версии 1.1 представлены следующие изменения:

  • Добавлено поле status_detail, в котором указываются дополнительные сведения о статусе цифрового отпечатка или причинах его присвоения.
  • В поле asset_owners будут указываться отображаемые названия владельцев контента или внешние идентификаторы, а не коды партнеров.

Предыдущая версия отчета, Версия 1.0 (content_owner_active_references_a1), по-прежнему доступна.

9 сентября 2026 г.

В документацию по YouTube Analytics API и YouTube Reporting API были внесены следующие дополнения и уточнения:

  • Соглашение об уровне обслуживания в отношении актуальности данных и задержки. В раздел Модель данных добавлена информация о задержке обработки данных (от 48 до 72 часов) и усечении конечной даты до последнего полностью обработанного дня. Также мы рекомендуем использовать метод videos.list YouTube Data API для получения статистики видео в реальном времени.

  • Финансовые показатели в отчетах по каналам. В документацию по авторизации отчетов по каналам добавлено пояснение о том, что расчетный доход и показатели эффективности рекламы поддерживаются в отчетах по каналам, авторизованных с областью действия https://www.googleapis.com/auth/yt-analytics-monetary.readonly, если канал участвует в Партнерской программе YouTube. Для каналов без монетизации возвращается ошибка HTTP 403 Forbidden.

  • Ограничения запросов и совместимость параметров. В статью Таблицы отчетов добавлено примечание о том, что недопустимые или взаимоисключающие сочетания параметров, показателей и фильтров возвращают ошибку HTTP 400 badRequest ("The query is not supported.").

  • Пустые значения параметров в массовых отчетах. В характеристики отчетов YouTube Reporting API добавлено пояснение о том, что столбцы параметров, такие как video_id или channel_id, содержат пустые строки, чтобы сохранить агрегированные значения показателей для удаленных ресурсов и представить события на уровне канала.

27 августа 2026 г.

YouTube будет одинаково подсчитывать общедоступные просмотры для всех форматов видео: обычных видео, трансляций и Shorts. Общедоступные просмотры на YouTube регистрируются, когда начинается воспроизведение видео.

Это не повлияет на соответствие требованиям монетизации и большинство основных показателей эффективности, поскольку они по-прежнему будут рассчитываться на основе заинтересованных просмотров. Доход авторов по-прежнему будет зависеть от количества заинтересованных просмотров Shorts и часов заинтересованного просмотра. Эти показатели можно найти в расширенном режиме YouTube Аналитики.

Требования для участия в Партнерской программе YouTube не изменятся. Теперь мы будем называть пороговые значения для участия в Партнерской программе YouTube "учитываемыми просмотрами Shorts" и "учитываемыми часами просмотра". Ранее мы использовали термины "действительные общедоступные просмотры Shorts" и "действительные часы просмотра общедоступных видео".

Подробнее об анализе эффективности контента на YouTube…

Показатель Статус Триггер Назначение
Открыть Обновлено Видео воспроизводится с первого кадра (включая автовоспроизведение, наведение указателя и нажатие для воспроизведения). Стандартные общедоступные просмотры.
Заинтересованный просмотр Без изменений Воспроизведение продолжается после первого кадра или пользователь нажимает на объявление, чтобы запустить его. Монетизация в рамках Партнерской программы YouTube, большинство основных показателей (CTR, средняя продолжительность просмотра) и отчеты о заинтересованности.
Показ значка Без изменений Значок показывается без взаимодействия или автовоспроизведения. Позволяет оценить видимость и упаковку на уровне фида.

Обновление документации по API. Мы обновили определение показателя engagedViews в документации по показателям YouTube Analytics API и YouTube Reporting API.

25 июня 2026 г.

Из документации по YouTube Analytics API (целевые запросы) удален отчет Действия пользователей по городам для владельцев контента. Этот отчет не поддерживается для владельцев контента. Запросы владельцев контента о действиях пользователей по городам будут возвращать пустые результаты.

9 марта 2026 г.

Параметры ageGroup (YouTube Analytics API) и age_group (YouTube Reporting API) теперь включают пользователей, которые, по оценкам YouTube, не достигли 18 лет.

15 января 2026 г.

В YouTube Reporting API теперь поддерживаются отчеты об охвате для каналов и владельцев контента. В отчетах об охвате представлена статистика по показам значков видео и CTR.

  • Для каналов доступны отчеты channel_reach_basic_a1 и channel_reach_combined_a1.
  • Владельцам контента доступны отчеты content_owner_reach_basic_a1 и content_owner_reach_combined_a1.

В этих отчетах поддерживаются следующие новые показатели:

  • video_thumbnail_impressions
  • video_thumbnail_impressions_ctr

22 сентября 2025 г.

Прекращение поддержки отчетов, о котором мы сообщали ранее, перенесено с 30 сентября на 31 октября 2025 г. Предыдущие версии отчетов, обновленные в связи с изменениями в подсчете просмотров Shorts, будут доступны до этой даты. Исключение – отчет о заявках версии 1.0 (content_owner_active_claims_a1) и отчет о заявках версии 1.1 (content_owner_active_claims_a2), которые будут по-прежнему прекращены 30 сентября.

24 июня 2025 г.

Как мы сообщали 26 марта 2025 года, Bulk Reports API будет обновлен в связи с изменением подсчета просмотров Shorts. Внесены следующие изменения:

  • Для каждого отчета, включающего просмотры (а это большинство отчетов), были созданы новые версии. Номер версии каждого затронутого отчета увеличился на единицу, например с a2 до a3.
  • Теперь будут учитываться как первые, так и повторные просмотры Shorts. Для видео ничего не изменится.
  • В обновленных отчетах появится новый столбец engaged_views, в котором будет отражена прежняя методология подсчета просмотров.

Изменения вступят в силу 30 июня 2025 года для Bulk Reports API. Учитывайте это при обработке отчетов.

Предыдущие версии отчетов будут доступны до 30 сентября 2025 г. После 30 сентября 2025 г. поддержка предыдущих версий будет прекращена. Обязательно перейдите на последние версии.

Наконец, при обработке отчетов следуйте рекомендациям, чтобы изменения в отчетах не нарушали работу конвейеров обработки.

В таблицах ниже приведены новые версии отчетов для каждого типа отчета.

Массовые отчеты в YouTube Аналитике

Отчеты о каналах – отчеты о видео
Название отчета Предыдущая версия Последняя версия
Действия пользователей channel_basic_a2 channel_basic_a3
Действия пользователей по регионам channel_province_a2 channel_province_a3
Места воспроизведения channel_playback_location_a2 channel_playback_location_a3
Источники трафика channel_traffic_source_a2 channel_traffic_source_a3
Тип устройства и операционная система channel_device_os_a2 channel_device_os_a3
Субтитры channel_subtitles_a2 channel_subtitles_a3
Общее значение channel_combined_a2 channel_combined_a3
Отчеты о каналах – отчеты о плейлистах
Название отчета Предыдущая версия Последняя версия
Действия пользователей playlist_basic_a1 playlist_basic_a2
Действия пользователей по регионам playlist_province_a1 playlist_province_a2
Места воспроизведения playlist_playback_location_a1 playlist_playback_location_a2
Источники трафика playlist_traffic_source_a1 playlist_traffic_source_a2
Тип устройства и операционная система playlist_device_os_a1 playlist_device_os_a2
Общее значение playlist_combined_a1 playlist_combined_a2
Отчеты для владельцев контента – отчеты о видео
Название отчета Предыдущая версия Последняя версия
Действия пользователей content_owner_basic_a3 content_owner_basic_a4
Действия пользователей по регионам content_owner_province_a2 content_owner_province_a3
Места воспроизведения content_owner_playback_location_a2 content_owner_playback_location_a3
Источники трафика content_owner_traffic_source_a2 content_owner_traffic_source_a3
Тип устройства и операционная система content_owner_device_os_a2 content_owner_device_os_a3
Субтитры content_owner_subtitles_a2 content_owner_subtitles_a3
Общее значение content_owner_combined_a2 content_owner_combined_a3
Отчеты для владельцев контента – отчеты о плейлистах
Название отчета Предыдущая версия Последняя версия
Действия пользователей content_owner_playlist_basic_a1 content_owner_playlist_basic_a2
Действия пользователей по регионам content_owner_playlist_province_a1 content_owner_playlist_province_a2
Места воспроизведения content_owner_playlist_playback_location_a1 content_owner_playlist_playback_location_a2
Источники трафика content_owner_playlist_traffic_source_a1 content_owner_playlist_traffic_source_a2
Тип устройства и операционная система content_owner_playlist_device_os_a1 content_owner_playlist_device_os_a2
Общее значение content_owner_playlist_combined_a1 content_owner_playlist_combined_a2
Отчеты для владельцев контента – отчеты об объектах
Название отчета Предыдущая версия Последняя версия
Действия пользователей content_owner_asset_basic_a2 content_owner_asset_basic_a3
Действия пользователей по регионам content_owner_asset_province_a2 content_owner_asset_province_a3
Места воспроизведения видео content_owner_asset_playback_location_a2 content_owner_asset_playback_location_a3
Источники трафика content_owner_asset_traffic_source_a2 content_owner_asset_traffic_source_a3
Тип устройства и операционная система content_owner_asset_device_os_a2 content_owner_asset_device_os_a3
Общее значение content_owner_asset_combined_a2 content_owner_asset_combined_a3

Автоматические финансовые отчеты (немузыкальный контент)

Отчеты для владельцев контента – отчеты о Shorts (немузыкальный контент)
Название отчета Предыдущая версия Последняя версия
Сводка по доходу от рекламы в разных странах content_owner_shorts_global_ad_revenue_summary_a1 content_owner_shorts_global_ad_revenue_summary_a2
Сводка по ежедневному доходу от рекламы content_owner_shorts_day_ad_revenue_summary_a1 content_owner_shorts_day_ad_revenue_summary_a2
Сводные данные о доходе от рекламы по странам content_owner_shorts_country_ad_revenue_summary_a1 content_owner_shorts_country_ad_revenue_summary_a2
Сводка по доходу от рекламы content_owner_shorts_ad_revenue_summary_a1 content_owner_shorts_ad_revenue_summary_a2

Отчеты, управляемые системой (нефинансовые)

Отчеты для владельцев контента – отчеты о заявках
Название отчета Предыдущая версия Последняя версия
Активные заявки content_owner_active_claims_a2 content_owner_active_claims_a3
Отчеты для владельцев контента – отчеты о метаданных видео
Название отчета Предыдущая версия Последняя версия
Метаданные видео content_owner_video_metadata_a3 content_owner_video_metadata_a4
Отчеты для владельцев контента – отчеты об объектах
Название отчета Предыдущая версия Последняя версия
Объекты content_owner_asset_a2 content_owner_asset_a3
Конфликты объектов content_owner_asset_conflict_a2 content_owner_asset_conflict_a3

24 апреля 2025 г.

Как было объявлено 26 марта 2025 года, API целевых запросов будет обновлен в рамках изменения подсчета просмотров Shorts:

  • Теперь будут учитываться как первые, так и повторные просмотры Shorts.views
  • Прежний способ подсчета просмотров будет использоваться для нового показателя engagedViews. engagedViews будет доступен во всех отчетах вместе с views.

Изменения вступят в силу 30 апреля 2025 г. для API целевых запросов. Не забудьте скорректировать запросы.

В этой истории изменений вы можете узнать, какие изменения будут внесены в Bulk Reports API и когда.

22 апреля 2025 г.

Как мы сообщали 7 апреля 2024 года, параметр isCurated больше не поддерживается в отчетах по каналам и плейлистам владельцев контента. С 31 декабря 2024 г. этот параметр больше не поддерживается. Этот параметр удален из отчетов и документации.

26 марта 2025 г.

В этом обновлении содержится следующее изменение, связанное с YouTube Аналитикой и YouTube Reporting API:

С 31 марта 2025 года просмотры Shorts будут считаться по-другому. Раньше просмотр Shorts засчитывался, если он длился определенное количество секунд. Теперь просмотры будут учитывать количество первых и повторных воспроизведений Shorts без требований к минимальному времени просмотра. Подробнее…

В YouTube Аналитике API (целевые запросы) и YouTube Reporting API (массовые отчеты) будут внесены следующие изменения:

  • Для Shorts views – это количество первых и повторных просмотров.
  • Появится новый показатель engagedViews, который будет рассчитываться по старой методике.
  • Если вы владелец канала или у вас есть доступ к его данным, то вы сможете смотреть как число просмотров, рассчитанное по новым стандартам, так и заинтересованные просмотры.

Целевые запросы будут обновлены до 30 апреля, а массовые отчеты – до 30 июня. До этого момента просмотры будут подсчитываться по старой методике. Количество просмотров Shorts и канала не будет совпадать с данными Аналитики в Творческой студии.

Кроме того, ранее объявленное прекращение поддержки отчета о ежедневных заявках (версия 1.0) было отложено.

В истории изменений можно посмотреть, когда были внесены изменения в API.

3 марта 2025 г.

В этом обновлении содержится следующее изменение, связанное с YouTube Reporting API:

Примечание. Это объявление о прекращении поддержки.

Ежедневный отчет о заявках (версия 1.0) больше не доступен партнерам. Поддержка этого протокола будет прекращена 30 апреля 2025 г. Определение этого отчета было соответствующим образом обновлено. Используйте вместо него отчет Daily Claims.

15 ноября 2024 г.

Примечание. Изменение, описанное ниже, вступит в силу 18 ноября 2024 г.

В документацию по YouTube Analytics API (целевые запросы) добавлено примечание о том, что для отчетов об источниках трафика метод reports.query API теперь возвращает ошибку, если произведение количества видео, по которым запрашиваются данные, и количества дней в диапазоне дат превышает 50 000. Например, запрос, который извлекает данные для 500 идентификаторов видео, может запрашивать данные максимум за 100 дней.

Это изменение затронет отчеты как для каналов, так и для владельцев контента.

Чтобы уменьшить количество строк, возвращаемых по запросу, разбейте его на несколько запросов, в которых указано меньше видео или заданы более короткие диапазоны дат. Как правило, для больших наборов данных рекомендуется использовать массовые отчеты.

6 мая 2024 г.

В YouTube Аналитике API (целевые запросы) теперь поддерживаются три новых отчета для каналов:

Кроме того, в отчет Удержание аудитории добавлены три новых показателя:

7 апреля 2024 г.

В YouTube Аналитике API (целевые запросы) внесены изменения, связанные с отчетами о плейлистах владельцев контента. Изменения аналогичны тем, которые были внесены в отчеты о плейлистах на канале и анонсированы 19 января 2024 года.

Следующая запись в истории изменений содержит почти ту же информацию, что и запись от 19 января 2024 г. Однако обратите внимание, что параметр isCurated будет поддерживаться в отчетах о плейлистах владельца контента до 31 декабря 2024 года, а в отчетах о плейлистах канала – до 30 июня 2024 года.

  • Примечание. Это объявление о прекращении поддержки.

    Параметр isCurated больше не поддерживается в отчетах о плейлистах владельца контента. Поддержка прекратится 31 декабря 2024 г. Определение этого параметра было соответствующим образом обновлено.

    Чтобы сохранить обратную совместимость при удалении параметра isCurated, вам также необходимо обновить код, чтобы получать показатель playlistViews вместо показателя views только для отчетов о плейлистах. Поскольку показатель views по-прежнему поддерживается в отчетах о плейлистах, хотя и с другим значением, API будет возвращать данные, даже если вы не измените название показателя. Конечно, вы можете изменить свое приложение, чтобы оно получало и показывало как views, так и playlistViews.

    Помимо параметра isCurated, в новых отчетах больше не поддерживаются следующие функции API:

    • Фильтры по местоположению, такие как continent и subcontinent, не поддерживаются в новых отчетах о плейлистах канала.
    • Показатели redViews и estimatedRedMinutesWatched больше не поддерживаются в новых отчетах о плейлистах на канале. Эти показатели не были доступны в Творческой студии YouTube, поэтому изменение приводит функциональность API в соответствие с функциональностью, доступной в приложении "Творческая студия".
    • Параметры subscribedStatus и youtubeProduct больше не поддерживаются в качестве фильтров для отчетов о плейлистах канала. Эти фильтры не были доступны в Творческой студии YouTube, поэтому изменение приводит функциональность API в соответствие с функциональностью, доступной в приложении "Творческая студия".

  • В документации по отчетам для владельцев контента обновлен раздел Отчеты о плейлистах. Теперь в нем более подробно описаны типы показателей, которые поддерживаются в отчетах о плейлистах.

    • Агрегированные показатели видео содержат данные о действиях пользователей и показах, агрегированные по всем видео в плейлистах владельца контента, которые также принадлежат этому владельцу. Агрегированные показатели видео поддерживаются только для запросов к API, в которых не используется параметр isCurated.
    • Показатели на странице плейлиста отражают действия и вовлеченность пользователей на странице плейлиста. Эти показатели включают данные о просмотрах видео, которые не принадлежат вам, но только если эти просмотры произошли в контексте плейлиста.
    • В разделе Поддерживаемые показатели плейлистов перечислены агрегированные показатели видео и показатели в плейлистах, которые поддерживаются в отчетах о плейлистах.

  • В отчетах о плейлистах для владельцев контента поддерживаются следующие новые показатели в плейлисте: Обратите внимание, что эти показатели поддерживаются, только если в запросе к API для получения отчетов не используется параметр isCurated. Определения показателей приведены в документации.

  • Поведение показателя views теперь зависит от того, использовался ли в запросе к API, который извлек отчет о плейлисте, параметр isCurated:

    • Если запрос содержит параметр isCurated, то показатель views относится к плейлистам и отражает количество просмотров видео в плейлистах владельца контента.
    • Если запрос не содержит параметр isCurated, то показатель views является агрегированным показателем видео, который указывает общее количество просмотров видео в плейлистах владельца контента, независимо от того, происходили ли эти просмотры в контексте плейлиста. В итоговое значение включаются только просмотры видео, принадлежащих владельцу контента, который связан с каналом, которому принадлежит плейлист.

      В этих отчетах не используется параметр isCurated, а показатель playlistViews отражает количество просмотров видео в плейлисте. Этот показатель учитывает просмотры всех видео в плейлисте, независимо от того, какому каналу они принадлежат.

  • В документации по отчетам для владельцев контента теперь есть таблицы с показателями, которые поддерживаются в отчетах о плейлистах. Набор показателей зависит от того, включен ли в запрос к API параметр isCurated. Пример приведен в разделе Отчеты о плейлистах за определенный период.

19 января 2024 г.

В YouTube Аналитике API (целевые запросы) внесены изменения, связанные с отчетами о плейлистах на канале. В частности, прекращена поддержка одного параметра, а также добавлены и обновлены несколько показателей.

  • Примечание. Это объявление о прекращении поддержки.

    Параметр isCurated больше не поддерживается в отчетах о каналах. Поддержка прекратится 30 июня 2024 г. Определение этого параметра было соответствующим образом обновлено.

    Чтобы сохранить обратную совместимость при удалении параметра isCurated, вам также необходимо обновить код, чтобы получать показатель playlistViews вместо показателя views только для отчетов о плейлистах. Поскольку показатель views по-прежнему поддерживается в отчетах о плейлистах, хотя и с другим значением, API будет возвращать данные, даже если вы не измените название показателя. Конечно, вы можете изменить свое приложение, чтобы оно получало и показывало как views, так и playlistViews.

    Помимо параметра isCurated, в новых отчетах больше не поддерживаются следующие функции API:

    • Фильтры по местоположению, такие как continent и subcontinent, не поддерживаются в новых отчетах о плейлистах канала.
    • Показатели redViews и estimatedRedMinutesWatched больше не поддерживаются в новых отчетах о плейлистах на канале. Эти показатели не были доступны в Творческой студии YouTube, поэтому изменение приводит функциональность API в соответствие с функциональностью, доступной в приложении "Творческая студия".
    • Параметры subscribedStatus и youtubeProduct больше не поддерживаются в качестве фильтров для отчетов о плейлистах канала. Эти фильтры не были доступны в Творческой студии YouTube, поэтому изменение приводит функциональность API в соответствие с функциональностью, доступной в приложении "Творческая студия".

  • В документации по отчетам на уровне канала обновлен раздел Отчеты о плейлистах. Теперь в нем более подробно описаны типы показателей, которые поддерживаются в отчетах о плейлистах.

    • Агрегированные показатели видео – это показатели действий пользователей и показов, агрегированные для всех видео в плейлистах канала, которые также принадлежат этому каналу. Агрегированные показатели видео поддерживаются только для запросов к API, в которых не используется параметр isCurated.
    • Показатели на странице плейлиста отражают действия и вовлеченность пользователей на странице плейлиста. Эти показатели включают данные о просмотрах видео, которые не принадлежат вам, но только если эти просмотры произошли в контексте плейлиста.
    • В разделе Поддерживаемые показатели плейлистов перечислены агрегированные показатели видео и показатели в плейлистах, которые поддерживаются в отчетах о плейлистах.

  • В отчетах о плейлистах для каналов поддерживаются следующие новые показатели в плейлисте: Эти показатели пока не поддерживаются в отчетах для владельцев контента. Обратите внимание, что эти показатели поддерживаются, только если в запросе к API для получения отчетов не используется параметр isCurated. Определения показателей приведены в документации.

  • Поведение показателя views теперь зависит от того, использовался ли в запросе к API, который извлек отчет о плейлисте, параметр isCurated:

    • Если запрос содержит параметр isCurated, то показатель views относится к плейлистам и указывает, сколько раз видео были просмотрены в плейлистах канала.
    • Если в запросе нет параметра isCurated, то показатель views будет агрегированным и будет отражать общее количество просмотров видео в плейлистах канала, независимо от того, были ли эти просмотры в контексте плейлиста. В итоговое значение включаются только просмотры видео, принадлежащих каналу, на котором размещен плейлист.

      В этих отчетах не используется параметр isCurated, а показатель playlistViews отражает количество просмотров видео в плейлисте. Этот показатель учитывает просмотры всех видео в плейлисте, независимо от того, какому каналу они принадлежат.

  • В документацию по отчетам о каналах добавлены таблицы с показателями, которые поддерживаются в отчетах о плейлистах. Набор показателей зависит от того, включен ли в запрос к API параметр isCurated. Пример приведен в разделе Отчеты о плейлистах за определенный период.

4 декабря 2023 г.

В YouTube Аналитике API (целевые запросы) объединены два значения параметра insightTrafficSourceType. Ранее этот параметр позволял различать просмотры видео в плейлисте (PLAYLIST) и просмотры со страницы, на которой перечислены все видео в плейлисте (YT_PLAYLIST_PAGE). Теперь оба типа просмотров будут связаны со значением параметра PLAYLIST.

15 декабря 2022 г.

В YouTube Аналитике API (целевые запросы) добавлены два новых параметра и один новый отчет:

  • В новом отчете представлены действия пользователей с разбивкой по городам. Отчет доступен владельцам каналов и владельцам контента. В этом отчете содержится новый параметр city, который позволяет определить, в каком городе, по оценке YouTube, совершались действия пользователя.

  • Новый параметр creatorContentType определяет тип контента YouTube, связанный с показателями действий пользователя в строке данных. Допустимые значения: LIVE_STREAM, SHORTS, STORY и VIDEO_ON_DEMAND.

    Параметр creatorContentType поддерживается в качестве необязательного для всех отчетов о видео на каналах и у владельцев контента.

  • В руководство по примерам запросов YouTube Analytics API добавлены примеры для обоих новых параметров.

  • Из документации удалены упоминания параметров 7DayTotals и 30DayTotals. О прекращении поддержки этих параметров было объявлено в октябре 2019 г.

26 августа 2022 г.

В YouTube Аналитике (целевые запросы) API и YouTube Reporting API (массовые отчеты) добавлено новое значение для детализации источников трафика:

  • В YouTube Analytics API (целевые запросы), если значение параметра insightTrafficSourceType равно SUBSCRIBER, то для insightTrafficSourceDetail можно задать значение podcasts, которое указывает, что трафик был перенаправлен со страницы подкастов.
  • В YouTube Reporting API (массовые отчеты), если значение параметра traffic_source_type – 3, то значение traffic_source_detail может быть установлено как podcasts. Это означает, что трафик поступил со страницы подкастов.

11 февраля 2022 г.

Набор допустимых значений для параметра gender изменится 11 августа 2022 г. или позже. Это может быть обратно несовместимое изменение в вашей реализации API. В соответствии с разделом Изменения, несовместимые с предыдущими версиями Условий использования сервисов YouTube API, мы объявляем об этом изменении за шесть месяцев до его вступления в силу. Чтобы переход на новые значения прошел без проблем, обновите реализацию API до 11 августа 2022 г.

Вот что изменится:

  • В YouTube Аналитике (целевые запросы) API параметр gender сейчас поддерживает два значения: female и male. С 11 августа 2022 г. этот параметр будет поддерживать три значения: female, male и user_specified.
  • В YouTube Reporting API (массовые отчеты) параметр gender в настоящее время поддерживает три значения: FEMALE, MALE и GENDER_OTHER. С 11 августа 2022 г. или позднее допустимыми значениями станут FEMALE, MALE и USER_SPECIFIED.

9 февраля 2022 г.

С 13 декабря 2021 г. из двух показателей исключен трафик, связанный с зацикленными клипами. Это изменение затронет как YouTube Аналитику (целевые запросы), так и YouTube Reporting API (массовые отчеты).

2 февраля 2022 г.

В YouTube Reporting API (массовые отчеты) поддерживается новое значение параметра источника трафика, которое указывает, что просмотры были получены в результате live-редиректов:

  • В YouTube Reporting API (массовые отчеты) параметр traffic_source_type поддерживает значение 28.

Для этого типа источника трафика параметр traffic_source_detail указывает идентификатор канала, с которого был перенаправлен зритель.

23 сентября 2020 г.

YouTube Analytics API (целевые запросы) и YouTube Reporting API (массовые отчеты) поддерживают новое значение параметра источника трафика, которое указывает, что зритель перешел к видео, пролистав ленту YouTube Shorts по вертикали:

  • В YouTube Analytics API (целевые запросы) параметр insightTrafficSourceType поддерживает значение SHORTS.
  • В YouTube Reporting API (массовые отчеты) параметр traffic_source_type поддерживает значение 24.

Параметр "Сведения об источнике трафика" (insightTrafficSourceDetail в YouTube Analytics API или traffic_source_detail в YouTube Reporting API) не заполняется для этого нового типа источника трафика.

20 июля 2020 г.

В этом обновлении описаны два изменения, которые затронут YouTube Аналитику (целевые запросы) API.

  • Максимальный размер группы отчетов YouTube Аналитика увеличен с 200 до 500 объектов.
  • Параметр filters метода reports.query определяет список фильтров, которые должны применяться при получении данных YouTube Аналитики. Этот параметр позволяет указывать несколько значений для фильтров video, playlist и channel, а максимальное количество идентификаторов, которые можно задать для этих фильтров, увеличено с 200 до 500.

13 февраля 2020 г.

В этом обновлении представлены следующие изменения, связанные с YouTube Аналитикой API (целевые запросы) и YouTube Reporting API (массовые отчеты). Подробную информацию об этих изменениях можно найти в Справочном центре YouTube.

В обоих API меняется набор возможных значений сведений об источнике трафика для уведомлений. В целевых запросах уведомления обозначаются как insightTrafficSourceType=NOTIFICATION. В массовых отчетах уведомления обозначаются как traffic_source_type=17.

Новые значения разделяют уведомления, связанные с загруженными видео и трансляциями, которые ранее обозначались как uploaded, на две категории:

  • uploaded_push – просмотры, полученные благодаря push-уведомлениям, которые были отправлены подписчикам после загрузки видео.
  • uploaded_other – просмотры, полученные благодаря уведомлениям, которые не являются push-уведомлениями, например уведомлениям по электронной почте или в папке "Входящие", отправленным подписчикам после загрузки видео.

Эти значения возвращаются для диапазона дат, начинающегося 13 января 2020 г.

Напоминаем, что эти значения представляют не сами уведомления, а источники трафика, которые привели к определенным просмотрам на YouTube. Например, если в строке отчета указано views=3, traffic_source_type=17 (NOTIFICATION) и traffic_source_detail=uploaded_push, это означает, что три просмотра были получены в результате нажатия на push-уведомления, отправленные при загрузке видео.

15 октября 2019 г.

В этом обновлении представлены следующие изменения, связанные с YouTube Аналитикой (целевые запросы) API:

  • Примечание. Это объявление о прекращении поддержки.

    YouTube прекращает поддержку параметров 7DayTotals и 30DayTotals. Вы можете получать данные по этим параметрам до 15 апреля 2020 г. После этой даты попытки получить отчеты с использованием параметра 7DayTotals или 30DayTotals будут возвращать ошибку.

    Обратите внимание, что пользователи могут воспроизвести некоторые данные для этих параметров, выполнив запрос с использованием параметра day и агрегировав или получив данные за 7- или 30-дневные периоды. Пример:

    • Количество просмотров за семь дней можно рассчитать, сложив количество просмотров за каждый день этого периода.
    • Чтобы рассчитать значение viewerPercentage за семь дней, нужно умножить количество просмотров за каждый день на значение viewerPercentage за этот день. Так вы получите количество зрителей, которые вошли в аккаунт перед просмотром видео в этот день. Затем можно сложить количество вошедших в аккаунт зрителей за весь период и разделить на общее количество просмотров за этот период, чтобы получить viewerPercentage за весь период.
    • Количество уникальных зрителей за семидневный период рассчитать невозможно, поскольку один и тот же зритель может быть учтен как уникальный в разные дни. Однако вы можете использовать параметр month вместо параметра 30DayTotals, чтобы экстраполировать данные о количестве уникальных зрителей за 30-дневный период. Обратите внимание, что параметр month относится к календарным месяцам, а параметр 30DayTotals рассчитывает 30-дневные периоды на основе указанных дат начала и окончания.

27 июня 2019 г.

В этом обновлении представлены следующие изменения, связанные с YouTube Аналитикой (целевые запросы) API:

  • Поскольку поддержка версии 1 API полностью прекращена, из документации удалены упоминания этой версии, включая уведомление о прекращении поддержки и руководство по переходу на версию 2.

1 ноября 2018 г.

В этом обновлении представлены следующие изменения, связанные с YouTube Аналитикой (целевые запросы) API:

  • Поддержка версии 1 API прекращена. Если вы ещё не сделали этого, как можно скорее обновите свои API-клиенты, чтобы они использовали версию 2 API. Это позволит свести к минимуму перебои в работе сервиса. Подробную информацию об этом вы найдете в руководстве по переходу.

    Обратите внимание, что график прекращения поддержки был объявлен 26 апреля 2018 г.

17 сентября 2018 г.

В этом обновлении представлены следующие изменения, связанные с YouTube Аналитикой (целевые запросы) API:

  • В обзорном документе Модель данных появился новый раздел Анонимизация данных. В нем объясняется, что некоторые данные YouTube Аналитики могут быть недоступны, если показатели не достигли минимальных значений. Это может произойти по разным причинам. На практике это означает, что отчет может не содержать всех или некоторых данных, если:

    1. видео или канал набрали недостаточно трафика за указанный период времени;

      или

    2. Вы выбрали фильтр или параметр, например источник трафика или страну, для которых значения не соответствуют определенному пороговому значению.

    В новом разделе также рассказывается о том, какие типы данных могут быть ограничены в отчетах YouTube Аналитики.

  • Документы Отчеты по каналу и Отчеты для владельцев контента были обновлены, чтобы отразить тот факт, что показатели redViews и estimatedRedMinutesWatched больше не поддерживаются для отчетов о месте воспроизведения, источнике трафика и типе устройства/операционной системе.

18 июня 2018 г.

В этом обновлении YouTube Аналитики (целевые запросы) API произошли следующие изменения:

  • Изменились требования к области действия для следующих методов:
    • Запросы к методу reports.query должны иметь доступ к области действия https://www.googleapis.com/auth/youtube.readonly.
    • Запросы к методу groupItems.list должны иметь доступ к одному из следующих ресурсов:
      • область действия https://www.googleapis.com/auth/youtube
        ;
      • область действия https://www.googleapis.com/auth/youtube.readonly
        и
        область действия https://www.googleapis.com/auth/yt-analytics.readonly

      В первом случае используется одна область действия, которая позволяет читать и записывать данные, а во втором – две области действия, которые позволяют только читать данные.

23 мая 2018 г.

В этом обновлении YouTube Аналитики (целевые запросы) API произошли следующие изменения:

22 мая 2018 г.

В этом обновлении представлены следующие изменения, связанные с YouTube Reporting (Bulk Reports) API:

  • В июле 2018 г. вступят в силу перечисленные ниже изменения. Новые правила будут применяться ко всем отчетам и заданиям по созданию отчетов.

    • После этого большинство отчетов API, в том числе отчеты о заполнении, будут доступны в течение 60 дней с момента создания. Однако отчеты со статистикой будут доступны в течение 30 дней с момента создания.

      Ранее все отчеты API были доступны в течение 180 дней с момента создания. Обратите внимание, что после вступления изменений в силу отчеты со статистикой, созданные более 30 дней назад, также станут недоступны через API. Все остальные отчеты, созданные более 60 дней назад, также станут недоступны. Поэтому в документации теперь указано, что отчеты, созданные до изменения правил, будут доступны не более 180 дней.

    • После этого изменения, когда вы запланируете задание по созданию отчетов, YouTube будет создавать отчеты, начиная с этого дня и за 30-дневный период до запланированного времени выполнения задания. До изменения, когда вы планировали задание по созданию отчета, YouTube генерировал отчеты за 180-дневный период до запланированного времени.

  • В раздел Рекомендации добавлено напоминание о том, что вы можете использовать YouTube Data API, чтобы получать дополнительные метаданные для ресурсов, указанных в отчетах. Как указано в Правилах для разработчиков, использующих сервисы YouTube API (разделы III.E.4.b–III.E.4.d), API-клиенты должны удалять или обновлять сохраненные метаданные ресурсов из этого API через 30 дней.

  • В раздел Характеристики отчетов добавлено примечание о том, что, хотя данные в отчетах не фильтруются, отчеты, содержащие данные за период времени, начинающийся 1 июня 2018 г. или позже, не будут содержать ссылок на ресурсы YouTube, удаленные по крайней мере за 30 дней до даты создания отчета.

  • В раздел Статистика обзора API добавлено примечание о том, что при планировании нового задания по созданию отчетов статистика обычно публикуется в течение нескольких дней. Ранее в документации говорилось, что на это может уйти до 30 дней.

  • Раздел Данные для заполнения в обзоре API был обновлен, чтобы более четко определить данные для заполнения как набор данных, который заменяет ранее предоставленный набор.

26 апреля 2018 г.

Версия 2 API YouTube Аналитики (целевые запросы) (v2) теперь доступна для всех. Ниже перечислены изменения в продукте и документации, связанные с новой версией API.

  • API версии 2 почти идентичен API версии 1. Однако вам, скорее всего, потребуется обновить код, чтобы отразить перечисленные ниже изменения. Все эти изменения подробно описаны в новом руководстве по переносу.

    • Версия API изменена с v1 на v2.
    • Базовый URL для запросов к API изменен с https://www.googleapis.com/youtube/analytics/v1 на https://youtubeanalytics.googleapis.com/v2.
    • Названия некоторых параметров метода reports.query были изменены. В частности, названия параметров, содержащие дефисы, например end-date в API версии 1, в API версии 2 используют верблюжий регистр (endDate). Это изменение обеспечивает единообразие названий параметров в API, поскольку в методах API для создания групп и управления ими уже использовался верблюжий регистр.
    • API версии 2 не поддерживает пакетные запросы, отправленные на глобальную конечную точку HTTP Google (www.googleapis.com/batch). Если вы отправляете пакетные запросы в API версии 2, вам нужно использовать конечную точку https://youtubeanalytics.googleapis.com/v2.

    Кроме того, в API версии 2 не поддерживаются некоторые функции версии 1:

    • Метод reports.query больше не поддерживает параметры запроса alt, quotaUser и userIp.
    • В API версии 2 нет конечной точки, которая поддерживает пакеты, состоящие из запросов к разным API. (Однако пакет может состоять из запросов к разным методам одного и того же API.) Это изменение касается не только YouTube Analytics API, но и всех остальных API Google.
    • API версии 2 не поддерживает протокол JSON-RPC, который поддерживался в API версии 1. Это изменение касается не только YouTube Analytics API.

  • Примечание. Это объявление о прекращении поддержки.

    Версия 1 API (v1) устарела и будет поддерживаться до 31 октября 2018 г. После этой даты все запросы к API версии 1 перестанут работать. Чтобы избежать проблем с доступом к данным YouTube Аналитики через API, перейдите на версию 2 до 31 октября 2018 года.

21 февраля 2018 г.

В этом обновлении YouTube Аналитики (целевые запросы) API произошли следующие изменения:

  • Отчеты об эффективности на основе демографических данных, в которых агрегируется статистика просмотров по возрастным группам и полу, больше не поддерживают параметр youtubeProduct, который определяет сервис YouTube, где произошли действия пользователя.

18 января 2018 г.

В это обновление вошли следующие изменения.

  • YouTube Reporting API (массовые отчеты)

    • Параметр operating_system, который позволяет определить системное ПО устройства, на котором выполнялось воспроизведение, теперь поддерживает следующее значение:
      • 25: KaiOS

  • YouTube Analytics API (целевые запросы)

    • Параметр operatingSystem поддерживает значение KAIOS.

20 декабря 2017 г.

В этом обновлении YouTube Reporting API произошли два изменения:

  • Сервер API теперь поддерживает сжатие в формате gzip для запросов на скачивание отчетов. Обратите внимание, что сжатие gzip не поддерживается для других типов запросов к API. Сжатие с помощью GZIP позволяет уменьшить объем ответов API. На распаковку ответов API требуется дополнительное процессорное время, однако экономия сетевых ресурсов того стоит.

    Чтобы получить ответ в архиве GZIP, задайте для заголовка HTTP-запроса Accept-Encoding значение gzip, как показано в примере ниже.

    Accept-Encoding: gzip

    Эта функция описана в обзоре API и в определении свойства downloadUrl ресурса report.

  • В документацию по параметрам age group и gender внесены исправления, чтобы в ней были представлены фактические значения, которые API возвращает для этих параметров. Обратите внимание, что это исправление в документации, а не изменение в функциональности или поведении API. В частности, изменились следующие значения:

    • Значения параметра age_group состоят из заглавных букв, содержат символы подчеркивания между словом AGE и числами в возрастной группе, а также используют символы подчеркивания вместо дефисов. Например, значения age13-17 и age18-24 были исправлены на AGE_13_17 и AGE_18_24 соответственно.
    • Значения параметра gender указываются заглавными буквами. Значения female, male и gender_other были исправлены на FEMALE, MALE и GENDER_OTHER.

10 августа 2017 г.

10 августа 2016 г. в этой документации было объявлено о прекращении поддержки показателя earnings в YouTube Analytics API. Одновременно в API была добавлена поддержка нового показателя estimatedRevenue, который предоставляет те же данные.

Поскольку показатель earnings был основным, он поддерживался в течение года с даты объявления. Теперь, когда этот период закончился, показатель earnings больше не поддерживается. В результате запросы к API, в которых указан показатель earnings, теперь возвращают код HTTP-ответа 400. Если вы ещё не обновили свое приложение, чтобы использовать показатель estimatedRevenue вместо earnings, сделайте это как можно скорее.

Из документации по API удалены оставшиеся упоминания показателя earnings.

6 июля 2017 г.

В это обновление вошли следующие изменения.

  • YouTube Analytics API (целевые запросы)

    • Документация по API была обновлена, чтобы отразить тот факт, что ответы API содержат данные до последнего дня в запрашиваемом диапазоне дат, для которого доступны все запрашиваемые показатели.

      Например, если в запросе указана дата окончания 5 июля 2017 г., а значения всех запрашиваемых показателей доступны только до 3 июля 2017 г., то в ответ будут включены данные только до этой даты. (даже если данные по некоторым из запрошенных показателей доступны за 4 июля 2017 г.).

    • Параметр adType теперь поддерживает значение reservedBumperInstream, которое относится к видеообъявлениям без возможности пропуска длительностью до 6 секунд, которые показываются перед видео. Формат объявления идентичен формату auctionBumperInstream, но этот тип относится к объявлениям, проданным на основе резервирования, а не аукциона.

  • YouTube Reporting API (массовые отчеты)

    • Параметр ad_type теперь поддерживает значение 20, которое относится к объявлениям-заставкам, проданным на основе резервирования. Объявления-заставки – это видеообъявления без возможности пропуска длительностью до 6 секунд, которые воспроизводятся перед видео. Обратите внимание, что значение 19 для этого параметра также относится к объявлениям-заставкам, которые продаются на аукционе, а не на основе резервирования.

    • Задания для следующих отчетов YouTube Reporting API были удалены:

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

      15 сентября 2016 г. мы объявили о прекращении поддержки этих типов отчетов, а 15 декабря 2016 г. они перестали создаваться. Ранее созданные отчеты были доступны в течение 180 дней с момента создания. Таким образом, некоторые отчеты были доступны до 15 июня 2017 г. Однако, поскольку отчеты больше не доступны, связанные с ними задания также не нужны.

24 мая 2017 г.

Все задания по созданию следующих отчетов YouTube Reporting API были удалены:

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

О прекращении поддержки этих типов отчетов было объявлено 22 июня 2016 г., а 22 сентября 2016 г. они перестали создаваться. Ранее созданные отчеты были доступны в течение 180 дней с момента создания. Таким образом, некоторые отчеты были доступны до 22 марта 2017 г. Однако, поскольку отчеты больше не доступны, связанные с ними задания также не нужны.

22 мая 2017 г.

В это обновление вошли следующие изменения.

  • YouTube Reporting API (массовые отчеты)

    • Параметр sharing_service, который позволяет определить, через какой сервис пользователи делились видео, теперь поддерживает следующие значения:
      • 85: YouTube Music
      • 86: YouTube Гейминг
      • 87: YouTube Детям
      • 88: YouTube TV

      Кроме того, в документации название, используемое для идентификации значения 52, было изменено на Kakao (Kakao Talk), чтобы его было проще отличить от значения 73 (Kakao Story). Это изменение не повлияет на работу API или классификацию видео, которыми делятся в этих сервисах.

  • YouTube Analytics API (целевые запросы)

    • Параметр sharingService теперь поддерживает следующие значения:
      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

28 марта 2017 г.

Владельцы каналов, у которых есть доступ к данным о доходе в YouTube Аналитике в Творческой студии, теперь могут получать эти данные через YouTube Analytics API.

17 марта 2017 г.

В это обновление вошли следующие изменения.

  • YouTube Analytics API поддерживает показатели redViews и estimatedRedMinutesWatched, которые относятся к просмотрам в YouTube Red. На самом деле API уже некоторое время поддерживает эти показатели, а YouTube Reporting API поддерживает оба показателя, как было объявлено 15 сентября 2016 г.

    • Показатель redViews отражает количество просмотров видео подписчиками YouTube Red.
    • Показатель estimatedRedMinutesWatched отражает, сколько минут подписчики YouTube Red смотрели видео.

    Документация по отчетам о каналах и отчетам для владельцев контента была обновлена, чтобы показать, какие отчеты поддерживают два новых показателя. Они поддерживаются во всех отчетах, в которых уже поддерживаются показатели views и estimatedMinutesWatched.

3 марта 2017 г.

В это обновление вошли следующие изменения.

  • YouTube Reporting API (массовые отчеты)

    • Определение параметра date было исправлено. Теперь в нем указано, что значение параметра относится к периоду, который начинается в 00:00 по тихоокеанскому времени и заканчивается в 23:59 по тихоокеанскому времени в указанный день, месяц и год. В зависимости от времени года тихоокеанское время соответствует UTC-7 или UTC-8.

      Обычно дата представляет собой 24-часовой период, но в дни перехода на летнее время она может составлять 23 часа, а в дни перехода на зимнее время – 25 часов. (Ранее в документации говорилось, что каждая дата представляет собой уникальный 24-часовой период и что тихоокеанское время всегда соответствует UTC-8.)

      Обратите внимание, что это исправление не влияет на фактическое поведение API.

    • Параметр operating_system, который определяет системное ПО устройства, на котором выполняется воспроизведение, теперь поддерживает следующие значения:
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia

    • Все задания для отчетов типа "content_owner_basic_a1" удалены. Этот тип отчетов был полностью упразднен 19 августа 2016 г., но ранее созданные отчеты content_owner_basic_a1 были доступны в течение 180 дней с момента создания. Таким образом, некоторые отчеты были доступны до 19 февраля 2017 г. Однако, поскольку отчеты больше не доступны, связанные с ними задания также не нужны.

  • YouTube Analytics API (целевые запросы)

    • В описание параметров, связанных с time periods, внесено исправление. Теперь в нем указано, что значение параметра относится к периоду, который начинается в 00:00 по тихоокеанскому времени и заканчивается в 23:59 по тихоокеанскому времени в указанный день, месяц и год. В зависимости от времени года тихоокеанское время соответствует UTC-7 или UTC-8.

      Обычно дата представляет собой 24-часовой период, но в дни перехода на летнее время она может составлять 23 часа, а в дни перехода на зимнее время – 25 часов. (Ранее в документации было указано, что тихоокеанское время – это UTC-8, и не упоминалось, что день может не представлять собой 24-часовой период.)

      Обратите внимание, что это исправление не влияет на фактическое поведение API.

    • В документацию по отчетам о каналах добавлено примечание о том, что в настоящее время в них не содержатся показатели дохода и эффективности объявлений. В результате область действия https://www.googleapis.com/auth/yt-analytics-monetary.readonly в настоящее время не предоставляет доступ к финансовым данным в отчетах по каналам.

    • Параметр operatingSystem поддерживает три новых значения:
      • FIREFOX
      • REALMEDIA
      • TIZEN

8 февраля 2017 г.

В YouTube Analytics API теперь поддерживается необязательный параметр include-historical-channel-data. Обратите внимание, что этот параметр используется только при получении отчетов владельца контента.

Этот параметр позволяет владельцу контента указать, что в ответ API должны быть включены данные о времени просмотра и просмотрах каналов за период времени до того, как каналы были связаны с владельцем контента. Значение параметра по умолчанию – false. Это значит, что в ответ API включаются только данные о времени просмотра и просмотрах, полученные после того, как каналы были связаны с владельцем контента.

Эти правила также применяются, если запрос к API извлекает данные для нескольких каналов:

  • Если значение параметра равно false, то данные о времени просмотра и количестве просмотров для любого канала будут возвращаться за период, начиная с даты, когда этот канал был связан с владельцем контента.

    Важно помнить, что разные каналы могли быть связаны с владельцем контента в разные даты. Если запрос к API извлекает данные для нескольких каналов, а значение параметра – false, то ответ API содержит данные о времени просмотра и просмотрах на основе даты связывания для каждого соответствующего канала.
  • Если значение параметра равно true, то в ответе возвращаются данные о времени просмотра и просмотрах для всех каналов на основе дат начала и окончания, указанных в запросе к API.

15 декабря 2016 г.

Следующие отчеты YouTube Reporting API больше не поддерживаются и были удалены из документации. Для каждого отчета доступна более новая версия. Объявление о прекращении поддержки этих отчетов было сделано 15 сентября 2016 г.

Список текущих типов отчетов в справочной документации по API также был обновлен.

11 ноября 2016 г.

В это обновление вошли следующие изменения.

В YouTube Reporting API добавлены три новых отчета о конечных заставках, а также новые параметры и показатели для этих отчетов. В отчетах представлена статистика показов и кликов конечных заставок, которые появляются после завершения видео.

  • Отчеты о конечных заставках

    • Отчет о конечных заставках для видео на канале содержит статистику по всем видео на канале.
    • Отчет о конечных заставках для видео владельца контента содержит статистику по видео на всех каналах владельца контента.
    • В отчете о конечных заставках для объектов владельца контента содержится статистика по объектам, связанным с видео, в которых показываются конечные заставки.

  • Параметры конечных заставок

    • end_screen_element_type – тип элемента конечной заставки, связанный со статистикой.
    • end_screen_element_id – уникальный идентификатор элемента конечной заставки.

  • Показатели конечных заставок

    Примечание. Данные по конечным заставкам доступны с 1 мая 2016 года.

    • end_screen_element_impressions – общее количество показов элементов конечной заставки. Показ регистрируется для каждого элемента конечной заставки.
    • end_screen_element_clicks – количество кликов по элементам конечной заставки.
    • end_screen_element_click_rate: CTR элементов конечной заставки.

    • Подробную информацию о том, как добавлять конечные заставки, вы найдете в Справочном центре YouTube.

  • Следующие отчеты больше не поддерживаются и были удалены из документации. Для каждого отчета доступна более новая версия. Объявление о прекращении поддержки этих отчетов было опубликовано 22 июня 2016 г.

8 ноября 2016 г.

В этом обновлении YouTube Analytics API произошли следующие изменения:

  • Поддержка показателей из списка ниже полностью прекращена. Как было объявлено 10 августа 2016 г., новые показатели, относящиеся к тем же данным, уже поддерживаются. В таблице ниже приведены старые и новые названия показателей.

    Устаревший показатель Новый показатель
    adEarnings estimatedAdRevenue
    impressionBasedCpm cpm
    impressions adImpressions
    redPartnerRevenue estimatedRedPartnerRevenue

27 октября 2016 г.

Теперь YouTube автоматически создает набор системных отчетов о доходах от рекламы для владельцев контента, у которых есть доступ к соответствующим отчетам в разделе Отчеты Творческой студии YouTube. Новые отчеты API, управляемые системой, предназначены для предоставления программного доступа к данным, которые также доступны в отчетах Творческой студии, скачиваемых вручную.

В обзоре отчетов, управляемых системой, кратко описываются новые отчеты и объясняется, как получить их через API. Этот процесс немного отличается от получения массовых отчетов для YouTube Аналитики, поскольку партнерам не нужно планировать задания для создания отчетов.

В свойство id ресурса reportType добавлен список системных отчетов, к которым можно получить доступ через API:

  • Ежемесячный доход от рекламы в видео по всему миру
  • Ежедневный доход от рекламы в видео по странам
  • Ежемесячный доход от рекламы по всему миру на объект
  • Ежедневный доход от рекламы по объектам и странам
  • Заявки (в этом отчете нет данных о доходе)

27 сентября 2016 г.

Примечание. Это объявление о прекращении поддержки.

Показатель uniques в YouTube Analytics API больше не поддерживается. Этот показатель не является основным и будет поддерживаться до 31 октября 2016 г.

15 сентября 2016 г.

В этом обновлении YouTube Reporting API произошли следующие изменения:

  • В API добавлены два новых показателя, связанных с просмотрами YouTube Red:

    • red_views – количество просмотров видео подписчиками YouTube Red.
    • red_watch_time_minutes – количество минут, в течение которых подписчики YouTube Red смотрели видео.

  • API поддерживает новые версии 20 отчетов. Все новые версии поддерживают новые показатели red_views и red_watch_time_minutes.

    Для каждого отчета номер в идентификаторе нового типа отчета на единицу больше, чем в идентификаторе старого типа отчета. (Старые версии этих отчетов больше не поддерживаются, как описано ниже в этой истории изменений.) Например, отчет channel_basic_a1 больше не поддерживается и заменен отчетом channel_basic_a2.

    Ниже перечислены идентификаторы новых типов отчетов.

  • Примечание. Это объявление о прекращении поддержки.

    Обратите внимание, что если у вас уже есть задания по созданию старых версий отчетов, перечисленных выше, вам нужно создать новые задания для переименованных отчетов. В связи с выпуском новых версий отчетов прекращена поддержка следующих версий:

    • channel_basic_a1
    • channel_province_a1
    • channel_playback_location_a1
    • channel_traffic_source_a1
    • channel_device_os_a1
    • channel_subtitles_a1
    • channel_combined_a1
    • content_owner_basic_a2
    • content_owner_province_a1
    • content_owner_playback_location_a1
    • content_owner_traffic_source_a1
    • content_owner_device_os_a1
    • content_owner_subtitles_a1
    • content_owner_combined_a1
    • content_owner_asset_basic_a1
    • content_owner_asset_province_a1
    • content_owner_asset_playback_location_a1
    • content_owner_asset_traffic_source_a1
    • content_owner_asset_device_os_a1
    • content_owner_asset_combined_a1

    Если у вас есть задания для этих отчетов, YouTube не будет создавать новые отчеты для этих заданий после 15 декабря 2016 г. Созданные отчеты будут доступны в течение 180 дней с момента создания.

19 августа 2016 г.

В этом обновлении содержится следующее изменение YouTube Reporting API:

  • Отчет content_owner_basic_a1 больше не поддерживается и удален из документации. YouTube больше не будет создавать новые отчеты этого типа, но уже созданные отчеты будут доступны в течение 180 дней с момента их создания.

    Вместо отчета content_owner_basic_a1 теперь используется отчет content_owner_basic_a2, как описано в записи истории изменений от 19 мая 2016 г.

11 августа 2016 г.

В это обновление вошли следующие изменения.

  • Новые Условия использования сервисов YouTube API (далее – Обновленные условия), подробно описанные в блоге YouTube для разработчиков, содержат множество изменений по сравнению с текущими Условиями использования. Помимо обновленных Условий, которые вступят в силу 10 февраля 2017 года, мы подготовили несколько сопроводительных документов, которые помогут вам разобраться в правилах.

    Полный набор новых документов описан в истории изменений обновленных Условий. Кроме того, в истории изменений будут отражаться будущие изменения в Обновленных условиях и сопутствующих документах.

10 августа 2016 г.

В этом обновлении:

  • YouTube Analytics API (целевые запросы)

    • Примечание. Это объявление о прекращении поддержки.

      Поддержка показателей, перечисленных в таблице ниже, прекращается. В то же время мы добавляем новые показатели, которые относятся к тем же данным. По сути, это означает, что старые показатели переименовываются, хотя YouTube Analytics API будет поддерживать оба названия показателей до дат прекращения поддержки, указанных в таблице.

      Старое название показателя Новое название показателя Дата поддержки
      earnings estimatedRevenue 10 августа 2017 г.
      adEarnings estimatedAdRevenue 4 ноября 2016 г.
      redPartnerRevenue estimatedRedPartnerRevenue 4 ноября 2016 г.
      impressionBasedCpm cpm 4 ноября 2016 г.
      impressions adImpressions 4 ноября 2016 г.

      Обратите внимание, что показатель earnings был основным, поэтому он будет поддерживаться в течение года с даты этого объявления. Остальные показатели, не являющиеся основными, будут поддерживаться в течение трех месяцев – до 4 ноября 2016 г.

      Например, до 4 ноября 2016 г. в запросе к API можно указать показатель impressionBasedCpm, показатель cpm или оба. Однако после этой даты будет поддерживаться только показатель cpm.

    • Параметр insightTrafficSourceType поддерживает два новых значения:
      • CAMPAIGN_CARD – этот источник трафика поддерживается только в отчетах для владельцев контента. Это значит, что просмотры были получены благодаря загруженным пользователями видео, на которые заявлены права и которые владелец контента использовал для продвижения.
      • END_SCREEN – данные о просмотрах, которые начались с конечной заставки другого видео.

      Для обоих новых источников трафика также можно получить отчет traffic source detail. В обоих случаях параметр insightTrafficSourceDetail позволяет определить, из какого видео был выполнен переход.

    • Параметр adType теперь поддерживает значение auctionBumperInstream, которое относится к видеообъявлениям без возможности пропуска длительностью до 6 секунд, которые показываются перед видео.

  • YouTube Reporting API (массовые отчеты)

    • Параметр traffic_source_type теперь поддерживает следующие значения:
      • 19 – этот источник трафика поддерживается только в отчетах для владельцев контента. Это значит, что просмотры были получены благодаря загруженным пользователями видео, на которые заявлены права и которые владелец контента использовал для продвижения.
      • 20 – данные о просмотрах, которые начались с конечной заставки другого видео.

      Для обоих новых источников трафика параметр traffic_source_detail определяет видео, из которого был перенаправлен зритель.

    • В список основных показателей API внесены исправления: добавлен показатель estimated_partner_revenue и удален показатель earnings. (Показатель earnings никогда не поддерживался в YouTube Reporting API.)

    • Параметр ad_type теперь поддерживает значение 19, которое относится к объявлениям-заставкам. Это видеообъявления без возможности пропуска длительностью до 6 секунд, которые воспроизводятся перед видео.

18 июля 2016 г.

В этом обновлении:

  • YouTube Analytics API (целевые запросы)

    • В списки поддерживаемых показателей для отчетов по каналам добавлены показатели карточек. Поддержка показателей подсказок в этих отчетах была добавлена 28 июня 2016 года. Подробную информацию об этом изменении можно найти в истории изменений за эту дату. Это следующие отчеты:
      • Основные действия пользователей из штатов США
      • Действия пользователей в штатах США за определенные периоды времени
      • Действия пользователей по регионам
      • Действия пользователей по статусу подписки
      • Действия пользователей по статусу подписки для провинций
      • Самые популярные видео по штатам
      • Лучшие видео для подписчиков и неподписанных зрителей

    • В списки фильтров для отчетов об удержании аудитории на канале и отчетов об удержании аудитории для владельцев контента внесены исправления. Теперь в них указано, что фильтр video является обязательным, а фильтр group не поддерживается.

      Ранее в документации для обоих отчетов было ошибочно указано, что отчет можно получить, используя один из этих двух фильтров или не используя ни один из них.

  • YouTube Reporting API (массовые отчеты)

    • В обзоре API исправлен раздел, в котором объясняется, как получить URL для скачивания отчета. Теперь в нем указано, что YouTube создает доступные для скачивания отчеты за дни, когда данные были недоступны. В таких отчетах есть строка заголовка, но нет дополнительных данных. Эта информация уже была обновлена в разделе Характеристики отчетов того же документа 12 апреля 2016 г.
    • Список параметров в отчете content_owner_asset_cards_a1 был исправлен, чтобы отразить, что в отчете используется параметр card_id. Ранее в документации было указано неправильное название параметра – card_title.

28 июня 2016 г.

В документацию по YouTube Analytics API добавлена информация о поддержке показателей, связанных с подсказками, в отчетах по каналам и владельцам контента. Новые поддерживаемые показатели:

Эти показатели поддерживаются в следующих типах отчетов:

22 июня 2016 г.

В этом обновлении YouTube Reporting API произошли следующие изменения. Первое изменение касается API в целом, а остальные – только отчетов владельцев контента.

  • В раздел Характеристики отчетов в обзоре API добавлено уточнение о том, что отчеты доступны через API в течение 180 дней с момента создания.

    Ранее в документации было указано, что отчеты доступны за период до 180 дней до даты отправки запроса к API. Хотя технически это тоже верно, исходный текст был, мягко говоря, довольно запутанным.

  • API поддерживает новые версии трех отчетов. В двух из этих отчетов также есть новые и переименованные показатели:

    • Отчет content_owner_ad_rates_a1 – это новая версия отчета content_owner_ad_performance_a1. Переименованный отчет идентичен предыдущей версии.

    • Два отчета, у которых появились новые версии, были переименованы:

      • Новая версия отчета content_owner_estimated_earnings_a1 называется content_owner_estimated_revenue_a1.
      • Новая версия отчета content_owner_asset_estimated_earnings_a1 называется content_owner_asset_estimated_revenue_a1.

      Оба переименованных отчета отличаются от своих предшественников следующим образом:

      • Они добавляют новый показатель estimated_partner_red_revenue, который позволяет оценить общий доход от подписок YouTube Red.
      • Они добавляют новый показатель estimated_partner_transaction_revenue, который позволяет оценить расчетный доход от транзакций, таких как платный контент и фан-фандинг, за вычетом возмещений, взимаемых с партнеров.
      • Они переименовывают показатель estimated_partner_ad_sense_revenue в estimated_partner_ad_auction_revenue.
      • Они переименовывают показатель estimated_partner_double_click_revenue в estimated_partner_ad_reserved_revenue.

    Обратите внимание, что если у вас уже есть задания по созданию старых версий этих отчетов, вам нужно создать новые задания для переименованных отчетов. В связи с выпуском новых версий отчетов прекращена поддержка отчетов content_owner_ad_performance_a1, content_owner_estimated_earnings_a1 и content_owner_asset_estimated_earnings_a1.

    Если у вас есть задания для любого из этих отчетов, то после 22 сентября 2016 г. YouTube не будет создавать новые отчеты для этих заданий. Созданные отчеты будут доступны в течение 180 дней с момента создания.

  • Определение свойства id ресурса reportType было обновлено, чтобы отразить текущий набор доступных отчетов.

  • Названия двух показателей в документации были исправлены, чтобы соответствовать названиям, которые появляются в отчетах. Это изменение касается только документации и не отражает изменения в содержании отчетов.

    • Показатель estimated_partner_adsense_revenue переименован в estimated_partner_ad_sense_revenue. Однако обратите внимание, что этот показатель представлен только в двух отчетах, которые будут удалены в рамках этого обновления. Как указано выше, в новых версиях этих отчетов этот показатель переименован в estimated_partner_ad_auction_revenue.
    • Показатель estimated_partner_doubleclick_revenue переименован в estimated_partner_double_click_revenue. Напоминаем, что этот показатель есть только в двух отчетах, которые будут удалены в рамках этого обновления. Как указано выше, в новых версиях этих отчетов этот показатель переименован в estimated_partner_ad_reserved_revenue.

  • Из документации по параметрам Reporting API удалены свойства elapsed_video_time_percentage и audience_retention_type. Эти параметры в настоящее время не поддерживаются ни в одном из отчетов, доступных через API.

19 мая 2016 г.

В этом обновлении YouTube Reporting API произошли следующие изменения:

  • API поддерживает новую версию отчета о действиях пользователя для владельцев контента. Идентификатор типа отчета для нового отчета – content_owner_basic_a2. В отличие от предыдущей версии отчета (content_owner_basic_a1), в новой версии поддерживаются показатели likes и dislikes.

    Если у вас уже есть задание на создание отчета content_owner_basic_a1, вам все равно нужно создать новое задание для отчета content_owner_basic_a2. YouTube не переводит владельцев контента на новую версию отчета автоматически и не создает задание для ее создания. В некоторых реализациях появление нового, неожиданного задания может быть критическим изменением.

    Одновременно с выпуском нового отчета прекращена поддержка отчета content_owner_basic_a1. Если у вас есть задание для такого отчета, то после 19 августа 2016 года YouTube не будет создавать новые отчеты для этого задания. Созданные отчеты будут доступны в течение 180 дней с момента создания.

  • Ресурсы reportType, job и report теперь поддерживают новое свойство, которое указывает, представляет ли связанный ресурс устаревший тип отчета:

    • Свойство deprecateTime ресурса reportType указывает дату и время, когда тип отчета перестанет поддерживаться. Это свойство имеет значение только для отчетов, которые были объявлены устаревшими. Значение представляет собой дату, когда YouTube прекратит создавать отчеты этого типа.

      После объявления о прекращении поддержки отчетов определенного типа YouTube продолжает создавать их ещё три месяца. Например, в этом обновлении от 19 мая 2016 г. сообщается о прекращении поддержки отчета content_owner_basic_a1. Таким образом, значение deprecateTime для этого типа отчета указывает на время 19 августа 2016 года, после которого YouTube прекратит создавать отчеты этого типа.

    • Свойство expireTime ресурса job указывает дату и время, когда срок действия задания истек или истечет. Это свойство имеет значение, если тип отчета, связанный с заданием, больше не поддерживается или если отчеты, созданные для задания, не скачивались в течение длительного периода времени. После этой даты YouTube больше не будет создавать новые отчеты для задания.

    • Свойство jobExpireTime ресурса report указывает дату и время, когда срок действия задания, связанного с отчетом, истек или истечет. Это свойство содержит то же значение, что и свойство expireTime в ресурсе job, как описано в предыдущем пункте этого списка.

  • Теперь метод jobs.create возвращает код HTTP-ответа 400 (Bad Request), если вы пытаетесь создать задание для устаревшего отчета. Кроме того, в документации к методу теперь перечислены другие причины, по которым запрос к API может завершиться ошибкой.

12 апреля 2016 г.

Это обновление содержит следующие изменения, которые затрагивают только YouTube Reporting API:

  • Теперь YouTube генерирует данные за 180-дневный период, предшествующий времени, на которое было запланировано первое создание отчета. Ранее Reporting API не предоставлял статистику. Это изменение затрагивает все задания, в том числе созданные до публикации этого объявления.

    Статистика публикуется по мере поступления, но для полного размещения всех данных за прошлые периоды требуется около месяца. Таким образом, через месяц после планирования задания отчета у вас будет доступ к данным примерно за семь месяцев. Статистика по вакансиям, созданным до этого объявления, должна быть опубликована в течение месяца после него.

    Обратите внимание, что статистика доступна только с 1 июля 2015 г. В результате задания, созданные до 28 декабря 2015 г., будут содержать статистику менее чем за 180 дней.

    Все эти изменения описаны в новом разделе Статистика в обзоре Reporting API.

  • В раздел Характеристики отчетов в обзоре YouTube Reporting API внесены следующие изменения:

    • Теперь в документации указано, что отчеты доступны в течение 180 дней после создания и, следовательно, могут быть скачаны клиентами API. Ранее в документации было указано, что отчеты доступны за период до шести месяцев до даты отправки запроса к API.

    • Документация была обновлена, чтобы отразить тот факт, что API теперь генерирует скачиваемые отчеты за дни, когда данные были недоступны. В таких отчетах будут только строки заголовков.

  • В YouTube Reporting API скоро появится поддержка автоматически создаваемых системных отчетов, содержащих данные о доходах от рекламы или доходах от подписок YouTube Red. Отчеты будут доступны владельцам контента, у которых уже есть доступ к скачиваемым вручную отчетам о доходах в Творческой студии YouTube. Таким образом, новые функции API обеспечат программный доступ к этим данным.

    В рамках подготовки к запуску отчетов, управляемых системой, мы объявляем о следующих изменениях в API:

    • Новое свойство systemManaged ресурса job указывает, описывает ли ресурс задание, которое генерирует отчеты, управляемые системой. YouTube автоматически создает системные отчеты для владельцев контента. Владельцы контента не могут изменять или удалять задания, которые создают эти отчеты.

    • Новый параметр includeSystemManaged метода jobs.list указывает, должен ли ответ API включать задания для отчетов, управляемых системой. Значение по умолчанию – false.

    • Новый параметр startTimeAtOrAfter метода jobs.reports.list указывает, что ответ API должен содержать отчеты, только если самые ранние данные в отчете относятся к указанной дате или более позднему периоду. Аналогично параметр startTimeBefore указывает, что ответ API должен содержать только отчеты, в которых самые ранние данные относятся к периоду до указанной даты.

      В отличие от параметра createdAfter, который относится ко времени создания отчета, новые параметры относятся к данным в отчете.

    • Новое свойство systemManaged ресурса reportType указывает, описывает ли ресурс отчет, управляемый системой.

    • Новый параметр includeSystemManaged метода reportTypes.list указывает, должен ли ответ API включать отчеты, управляемые системой. Значение по умолчанию – false.

28 марта 2016 г.

YouTube Reporting API и YouTube Analytics API теперь возвращают статистику просмотров для нескольких дополнительных сервисов обмена контентом.

  • В YouTube Reporting API параметр sharing_service поддерживает следующие новые значения:
    • 82: диалоговое окно системных действий iOS
    • 83: Google Inbox
    • 84: Android Messenger
  • В YouTube Analytics API параметр sharingService поддерживает следующие новые значения:
    • ANDROID_MESSENGER: Android Messenger
    • INBOX: Google Inbox
    • IOS_SYSTEM_ACTIVITY_DIALOG: диалоговое окно системных действий iOS

16 марта 2016 г.

В этом обновлении содержатся следующие изменения, которые затрагивают как YouTube Reporting API, так и YouTube Analytics API:

YouTube Reporting API

  • Параметр playback_location_type поддерживает два новых значения:
    • 7 – данные о просмотрах, которые произошли на главной странице YouTube, в фиде подписок или в другом разделе YouTube.
    • 8 – данные о просмотрах, которые произошли непосредственно на странице результатов Поиска на YouTube.
  • Параметр traffic_source_type теперь поддерживает значение 18. Это значение указывает, что просмотры видео были выполнены со страницы, на которой перечислены все видео в плейлисте. Этот источник отличается от источника типа 14, который указывает, что просмотры произошли во время воспроизведения видео в составе плейлиста.

YouTube Analytics API

  • Параметр insightPlaybackLocationType поддерживает два новых значения:
    • BROWSE – данные о просмотрах, которые произошли на главной странице YouTube, в фиде подписок или в другом разделе YouTube.
    • SEARCH – данные о просмотрах, которые произошли непосредственно на странице результатов Поиска на YouTube.
  • Параметр insightTrafficSourceType теперь поддерживает значение YT_PLAYLIST_PAGE. Это значение указывает, что просмотры видео были выполнены со страницы, на которой перечислены все видео в плейлисте. Этот источник отличается от источника PLAYLIST, который указывает, что просмотры произошли во время воспроизведения видео в составе плейлиста.

8 февраля 2016 г.

Из списка показателей, поддерживаемых YouTube Analytics API, удалены показатели, связанные с подсказками. (Ни в одном из отчетов этого API не было указано, что он поддерживает какие-либо показатели карточки.)

Обратите внимание, что вы по-прежнему можете получать показатели карточек с помощью YouTube Reporting API, который поддерживает эти показатели для многочисленных отчетов канала и владельца контента.

6 января 2016 г.

Теперь в YouTube Reporting API и YouTube Analytics API отдельно учитываются просмотры через Chromecast.

  • В YouTube Reporting API параметр operating_system использует значение 21 для идентификации просмотров через Chromecast.
  • В YouTube Analytics API параметр operatingSystem использует значение CHROMECAST для идентификации просмотров через Chromecast.

21 декабря 2015 г.

В документации названия показателей annotation_clickable_impressions и annotation_closable_impressions были обновлены в соответствии с названиями, возвращаемыми в отчетах. Ранее в документации использовались названия clickable_annotation_impressions и closable_annotation_impressions.

18 декабря 2015 г.

В соответствии с законодательством Европейского союза (ЕС) вы должны предоставлять конечным пользователям из ЕС определенную информацию и получать их согласие. Поэтому для конечных пользователей в Европейском Союзе вы должны соблюдать правила в отношении согласия пользователей из ЕС. Мы добавили уведомление об этом требовании в Условия использования YouTube API.

15 декабря 2015 г.

В этом обновлении содержатся следующие изменения, которые затрагивают YouTube Analytics API:

  • В YouTube Analytics API теперь поддерживаются три новых параметра воспроизведения, которые можно использовать в различных отчетах для каналов и владельцев контента:

    • liveOrOnDemand – этот параметр указывает, относятся ли данные в отчете к действиям пользователей во время прямой трансляции.
    • subscribedStatus. Этот параметр показывает, связаны ли показатели действий пользователей в данных со зрителями, которые подписаны на канал, где размещено видео или плейлист.
    • youtubeProduct – этот параметр позволяет определить ресурс YouTube, на котором пользователь совершил действие. Возможные значения: сайт YouTube (или приложение YouTube), YouTube Гейминг и YouTube Детям.

    В документацию добавлена информация о новых подробных отчетах о воспроизведении, которые доступны владельцам каналов и владельцам контента. Кроме того, во многие другие отчеты добавлено примечание о том, что один или несколько из этих параметров можно использовать в качестве параметров и/или фильтров.

  • Формат таблиц, описывающих отчеты, был изменен, чтобы вам было проще определить допустимые комбинации параметров, показателей и фильтров, которые можно использовать для получения каждого отчета. В таблице ниже показан новый формат отчета "Тип устройства" для каналов.

    Свойство Значение
    Параметры:
    Обязательно deviceType
    Используйте значение от 0. day, liveOrOnDemand, subscribedStatus, youtubeProduct
    Показатели:
    Используйте один или несколько views, estimatedMinutesWatched
    Фильтры:
    Используйте 0 или 1. country, province, continent, subContinent
    Используйте 0 или 1. video, group
    Используйте значение от 0. operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

    Терминология, описывающая обязательные и необязательные поля, объясняется в документации по отчетам для каналов и владельцев контента.

  • Теперь YouTube Analytics API автоматически удаляет объекты, для которых пользователь API не может получить данные, из фильтров, поддерживающих несколько значений (video, playlist и channel). Ранее сервер API возвращал ошибку, если у пользователя API не было доступа к данным хотя бы для одного из указанных объектов.

    Предположим, что пользователь отправляет запрос к API, в котором фильтр video содержит 20 идентификаторов видео. Пользователь владеет 18 видео. Однако один из идентификаторов видео относится к видео, принадлежащему другому каналу, а другой – к видео, которое было удалено и больше не существует. В этом случае вместо возврата ошибки сервер API теперь удаляет два видео, к которым у пользователя нет доступа, а ответ API содержит данные для 18 видео, принадлежащих пользователю API.

  • Если вы запрашиваете данные для пустой группы YouTube Аналитики (group), API теперь возвращает пустой набор данных, а не ошибку.

  • Теперь метод groupItems.insert YouTube Analytics API возвращает ошибку авторизации (код HTTP-ответа 403), если вы пытаетесь добавить объект в группу, но у вас нет доступа к этому объекту. Раньше API позволял добавлять объект в группу, но при попытке получить данные отчетов для этой группы возвращал ошибку авторизации.

  • Метод groups.list в YouTube Analytics API теперь поддерживает разбиение на страницы. Если ответ API не содержит все доступные группы, то параметр nextPageToken ответа указывает токен, который можно использовать для получения следующей страницы результатов. Чтобы получить дополнительные результаты, задайте это значение для параметра pageToken метода.

10 ноября 2015 г.

В это обновление вошли следующие изменения.

29 октября 2015 г.

В это обновление вошли следующие изменения.

  • В документацию по параметру date в YouTube Reporting API внесены исправления. Теперь в ней указано, что даты относятся к 24-часовому периоду, который начинается в 00:00 по тихоокеанскому времени (UTC-8). Ранее в документации было указано, что дата начинается в 00:00 по Гринвичу.

    Кроме того, в документацию по YouTube Analytics API добавлено примечание о том, что все параметры, связанные с датами (day, 7DayTotals, 30DayTotals и month), относятся к датам, начинающимся в 00:00 по тихоокеанскому времени (UTC-8).

  • Метод jobs.reports.list() в YouTube Reporting API теперь поддерживает параметр запроса createdAfter. Если этот параметр задан, то в ответе API будут перечислены только отчеты, созданные после указанной даты и времени, включая новые отчеты с дополненными данными. Обратите внимание, что значение параметра относится к времени создания отчета, а не к датам, связанным с возвращенными данными.

    Значение параметра – это временная метка в формате RFC3339 UTC "Zulu" с точностью до микросекунд. Пример: "2015-10-02T15:01:23.045678Z".

    Мы также обновили рекомендации по работе с YouTube Reporting API. В них рассказывается, как использовать параметр createdAfter, чтобы не обрабатывать один и тот же отчет несколько раз.

  • Определения свойства createTime ресурса job и свойств startTime, endTime и createTime ресурса report были исправлены. Теперь в них указано, что значения свойств точны до микросекунд, а не наносекунд. Кроме того, теперь во всех определениях точно указано, что значением свойства является временная метка.

8 октября 2015 г.

В это обновление вошли следующие изменения.

  • В документацию по параметру sharingService YouTube Analytics API добавлен список возможных значений. В список добавлено несколько новых сервисов.

    Определение параметра sharing_service в YouTube Reporting API также было обновлено, чтобы отразить новые допустимые значения. Значения перечисления, которые больше 59, являются новыми в списке.

24 сентября 2015 г.

В это обновление вошли следующие изменения.

  • Новый YouTube Reporting API позволяет запрашивать из YouTube Аналитики большие объемы данных по каналу или владельцу контента. Он предназначен для приложений, которые могут импортировать большие наборы данных и предоставляют инструменты для фильтрации, сортировки и анализа этих данных.

    Каждый отчет YouTube Reporting API содержит предопределенный набор параметров и показателей. (В отчетах YouTube Analytics API также используются показатели и параметры.) В отчете каждая строка данных имеет уникальную комбинацию значений параметров. Вы можете агрегировать данные по строкам на основе значений параметров, чтобы рассчитать показатели для отдельных видео, стран, трансляций, подписчиков и т. д.

    С помощью API можно планировать задания по созданию отчетов. Каждое задание определяет, какой отчет должен быть создан. После настройки задания YouTube создает ежедневный отчет, который можно скачать асинхронно. Каждый отчет содержит данные за уникальный 24-часовой период.

  • Хотя это разные API, YouTube Analytics API и YouTube Reporting API позволяют разработчикам получать данные YouTube Аналитики. Поскольку оба API предоставляют доступ к похожим наборам данных, документация по ним публикуется в виде единого набора.

    • На вкладке Guides (Руководства) в документации содержится информация, относящаяся к обоим API, в том числе инструкции по авторизации запросов к API.
    • На вкладке Массовые отчеты вы найдете справочную документацию и другие материалы, посвященные YouTube Reporting API.
    • На вкладке Targeted queries (Целевые запросы) содержится справочная документация и другие материалы, относящиеся к YouTube Analytics API.
    • На вкладке Примеры перечислены примеры кода, доступные для обоих API.
    • На вкладке Инструменты перечислены дополнительные ресурсы, которые помогут разработчикам внедрить любой из двух API.

20 августа 2015 г.

В это обновление вошли следующие изменения.

  • Документация по API была реструктурирована, чтобы упростить понимание API. Поэтому в этих изменениях не описываются новые функции:

    • Теперь в документации есть две страницы: одна со списком всех доступных отчетов для каналов, а другая – со списком всех доступных отчетов для владельцев контента. Ранее в документации были отдельные страницы для отчетов о видео на канале, отчетов о плейлистах на канале и т. д.

    • В новом обзоре модели данных мы постарались более понятно объяснить, как работает API. В частности, в этом документе объясняется, как YouTube использует показатели, параметры и фильтры для расчета значений в отчетах.

    • Метод reports.query, который используется для получения отчетов, теперь описан в отдельном документе. Информация на этой странице ранее была на некоторых других страницах. Новая страница разработана так, чтобы вам было проще определить, какую информацию нужно отправить для получения отчета.

22 июля 2015 г.

Это обновление содержит несколько изменений, которые касаются только владельцев контента:

  • Новый показатель adEarnings включает общий расчетный доход (чистый доход) от всех источников объявлений, проданных Google. Это не основной показатель. API поддерживает показатель adEarnings для любого отчета, в котором уже поддерживается показатель earnings.

    Кроме того, было исправлено определение показателя earnings, чтобы отразить тот факт, что его значение включает общий расчетный доход от всех источников рекламы, проданных Google, а также от источников, не связанных с рекламой. Ранее в определении было ошибочно указано, что показатель включает только доход от источников рекламы.

  • Поддержка показателя primaryAdGrossRevenue прекращена. Вместо этого используйте показатель grossRevenue.

  • Помимо показателя primaryAdGrossRevenue, в отчетах об эффективности объявлений больше не поддерживаются показатели monetizedPlaybacks и playbackBasedCpm. Однако эти показатели по-прежнему поддерживаются в некоторых отчетах о видеорекламе.

1 июня 2015 г.

В это обновление вошли следующие изменения.

  • Теперь API поддерживает два новых показателя для отчетов о видео: videosAddedToPlaylists и videosRemovedFromPlaylists. Списки отчетов о видео для каналов и владельцев контента были обновлены, чтобы вы могли определить, какие отчеты поддерживают новые показатели.

    • videosAddedToPlaylists – сколько раз видео, соответствующие запросу, были добавлены в плейлисты YouTube. Учитываются как плейлисты владельца видео, так и плейлисты других пользователей.
    • videosRemovedFromPlaylists – сколько раз видео, соответствующие запросу, были удалены из плейлистов YouTube. Видео могли быть удалены из плейлистов владельца видео или из плейлистов других каналов.

    Оба показателя включают плейлисты по умолчанию, например "Смотреть позже". При этом не учитываются плейлисты, в которые видео добавляются автоматически, например плейлист с загруженными видео или история просмотра. Также обратите внимание, что эти показатели отражают абсолютное количество добавлений и удалений. Например, если пользователь добавил видео в плейлист, затем удалил его и снова добавил, то в статистике будет указано, что видео было добавлено в два плейлиста и удалено из одного.

    Данные по этим показателям доступны с 1 октября 2014 г.

31 марта 2015 г.

В это обновление вошли следующие изменения.

  • С момента публикации этого объявления прекращается поддержка показателей favoritesAdded и favoritesRemoved. Оба показателя являются основными и подпадают под действие правил прекращения поддержки, изложенных в Условиях использования.

16 марта 2015 г.

В это обновление вошли следующие изменения.

  • Новый параметр currency позволяет получать показатели дохода в валюте, отличной от долларов США (USD). Если параметр задан, API конвертирует значения показателей earnings, grossRevenue, playbackBasedCpm и impressionBasedCpm в указанную валюту. Возвращаемые значения являются приблизительными и рассчитываются с использованием обменных курсов, которые меняются ежедневно.

    Значение параметра – трехбуквенный код валюты по стандарту ISO 4217. Значение по умолчанию: USD. В определении параметра содержится список поддерживаемых кодов валют.

25 февраля 2015 г.

В это обновление вошли следующие изменения.

  • Теперь с помощью API можно создавать группы в YouTube Аналитике и управлять ими, а также получать данные отчетов по этим группам.

    • Как создавать группы и управлять ими

      В этом обновлении представлены ресурсы group и groupItem для создания групп и управления ими.

      • Ресурс group представляет собой группу в Аналитике – настраиваемую коллекцию, в которую можно добавить до 200 каналов, видео, плейлистов или объектов. API поддерживает для этого ресурса методы list, insert, update и delete.
      • Ресурс groupItem представляет собой элемент в группе Аналитики. API поддерживает методы list, insert и delete для этого ресурса.

      Например, вы можете создать группу с помощью метода groups.insert, а затем добавить в нее элементы с помощью метода groupItems.insert.

    • Как получить данные отчета для группы

      В документацию по параметрам добавлен параметр group, который можно использовать в качестве фильтра для многих отчетов по каналам и отчетов для владельцев контента. Если вы используете фильтр group, API возвращает данные для всех элементов в этой группе. Обратите внимание, что в настоящее время API не поддерживает создание отчетов для групп объектов.

    Подробнее о группах в YouTube Аналитике рассказывается в Справочном центре YouTube.

13 февраля 2015 г.

В это обновление вошли следующие изменения.

  • API больше не поддерживает параметр show.

28 августа 2014 г.

В это обновление вошли следующие изменения.

  • Теперь API позволяет указывать несколько значений для параметров video, playlist, channel и show, когда они используются в качестве фильтров. Чтобы указать несколько значений, задайте для значения параметра filters список идентификаторов видео, плейлистов, каналов или шоу, разделенных запятыми, для которых следует отфильтровать ответ API. В значении параметра можно указать до 200 идентификаторов.

    Если вы указываете несколько значений для одного фильтра, вы также можете добавить этот фильтр в список параметров, которые вы указываете для запроса. Это правило действует, даже если фильтр не указан в качестве поддерживаемого параметра для определенного отчета. Если вы добавите фильтр в список параметров, API также будет использовать значения фильтра для группировки результатов.

    Полное описание этой функции приведено в определении параметра filters.

16 июля 2014 г.

В это обновление вошли следующие изменения.

  • Теперь при получении отчета о канале можно получить данные для канала аутентифицированного пользователя, установив для параметра ids значение channel==MINE. Вы также можете задать для параметра ids значение channel==CHANNEL_ID, чтобы получить данные для указанного канала.

  • Теперь API поддерживает отчеты о плейлистах, которые содержат статистику просмотров видео в плейлистах. Отчеты о плейлистах доступны каналам и владельцам контента.

    Во всех отчетах о плейлистах поддерживаются показатели views и estimatedMinutesWatched, а в некоторых – ещё и averageViewDuration.

    Кроме того, во всех отчетах о плейлистах поддерживаются следующие новые показатели: Обратите внимание, что в отчете учитываются только просмотры плейлистов в полной версии сайта.

    • playlistStarts – количество запусков плейлиста.
    • viewsPerPlaylistStart – среднее количество просмотров видео, которое было зафиксировано при каждом запуске плейлиста.
    • averageTimeInPlaylist – среднее время просмотра видео в плейлисте после его запуска (в минутах).

    В любом запросе на получение отчета о плейлисте должен использоваться фильтр isCurated, для которого должно быть задано значение 1 (isCurated==1).

  • Теперь API поддерживает отчет об удержании аудитории. Этот отчет позволяет оценить, насколько хорошо видео удерживает внимание зрителей. Новый параметр elapsedVideoTimeRatio позволяет узнать, какая часть видео была просмотрена. Он соотносится со следующими показателями:

    • Показатель audienceWatchRatio отражает абсолютное соотношение зрителей, которые смотрят видео в определенный момент. Он рассчитывается как отношение количества просмотров определенного фрагмента к общему числу просмотров видео.

      Обратите внимание, что за один просмотр видео некоторые его части могут быть воспроизведены несколько раз или не воспроизведены вообще. Например, если пользователи перематывают назад и смотрят один и тот же фрагмент видео несколько раз, то абсолютный коэффициент для этого фрагмента может быть больше 1.

    • Показатель relativeRetentionPerformance позволяет оценить интерес зрителей к вашему видео в сравнении с другими видео на YouTube такой же продолжительности. Значение 0 означает, что видео удерживает зрителей хуже, чем любое другое видео аналогичной длины, а значение 1 – что видео удерживает зрителей лучше, чем любое другое видео аналогичной длины. Медианное значение 0,5 означает, что половина видео такой же продолжительности удерживает зрителей лучше, а половина – хуже.

    Вы также можете использовать фильтр audienceType, чтобы в отчет включались только данные, связанные с обычными просмотрами, просмотрами объявлений TrueView In-Stream или просмотрами медийных объявлений TrueView. Органические просмотры – это просмотры, которые стали результатом действий пользователя, например поиска видео или нажатия на рекомендуемое видео.

  • В API добавлена поддержка нескольких новых показателей, связанных с аннотациями. Перечисленные ниже показатели можно получить с помощью любых отчетов, которые ранее поддерживали показатели annotationClickThroughRate и annotationCloseRate.

    • annotationImpressions – общее количество показов аннотаций.
    • annotationClickableImpressions – количество аннотаций, которые были показаны и на которые можно было нажать.
    • annotationClosableImpressions – количество аннотаций, которые были показаны и могли быть закрыты.
    • annotationClicks – общее количество кликов по аннотациям.
    • annotationCloses: общее количество закрытых аннотаций.

    Все новые показатели являются основными, и на них распространяются правила прекращения поддержки. Однако данные по новым показателям доступны только с 16 июля 2013 г. Данные по показателям annotationClickThroughRate и annotationCloseRate доступны с 10 июня 2012 г.

  • GOOGLE_SEARCH больше не указывается как отдельное значение для параметра insightTrafficSourceType. Теперь переходы из результатов поиска Google относятся к типу источника трафика EXT_URL. В результате также больше нельзя получить отчет insightTrafficSourceDetail, в котором для фильтра insightTrafficSourceType задано значение GOOGLE_SEARCH.

31 января 2014 г.

В это обновление вошли следующие изменения.

16 января 2014 г.

В это обновление вошли следующие изменения.

  • Документ с примерами запросов был переработан. Теперь примеры сгруппированы по категориям и представлены в виде вкладок, как в отчетах для каналов и владельцев контента. В новом дизайне примеры сгруппированы по следующим категориям:

    • Базовая статистика
    • По истечении интервала времени
    • География
    • место воспроизведения;
    • Источник трафика
    • Устройство/ОС
    • Демографические характеристики
    • Социальные сети
    • Доход/объявления (только для отчетов владельца контента)

  • В документ с примерами запросов добавлены новые примеры получения данных по провинциям в отчетах по каналам и владельцам контента.

    • Показатели для штатов США и округа Колумбия: Этот отчет содержит разбивку по провинциям для количества просмотров и других статистических данных по видео на канале. Данные охватывают штаты США и Вашингтон (округ Колумбия). В примере используется параметр province, а также параметр filters, чтобы ограничить ответ только результатами для США.

    • Демографические данные зрителей в Калифорнии (возрастная группа и пол). Этот отчет содержит статистику о возрастной группе и поле зрителей в Калифорнии, которые смотрели видео на канале или, в случае отчетов для владельцев контента, контент, на который заявлены права. В этом примере используется параметр filters, чтобы в ответе были только данные для определенной провинции.

  • В определение параметра province добавлено примечание о том, что если в значение параметра dimensions включено province, то запрос должен ограничивать данные США, включая country==US в значение параметра filters.

6 января 2014 г.

В это обновление вошли следующие изменения.

  • Документы со списками поддерживаемых отчетов о каналах и владельцах контента были обновлены. Вместо таблицы со всеми возможными отчетами в каждом документе отчеты сгруппированы по категориям:

    • Базовая статистика
    • По истечении интервала времени
    • География
    • место воспроизведения;
    • Источник трафика
    • Устройство/ОС
    • Демографические характеристики
    • Социальные сети
    • Лучшие видео

    Каждая категория представлена в виде вкладки. Нажмите на нее, чтобы посмотреть список поддерживаемых отчетов.

  • Теперь API поддерживает три новых географических параметра: province, continent и subContinent.

    • Параметр province позволяет получать статистику по штатам США и округу Колумбия. API поддерживает два варианта использования этого параметра:

      • API поддерживает два отчета, в которых статистика разбита по штатам. Оба отчета доступны как владельцам каналов, так и владельцам контента.

        • В отчете о базовой статистике приводится несколько показателей, в том числе число просмотров и расчетное время просмотра в минутах.
        • В отчете по времени представлена та же статистика, но данные агрегируются по дням, неделям, месяцам или 30-дневным периодам.

      • Чтобы в отчет попала статистика только по определенному штату, используйте параметр запроса filters. Этот тип фильтрации поддерживается в нескольких отчетах, включая отчеты о географических данных, местах воспроизведения, источниках трафика, устройствах, операционных системах, демографических данных и самых популярных видео.

    • Параметр continent содержит код статистического региона ООН, который идентифицирует континент. Этот параметр можно использовать только в качестве фильтра.

    • Параметр subContinent указывает код статистического региона ООН, который идентифицирует субрегион континента. Этот параметр также можно использовать только в качестве фильтра.

      Поскольку каждый субрегион связан только с одним континентом, нет необходимости использовать фильтр continent, если вы используете фильтр subContinent. Если в запросе используются оба параметра, API возвращает ошибку.

  • В документацию внесены исправления, и теперь параметр insightTrafficSourceDetail не включает значение insightTrafficSourceType PROMOTED в качестве допустимого значения фильтра.

30 сентября 2013 г.

В это обновление вошли следующие изменения.

  • Теперь на YouTube Analytics API распространяются правила прекращения поддержки, описанные в Условиях использования. Однако на неосновные параметры и показатели API правила прекращения поддержки не распространяются. На страницах Параметры и Показатели теперь перечислены основные параметры и показатели. Кроме того, в определениях на этих страницах теперь явно указаны основные параметры и показатели.

  • Теперь API поддерживает EXTERNAL_APP в качестве значения параметра insightPlaybackLocationType. В связи с этим с 10 сентября 2013 года воспроизведения больше не классифицируются как MOBILE, хотя мобильные воспроизведения, которые произошли до этой даты, по-прежнему будут классифицироваться с этим значением.

    Теперь воспроизведения на мобильных устройствах классифицируются как WATCH, EMBEDDED или EXTERNAL_APP в зависимости от типа приложения, в котором они происходят.

  • Теперь API поддерживает PLAYLIST в качестве значения параметра insightTrafficSourceType. Это значение указывает на то, что просмотры видео были получены из плейлиста. Ранее такие просмотры классифицировались с помощью категории YT_OTHER_PAGE параметра.

16 июля 2013 г.

В это обновление вошли следующие изменения.

  • Теперь API позволяет сортировать отчеты по нескольким параметрам и показателям. В документе с примерами запросов есть новый пример Сортировка запросов по нескольким параметрам/показателям, который демонстрирует эту функцию. Запрос извлекает данные об источнике трафика и имеет значение параметра sort, равное day,-views. Результаты отсортированы в хронологическом порядке, но в наборе результатов для каждого дня первая строка содержит данные для источника трафика, который сгенерировал наибольшее количество просмотров, вторая строка содержит данные для источника, который сгенерировал следующее по величине количество просмотров, и так далее.

  • В API теперь поддерживаются два новых параметра: deviceType и operatingSystem. С их помощью можно получать данные об устройствах, на которых зрители смотрят ваши видео. API поддерживает отчеты, в которых используется один или оба параметра.

    • Отчет deviceType позволяет получить данные о количестве просмотров и расчетном времени просмотра для разных типов устройств, включая компьютеры, мобильные устройства и планшеты. Вы также можете использовать фильтр operatingSystem, чтобы в отчете по типам устройств содержалась статистика только по устройствам с определенной операционной системой, например Android или iOS.

    • Отчет operatingSystem позволяет получить данные о количестве просмотров и расчетном времени просмотра для разных операционных систем, таких как Android, iOS, Linux и т. д. Вы также можете использовать фильтр deviceType, чтобы в отчете об операционных системах содержалась статистика только по определенному типу устройств, например по мобильным устройствам или планшетам.

    Новые отчеты о типах устройств и операционных системах доступны для каналов и владельцев контента.

  • В документ Примеры запросов добавлены три отчета об устройствах для каналов и три отчета об устройствах для владельцев контента.

  • Параметр insightPlaybackLocationType может возвращать значение YT_OTHER, которое обозначает просмотры, не классифицированные с помощью других значений параметра.

23 мая 2013 г.

В это обновление вошли следующие изменения.

10 мая 2013 г.

В это обновление вошли следующие изменения.

6 мая 2013 г.

В это обновление вошли следующие изменения.

  • Теперь API позволяет получать показатели времени просмотра (estimatedMinutesWatched, averageViewDuration и averageViewPercentage) в сочетании с другими показателями, включая показатели просмотров, взаимодействий, доходов и эффективности рекламы.

    Списки доступных отчетов для каналов и отчетов для владельцев контента были обновлены с учетом этого изменения. (В настоящее время списки короче, поскольку показатели времени просмотра можно получить в составе других перечисленных отчетов.)

    Документ Примеры запросов к API также был обновлен.

  • В отчеты, в которых используются параметры insightPlaybackLocationDetail и insightTrafficSourceDetail, внесены следующие улучшения:

    • Теперь они поддерживают необязательный фильтр country.

    • Теперь владельцы контента могут получать эти отчеты, используя любую из следующих новых комбинаций filter. Обратите внимание, что все эти комбинации также поддерживают необязательный фильтр country.

      • Подробные сведения о месте воспроизведения

        • channel,insightPlaybackLocationType==EMBEDDED
        • show,insightPlaybackLocationType==EMBEDDED
        • claimedStatus,insightPlaybackLocationType==EMBEDDED
        • uploaderType,insightPlaybackLocationType==EMBEDDED
        • uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED

      • Сведения об источнике трафика

        • channel,insightTrafficSourceType
        • show,insightTrafficSourceType
        • claimedStatus,insightTrafficSourceType
        • uploaderType,insightTrafficSourceType
        • uploaderType,claimedStatus,insightTrafficSourceType

3 мая 2013 г.

В это обновление вошли следующие изменения.

  • В новом документе Примеры запросов к API показано, как с помощью YouTube Analytics API получать отчеты разных типов. Каждый пример содержит краткое описание отчета, который извлекается по запросу, а также параметры, показатели, фильтры и параметры сортировки для запроса.

  • Параметр insightTrafficSourceType теперь поддерживает SUBSCRIBER в качестве допустимого значения. Это значение определяет просмотры видео, которые были получены из фидов на главной странице YouTube или из функций подписки YouTube. Если вы отфильтруете данные по этому источнику трафика, в поле insightTrafficSourceDetail будет указана лента на главной странице или другая страница, с которой были получены просмотры.

28 марта 2013 г.

В это обновление вошли следующие изменения.

  • Теперь API поддерживает два новых показателя, annotationClickThroughRate и annotationCloseRate, которые связаны с взаимодействием зрителей с аннотациями, показываемыми во время видео. В списках отчетов по каналам и отчетов для владельцев контента теперь указано, какие отчеты поддерживают новые показатели.

    • annotationClickThroughRate – отношение количества аннотаций, на которые нажимали зрители, к общему числу показов интерактивных аннотаций.
    • annotationCloseRate – отношение количества аннотаций, закрытых зрителями, к общему числу показов аннотаций.

21 марта 2013 г.

В это обновление вошли следующие изменения.

  • Теперь API поддерживает показатели дохода и эффективности объявлений, а также новые отчеты об эффективности объявлений. Показатели и отчеты доступны только партнерам по контенту, которые участвуют в Партнерской программе YouTube.

    • В новых отчетах поддерживаются показатели эффективности объявлений на основе воспроизведений и показов. Дополнительную информацию об отчетах об эффективности объявлений можно найти в документации по отчетам для владельцев контента.

    • Ниже перечислены новые показатели. Список отчетов для владельцев контента был обновлен, чтобы вы могли определить, какие отчеты, включая два новых, поддерживают эти показатели.

      • earnings – общий расчетный доход от всех источников объявлений, проданных Google.
      • grossRevenue – расчетный валовой доход от Google или партнеров DoubleClick.
      • primaryAdGrossRevenue – расчетный валовой доход от партнеров Google или DoubleClick, суммированный и классифицированный по основному типу объявлений для воспроизведений видео, которые охватывает отчет.
      • monetizedPlaybacks – количество воспроизведений, в ходе которых был выполнен хотя бы один показ объявления.
      • playbackBasedCpm – расчетный валовой доход за тысячу воспроизведений.
      • impressions – количество подтвержденных показов объявлений.
      • impressionBasedCpm – расчетный валовой доход за тысячу показов объявлений.

      Примечание. Подробную информацию вы найдете в определениях показателей.

    • Любой запрос, который извлекает прибыль или показатели эффективности объявления, должен отправлять токен авторизации, предоставляющий доступ с использованием новой области действия https://www.googleapis.com/auth/yt-analytics-monetary.readonly.

  • Документация по API была реорганизована, и теперь разные типы отчетов описаны на отдельных страницах. Поэтому мы создали отдельные страницы с описанием разных типов отчетов для каналов и отчетов для владельцев контента.

4 февраля 2013 г.

В это обновление вошли следующие изменения.

  • В справочное руководство по API добавлен раздел Примеры, в котором приведены примеры кода, демонстрирующие, как вызывать API с помощью клиентских библиотек Java, JavaScript, Python и Ruby. Пример кода JavaScript совпадает с тем, который подробно описан в документации по примеру приложения.

14 ноября 2012 г.

В это обновление вошли следующие изменения.

  • В справочнике по функциям API теперь есть APIs Explorer, который позволяет вызывать API, просматривать запросы к API и получать реальные данные в ответе.

  • API поддерживает ряд новых отчетов для каналов и владельцев контента, которые описаны ниже. Каждый отчет доступен как отчет по каналу или отчет для владельца контента. Страницы параметров и показателей также были обновлены.

    • В отчете о местах воспроизведения указано, сколько просмотров видео было зарегистрировано на страницах и в приложениях разных типов.

    • Подробный отчет о местах воспроизведения позволяет узнать, какие встроенные проигрыватели принесли больше всего просмотров определенному видео. В нем содержится более подробная информация, чем в отчете о местоположениях, поскольку в нем указаны URL, связанные с основными встроенными проигрывателями.

    • В отчете об источниках трафика указано, сколько просмотров видео было получено из разных источников.

    • В подробном отчете об источниках трафика указаны рефереры, которые принесли больше всего просмотров определенному видео и определенному типу источника трафика. Например, вы можете узнать, какие похожие видео принесли больше всего трафика определенному ролику. Этот отчет поддерживается для нескольких источников трафика.

    • В отчете о времени просмотра указано, сколько времени зрители провели за просмотром вашего контента. В отчетах можно агрегировать данные за определенный период времени (день, предыдущие семь дней, предыдущие 30 дней и т. д.) или по стране. Если в отчете данные агрегируются по дням или странам, в нем также может быть указана средняя продолжительность просмотра каждого видео и средний процент просмотренного видео.

2 октября 2012 г.

В это обновление вошли следующие изменения.

  • Теперь YouTube Analytics API доступен всем разработчикам. Вы можете активировать API для своего проекта, не запрашивая доступ, на панели Сервисы в APIs console.

  • В новом разделе Начало работы описаны требования и основные шаги по созданию приложения, использующего YouTube Analytics API.

12 сентября 2012 г.

В это обновление вошли следующие изменения.

  • В новом разделе Общие сведения об использовании квот приведены рекомендации по оптимизации использования квот API. Сервер API рассчитывает стоимость каждого запроса, и эта стоимость вычитается из вашей квоты на использование API. Поскольку стоимость запросов для разных типов отчетов может сильно различаться, вам следует эффективно использовать квоту, а ваше приложение должно запрашивать только те показатели и данные, которые ему действительно нужны.

  • Раздел Временные параметры обновлен. Теперь в нем объясняется, что эти параметры указывают на то, что отчет Аналитики должен агрегировать данные за определенный период времени. Теперь API поддерживает следующие дополнительные временные параметры:

    • 7DayTotals – данные в отчете будут агрегированы таким образом, чтобы каждая строка содержала данные за семидневный период.
    • 30DayTotals – данные в отчете будут агрегированы так, чтобы каждая строка содержала данные за 30-дневный период.
    • month – данные в отчете будут агрегированы по календарным месяцам.

    Раздел Доступные отчеты также был обновлен, чтобы отразить поддержку API для отчетов, в которых используются эти параметры.

  • В раздел Параметры объектов отчетов добавлено примечание о том, что запросы к API для получения отчетов владельца контента должны фильтровать данные с помощью одного из этих параметров (video, channel или show) или поддерживаемой комбинации параметров claimedStatus и uploaderType.

  • В API добавлены два новых варианта сортировки отчетов о самых популярных видео. Эти отчеты, доступные в виде отчетов по каналам или отчетов владельцев контента, содержат показатели (просмотры, комментарии, отметки "Нравится" и т. д.) по странам и разбивают эти показатели по видео. Теперь вы можете сортировать эти отчеты по количеству пользователей, которые подписались на канал или отменили подписку на него на странице просмотра видео.

  • Определения показателей subscribersGained и subscribersLost были обновлены. Теперь в них указано, что пользователи могут подписываться на канал и отменять подписку на него на странице просмотра видео, странице канала и в гиде на главной странице YouTube. Если эти показатели представлены в отчете по отдельному видео, они включают только статистику со страницы просмотра этого видео.