YouTube Reporting API

La API de YouTube Reporting permite a los desarrolladores 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 del contenido.

En los siguientes pasos, se explica 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 canal o un propietario del contenido.
  2. Llama al método jobs.create() para identificar un informe que se debe generar para un canal o propietario del contenido. Posteriormente, puedes usar jobs.list() y jobs.delete() de la API para recuperar o cambiar la lista de informes que se generan.
  3. Llama al método jobs.reports.list() para recuperar una lista de los informes que se generaron para un trabajo en particular. Cada recurso de la respuesta contiene una propiedad downloadUrl que especifica la URL desde la que se puede descargar el informe.
  4. Envía una solicitud GET autorizada para recuperar el informe de la URL de descarga.

Autorización

Todas las solicitudes a la API de YouTube Reporting deben estar autorizadas. En la guía de autorización, se explica cómo usar el protocolo de OAuth 2.0 para recuperar tokens de autorización.

Las solicitudes a la API de YouTube Reporting usan los siguientes permisos 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 métricas de rendimiento de los anuncios y los ingresos estimados.

Tipos de recursos

En las siguientes secciones, se proporcionan descripciones generales de los recursos y métodos de la API. Todos los URIs de métodos que se muestran en las tablas son relativos a https://youtubereporting.googleapis.com.

jobs

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 en un plazo de 24 horas a partir del momento en que se crea el trabajo.
delete DELETE /v1/jobs/{jobId}
Borra un trabajo de informes.
get GET /v1/jobs/{jobId}
Recupera información sobre un trabajo de informes 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 canal o propietario del contenido. Cada recurso de la respuesta contiene una propiedad id, que especifica el ID que YouTube usa para identificar de forma única el trabajo. Necesitas ese ID para recuperar la lista de informes que se generaron para el trabajo o para borrar el trabajo.

jobs.reports

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.

reportTypes

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