YouTube Reporting API

La API de informes de YouTube permite a los programadores programar trabajos de informes y luego descargar los informes masivos generados. La API admite un conjunto predefinido de informes, cada uno de los cuales contiene un conjunto integral de datos de YouTube Analytics para un canal o propietario de contenido.

Los siguientes pasos explican cómo programar trabajos de informes y recuperar informes:

  1. Llama al método reportTypes.list() para recuperar una lista de informes que puede recuperar un propietario del contenido o del canal.
  2. Llama al método jobs.create() para identificar el informe que se debe generar para un canal o propietario del contenido. Luego, puedes usar la jobs.list() y la jobs.delete() de la API para recuperar o cambiar la lista de informes que se generan.
  3. Llama al método jobs.reports.list() a fin de recuperar una lista de informes que se generaron para un trabajo en particular. Cada recurso de la respuesta contiene una propiedad downloadUrl que especifica la URL desde la cual se puede descargar el informe.
  4. Envía una solicitud autorizada de GET para recuperar el informe de la URL de descarga.

Autorización

Se deben autorizar todas las solicitudes de la API de informes de YouTube. La Guía de autorización explica cómo utilizar el protocolo OAuth 2.0 para recuperar tokens de autorización.

Las solicitudes de la API de informes de YouTube utilizan los siguientes alcances de autorización:

Permisos
https://www.googleapis.com/auth/yt-analytics.readonly Permite ver informes de YouTube Analytics sobre tu contenido de YouTube. Este alcance proporciona acceso a las métricas de actividad del usuario, como el número de reproducciones y de calificaciones.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly Permite ver informes monetarios de YouTube Analytics sobre tu contenido de YouTube. Este alcance proporciona acceso a las métricas de actividad del usuario y a las estimaciones de ingresos y de rendimiento de los anuncios.

Tipos de recursos

En las siguientes secciones, se proporcionan descripciones generales de los recursos y métodos de la API. Todos los URI de método que se muestran en las tablas están relacionados con https://youtubereporting.googleapis.com.

trabajos

Métodos
create POST /v1/jobs
Crea un trabajo de informes. Cuando creas un trabajo de informes, le indicas a YouTube que genere ese informe a diario. El informe está disponible dentro de las 24 horas posteriores a la creación del trabajo.
delete DELETE /v1/jobs/{jobId}
Borra un trabajo de informes.
get GET /v1/jobs/{jobId}
Recupera información sobre un trabajo de denuncia específico que se programó para un canal o propietario del contenido.
list GET /v1/jobs
Enumera los trabajos de informes que se programaron para un propietario del contenido o un canal. Cada recurso en la respuesta contiene una propiedad id, que especifica el ID que YouTube usa para identificar el trabajo de manera única. Necesita ese ID para recuperar la lista de informes que se generaron para el trabajo o para borrarlo.

informesdetrabajo

Métodos
get GET /v1/jobs/{jobId}/reports/{reportId}
Recupera los metadatos de un informe específico.
list GET /v1/jobs/{jobId}/reports
Enumera los informes que se generaron para el trabajo de informes especificado.

Tipos de informes

Métodos
list GET /v1/reportTypes
Muestra una lista de los tipos de informes que el propietario del contenido o del canal puede recuperar.