Обновления YouTube Analytics API и YouTube Reporting API: что учесть разработчикам

9 сентября 2026 года Google обновила документацию YouTube Analytics API и YouTube Reporting API. Изменения не затрагивают формат запросов, но уточняют важные детали: сколько времени занимает обработка данных, когда доступны денежные метрики, как API реагирует на некорректные параметры и почему в отчётах встречаются пустые значения.

Свежесть данных: задержка 48–72 часа

В разделе Data Model появилось пояснение о задержке обработки данных. API обрабатывает данные в течение 48–72 часов. Конечная дата в отчёте обрезается до последнего полностью обработанного дня.

Если нужно получить статистику по видео в реальном времени, документация рекомендует использовать метод YouTube Data API videos.list. Он предназначен для запроса актуальных данных, которые ещё могут не попасть в аналитические отчёты.

Денежные метрики: доступ для участников YPP

В документации по авторизации Channel Reports уточнены условия работы с финансовыми метриками. Расчётный доход и метрики эффективности рекламы поддерживаются для запросов с областью доступа https://www.googleapis.com/auth/ytanalyticsmonetary.readonly, если канал является участником партнёрской программы YouTube (YPP).

Для немонетизированных каналов запрос завершится ошибкой HTTP 403 Forbidden.

Ошибка 400 при несовместимых параметрах

В разделе Understanding report tables добавили предупреждение о совместимости параметров. Если комбинация dimension, metric и filter недопустима или содержит взаимоисключающие значения, API возвращает HTTP 400 badRequest с сообщением "The query is not supported."

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

Пустые значения dimension в массовых отчётах

Обновлены характеристики отчётов YouTube Reporting API. В столбцах dimension, например videoid или channelid, могут появляться пустые строки. Так API сохраняет агрегированные значения метрик для удалённых ресурсов и обозначает события уровня канала.

Пустое значение в dimension — не сбой, а часть модели данных. Его нужно учитывать при обработке массовых отчётов.

Где посмотреть изменения

Официальный список изменений опубликован в истории версий: YouTube Analytics API revision history.

Полезно: изменение помогает вовремя заметить новую возможность, правило или поведение сервиса.

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