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

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

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

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

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

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

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

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

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

• Соглашение об уровне обслуживания (SLA) в отношении актуальности данных и задержки: добавлен отдельный раздел в модель данных , объясняющий задержку обработки данных в 48–72 часа, ограничение даты окончания последним полностью обработанным днем ​​и рекомендацию использовать метод videos.list из API данных YouTube для получения статистики видео в реальном времени.

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

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

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

27 августа 2026 г.

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

Условия монетизации и большинство основных показателей эффективности остаются без изменений, поскольку они по-прежнему основаны на показателях вовлеченности. Доходы авторов по-прежнему будут рассчитываться на основе «просмотров коротких роликов, вызвавших вовлеченность» и «часов просмотра, вызвавших вовлеченность», которые можно посмотреть в разделе «Аналитика YouTube» > «Расширенный режим» .

Условия участия в партнерской программе YouTube остаются без изменений. Требования к участию в партнерской программе YouTube теперь также будут называться «количество просмотров коротких роликов, соответствующих условиям программы» и «количество часов просмотра, соответствующих условиям программы» (ранее — «количество просмотров коротких роликов, соответствующих условиям программы» и «количество часов просмотра, соответствующих условиям программы»).

Для получения более подробной информации см. раздел «Анализ эффективности вашего контента на YouTube» .

Обновления в документации API: обновлено определение метрики engagedViews в документации по метрикам API YouTube Analytics и метрикам API отчетов YouTube .

25 июня 2026 г.

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

9 марта 2026 г.

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

15 января 2026 г.

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

• Для каналов доступны отчеты 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 сентября 2025 года на 31 октября 2025 года. Предыдущие версии отчетов, обновленные с учетом изменений количества просмотров в Shorts, будут оставаться доступными до этого времени, за исключением отчета по претензиям версии 1.0 ( content_owner_active_claims_a1 ) и отчета по претензиям версии 1.1 ( content_owner_active_claims_a2 ), которые по-прежнему будут устаревать 30 сентября.

24 июня 2025 г.

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

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

Эти изменения вступают в силу с 30 июня 2025 года для API массовых отчетов. Обязательно внесите соответствующие корректировки в процесс обработки отчетов.

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

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

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

Массовые отчеты по данным для YouTube Analytics

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

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

24 апреля 2025 г.

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

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

Эти изменения вступят в силу с 30 апреля 2025 года для API целевых запросов. Обязательно скорректируйте свои запросы соответствующим образом.

Ознакомьтесь с историей изменений, чтобы узнать, какие изменения и когда будут внесены в API для создания массовых отчетов.

22 апреля 2025 г.

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

26 марта 2025 г.

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

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

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

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

Обновление целевых запросов будет произведено к 30 апреля, а обновление массовых отчетов — к 30 июня. До этого времени представления будут основаны на старой методологии. Представления коротких сообщений и каналов не будут совпадать с данными аналитики в Studio.

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

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

3 марта 2025 г.

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

Примечание: Это объявление об устаревании функции.

Отчет «Ежедневные претензии» (версия 1.0) устарел для партнеров. Его поддержка будет прекращена с 30 апреля 2025 года и позже. Соответственно, были обновлены характеристики этого отчета. Вместо него используйте последнюю версию отчета «Ежедневные претензии».

15 ноября 2024 г.

Примечание: Данное изменение вступает в силу с 18 ноября 2024 года.

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

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

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

6 мая 2024 г.

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

• Отчет « Активность пользователей по DMA» — это географический отчет, предоставляющий статистику активности пользователей по обозначенным рыночным зонам (DMA). Для этого отчета необходимо установить значение параметра filters равным country==US .

• В отчете «Одновременные зрители» отображается количество одновременных зрителей различных частей одной и той же прямой трансляции видео.

• В отчете «Отмена подписки» представлена ​​статистика, показывающая причины, по которым пользователи отменили свою подписку на канал .

  В этом отчете используется новый параметр membershipsCancellationSurveyReason , который указывает причину отмены пользователем членства в канале. Также используется новый показатель membershipsCancellationSurveyResponses , который показывает, сколько членств в канале было отменено по этой причине.

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

• startedWatching
• stoppedWatching
• totalSegmentImpressions

7 апреля 2024 г.

В API YouTube Analytics (целевые запросы) внесены несколько обновлений, касающихся отчетов по плейлистам владельцев контента. Эти обновления аналогичны обновлениям, касающимся отчетов по плейлистам каналов, о которых было объявлено 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 Studio, поэтому данное изменение приводит функциональность API в соответствие с функциональностью, доступной в приложении Studio.
  • Измерения subscribedStatus и youtubeProduct больше не поддерживаются в качестве фильтров для отчетов по плейлистам канала. Эти фильтры ранее не были доступны в YouTube Studio, поэтому данное изменение приводит функциональность API в соответствие с функциональностью, доступной в приложении Studio.

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

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

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

  • playlistAverageViewDuration
  • playlistEstimatedMinutesWatched
  • playlistSaves
  • playlistViews

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

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

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

19 января 2024 г.

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

• Примечание: Это объявление об устаревании функции.

  Параметр isCurated устарел для отчетов по каналам. Его поддержка прекратится 30 июня 2024 года и позже. Соответственно, определение этого параметра было обновлено.

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

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

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

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

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

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

  • playlistAverageViewDuration
  • playlistEstimatedMinutesWatched
  • playlistSaves
  • playlistViews

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

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

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

4 декабря 2023 г.

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

15 декабря 2022 г.

API YouTube Analytics (целевые запросы) поддерживает два новых измерения и один новый отчет:

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

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

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

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

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

26 августа 2022 г.

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

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

11 февраля 2022 г.

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

Вносятся следующие конкретные изменения:

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

9 февраля 2022 г.

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

• В API YouTube Analytics (целевые запросы) показатели averageViewDuration и averageViewPercentage исключают трафик зацикленных клипов по состоянию на 13 декабря 2021 года.
• В API отчетов YouTube (пакетные отчеты) показатели average_view_duration_seconds и average_view_duration_percentage исключают трафик зацикленных клипов по состоянию на 13 декабря 2021 года.

2 февраля 2022 г.

Этот API для создания отчетов на YouTube (массовые отчеты) поддерживает новое значение параметра «Источник трафика», указывающее на то, что просмотры произошли через прямые перенаправления :

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

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

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

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

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

Для этого нового типа источника трафика параметр детализации источника трафика — insightTrafficSourceDetail в API YouTube Analytics или traffic_source_detail в API отчетов YouTube — не заполнен.

20 июля 2020 г.

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

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

13 февраля 2020 г.

Это обновление содержит следующие изменения, касающиеся API аналитики YouTube (целевые запросы) и API отчетов YouTube (массовые отчеты). Подробнее об этих изменениях можно узнать в Справочном центре 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 г.

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

• Примечание: Это объявление об устаревании функции.

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

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

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

27 июня 2019 г.

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

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

1 ноября 2018 г.

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

• Version 1 of the API is now deprecated. If you have not done so already, please update your API clients to use version 2 of the API as soon as possible to minimize service disruptions. See the migration guide for more details.

  Note that the schedule for this deprecation was originally announced on April 26, 2018 .

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

This update contains the following changes related to the YouTube Analytics (Targeted Queries) API:

• The new data anonymization section in the Data Model overview document explains that some YouTube Analytics data is limited when metrics do not meet a certain threshold. This can happen in a variety of cases. In practice, it means that a report might not contain all (or any) of your data if:

  1. a video or channel has limited traffic during a specified time period,

     или