YouTube Reporting API

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

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

  1. Вызовите метод reportTypes.list() , чтобы получить список отчетов, которые может получить владелец канала или контента.
  2. Вызовите метод jobs.create() , чтобы определить отчет, который должен быть создан для канала или владельца контента. Впоследствии вы можете использовать API jobs.list() и jobs.delete() для извлечения или изменения списка генерируемых отчетов.
  3. Вызовите метод jobs.reports.list() , чтобы получить список отчетов, созданных для определенного задания. Каждый ресурс в ответе содержит свойство downloadUrl , указывающее URL-адрес, с которого можно загрузить отчет.
  4. Отправьте авторизованный запрос GET , чтобы получить отчет по URL-адресу загрузки.

Авторизация

Все запросы YouTube Reporting API должны быть авторизованы. В руководстве по авторизации объясняется, как использовать протокол OAuth 2.0 для получения токенов авторизации.

Запросы YouTube Reporting API используют следующие области авторизации:

Сферы
https://www.googleapis.com/auth/yt-analytics.readonly Просматривайте отчеты YouTube Analytics для своего контента на YouTube. Эта область обеспечивает доступ к показателям активности пользователей, таким как количество просмотров и оценка.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly Просматривайте финансовые отчеты YouTube Analytics для своего контента на YouTube. Эта область обеспечивает доступ к показателям активности пользователей, а также к показателям предполагаемого дохода и эффективности рекламы.

Типы ресурсов

В следующих разделах представлены общие описания ресурсов и методов API. Все URI методов, показанные в таблицах, относятся к https://youtubereporting.googleapis.com .

рабочие места

Методы
create POST /v1/jobs
Создает отчетное задание. Создавая отчетное задание, вы даете YouTube указание создавать этот отчет ежедневно. Отчет доступен в течение 24 часов с момента создания задания.
delete DELETE /v1/jobs/{jobId}
Удаляет отчетное задание.
get GET /v1/jobs/{jobId}
Извлекает информацию об определенном задании создания отчетов, которое было запланировано для канала или владельца контента.
list GET /v1/jobs
Список заданий отчетов, запланированных для канала или владельца контента. Каждый ресурс в ответе содержит свойство id , которое указывает идентификатор, который YouTube использует для уникальной идентификации задания. Этот идентификатор необходим для получения списка отчетов, созданных для задания, или для удаления задания.

рабочие места.отчеты

Методы
get GET /v1/jobs/{jobId}/reports/{reportId}
Извлекает метаданные для определенного отчета.
list GET /v1/jobs/{jobId}/reports
Список отчетов, созданных для указанного задания создания отчетов.

Типы отчетов

Методы
list GET /v1/reportTypes
Возвращает список типов отчетов, которые может получить владелец канала или контента.