En este documento, se explican las similitudes y diferencias en las formas en que la API de YouTube Analytics y la API de YouTube Reporting proporcionan acceso a los datos de YouTube Analytics, de modo que puedas elegir la API adecuada para tu aplicación.
Ambas APIs te permiten recuperar datos de YouTube Analytics. Además, ambas APIs admiten a los propietarios de canales y de contenido de YouTube, cada uno de los cuales puede acceder a un conjunto específico de informes:
-
Informes de canales: contienen métricas de actividad de los usuarios para un canal especificado.
-
Informes de propietarios de contenido: recopilan métricas de todos los canales vinculados a un determinado propietario de contenido de YouTube. Por ejemplo, un sello discográfico podría recuperar un informe que contenga estadísticas combinadas de los canales de YouTube de todos los artistas del sello. Algunos informes de propietarios del contenido contienen métricas de actividad del usuario, mientras que otros contienen métricas relacionadas con los ingresos y el rendimiento de los anuncios.
La API de Reporting también permite que algunos propietarios de contenido accedan a informes de ingresos publicitarios administrados por el sistema. Los datos de los informes administrados por el sistema solo se pueden recuperar con la API de Informes.
Todas las solicitudes a las APIs de YouTube Analytics y de YouTube Reporting deben estar autorizadas por el propietario del canal o del contenido que posee los datos solicitados.
Contenido del informe
Los informes que recuperan las APIs contienen dos tipos de datos:
-
Dimensiones: criterios comunes que se utilizan para recopilar datos, como la fecha en que se produjo la actividad de los usuarios o el país donde se encuentran los usuarios.
En un informe, cada fila de datos tiene una combinación única de valores de dimensiones. Por lo tanto, la combinación de valores de dimensión de cada fila funciona como la clave principal de esa fila.
-
Las métricas son mediciones individuales de la actividad del usuario, el rendimiento de los anuncios o los ingresos estimados. Las métricas de actividad del usuario incluyen aspectos como los recuentos de vistas de videos y las calificaciones (Me gusta y No me gusta).
Elige la API adecuada para tu aplicación
- API de YouTube Analytics
- La API de YouTube Analytics admite búsquedas segmentadas en tiempo real para generar informes personalizados de YouTube Analytics. La API proporciona parámetros de filtrado y ordenamiento, por lo que la aplicación que realiza la llamada no necesita admitir estas funciones de forma nativa.
Cada solicitud a la API especifica el período para el que se devolverán los datos. La API también te permite recuperar conjuntos de datos semanales y mensuales. Por lo tanto, la aplicación que realiza la llamada no necesita almacenar conjuntos de datos recuperados ni estadísticas agregadas en rangos de fechas. - API de informes de YouTube
- La API de YouTube Reporting recupera informes masivos que contienen datos de YouTube Analytics de un canal o propietario del contenido. Está diseñada para aplicaciones que pueden importar grandes conjuntos de datos y que proporcionan herramientas para filtrar, ordenar y extraer esos datos.
Cada informe contiene un conjunto predefinido de campos. Usas la API para programar trabajos de informes, cada uno de los cuales identifica un informe que YouTube debe generar. Luego, YouTube genera un informe diario que se puede descargar de forma asíncrona. Cada informe contiene datos de un período único de 24 horas.
Además, YouTube genera automáticamente un conjunto de informes administrados por el sistema para los propietarios de contenido que tienen acceso a los informes correspondientes en YouTube Creator Studio. Estos informes proporcionan acceso programático a los datos de ingresos publicitarios.
Informes compatibles
En la siguiente tabla, se identifican los diferentes tipos de informes que puedes recuperar con las APIs. Las consultas segmentadas están disponibles a través de la API de YouTube Analytics, y los informes masivos, a través de la API de YouTube Reporting.
Es posible que los datos disponibles en una API no estén disponibles en la otra. Por ejemplo, la API de YouTube Analytics te permite recuperar métricas de actividad del usuario de forma semanal o mensual, pero la API de YouTube Reporting requiere que agregues esos datos por tu cuenta. Por otro lado, la API de YouTube Reporting admite informes de activos para los propietarios de contenido, pero esos datos no están disponibles en la API de YouTube Analytics.
| Tipos de informes | |
|---|---|
| Denuncias de videos | Se admite para canales (query o bulk) y propietarios de contenido (query o bulk). Los informes de videos proporcionan estadísticas de toda la actividad de los usuarios relacionada con los videos de un canal o de un propietario de contenido. Por ejemplo, estos informes contienen la cantidad de vistas que recibieron tus videos. En la API de YouTube Analytics, algunos informes de video de los propietarios de contenido también incluyen métricas de ingresos estimados y rendimiento de los anuncios. |
| Informes de lista de reproducción | Se admite para canales (query o bulk) y propietarios de contenido (query o bulk). Los informes de playlists proporcionan estadísticas relacionadas específicamente con las vistas de videos que se producen en el contexto de una playlist. La API de YouTube Reporting admite informes de retención de público para las playlists, pero la API de YouTube Analytics no admite un informe similar. |
| Informe de rendimiento de anuncios | Se admite para los propietarios de contenido (query o bulk). Los informes de rendimiento de anuncios proporcionan métricas basadas en las impresiones de los anuncios que se publicaron durante las reproducciones de video. Estas métricas tienen en cuenta cada impresión del anuncio, y cada reproducción de video puede generar varias impresiones. |
| Informes de ingresos estimados | Se admite para propietarios de contenido (de forma masiva). Los informes de ingresos estimados proporcionan los ingresos estimados totales de los videos provenientes de fuentes publicitarias vendidas por Google y de fuentes no publicitarias. Estos informes también contienen algunas métricas de rendimiento de los anuncios. Ten en cuenta que los informes administrados por el sistema contienen los ingresos reales. |
| Informes de activos | Se admite para propietarios de contenido (de forma masiva). Los informes de activos proporcionan métricas de actividad del usuario relacionadas con los videos vinculados a los activos de un propietario del contenido. Un video se incluye en el informe de un propietario de contenido si este lo reclamó como coincidencia de uno de sus activos. Es posible que el propietario del contenido o algún otro usuario de YouTube haya subido el video. |
| Informes administrados por el sistema | Esta función es compatible con los propietarios de contenido que tienen acceso a los informes correspondientes en el menú Informes de Creator Studio de YouTube. Los informes administrados por el sistema brindan datos sobre los ingresos reales que generan los activos y videos. En un informe adicional, se enumeran los videos reclamados y los activos con los que coinciden. No todos los informes de Creator Studio están disponibles en la API. Nota: YouTube genera automáticamente informes administrados por el sistema para los propietarios de contenido que tienen acceso a los informes correspondientes en Creator Studio. Por lo tanto, el proceso para recuperar estos informes es diferente al de los otros tipos de informes de esta lista. Consulta la documentación sobre los informes administrados por el sistema para obtener más información. |
Diferencias clave
En la siguiente tabla, se destacan las diferencias importantes entre las APIs de YouTube Analytics y de Informes.
| Función | API de YouTube Analytics | API de informes de YouTube |
|---|---|---|
| Proceso para recuperar datos | Cada solicitud a la API especifica las dimensiones y las métricas que se devolverán, así como el período para el que se devolverán los datos. | Las aplicaciones programan trabajos de informes. Para cada trabajo, YouTube genera informes diarios que se pueden descargar de forma asíncrona. |
| Intervalos de fechas | Algunos informes de la API especifican la fecha en que se produjo la actividad del usuario. Algunos de esos informes admiten dimensiones para agregar las métricas de actividad del usuario por mes. | Todos los informes de la API especifican el día en que se produjo la actividad del usuario. Las aplicaciones que usan la API pueden implementar funciones para agregar datos en intervalos periódicos. |
| Filtrado de datos | Puedes filtrar los informes para incluir solo las filas en las que una dimensión tiene un valor específico. La API también admite algunas dimensiones, como continent y subContinent, que se usan solo como filtros. | La API admite descargas masivas de conjuntos de datos completos. No admite el filtrado ni devuelve datos para las dimensiones de solo filtro. La aplicación cliente almacena los datos descargados y, luego, implementa sus propias funciones para filtrarlos. |
| Ordenar | Los informes se pueden ordenar según los valores de métricas devueltos. Algunos informes solo admiten una cantidad limitada de resultados. Por ejemplo, el informe que enumera los videos más vistos de un canal muestra un máximo de 200 filas. | Esta API admite descargas masivas de conjuntos de datos completos. Las aplicaciones cliente pueden implementar sus propias funciones para ordenar los datos descargados. |
| Enumeraciones | Los informes de la API contienen valores de texto, como "ANDROID" o "CHANNEL", para identificar los valores de dimensión enumerados. | Los informes de la API contienen números enteros que se pueden asignar a valores de texto. |
| Cuota | El servidor de la API evalúa cada consulta para determinar su costo de cuota. En la sección Uso de la cuota, se explica la metodología con más detalle. | El uso de la cuota no es un problema porque los datos se recuperan una vez y, luego, se filtran, ordenan y consultan dentro de la aplicación. |
| Informes únicos |
|
|
| Dimensiones únicas | group (dimensión solo para filtros) continent (dimensión solo para filtros) subContinent (dimensión solo para filtros) month viewsPerPlaylistStart averageTimeInPlaylist |
annotation_id annotation_type asset_id card_id card_type live_or_on_demand subscribed_status subtitle_language |
| Métricas únicas | uniques relativeRetentionPerformance viewsPerPlaylistStart averageTimeInPlaylist |
card_click_rate card_clicks card_impressions card_teaser_click_rate card_teaser_clicks card_teaser_impressions estimated_partner_adsense_revenue estimated_partner_doubleclick_revenue playlist_saves_added playlist_saves_removed |
Diferencias de nomenclatura entre las APIs
Las dos APIs usan diferentes convenciones de nomenclatura para identificar las dimensiones y las métricas. Los nombres de la API de YouTube Analytics usan camelCase, como adType. Los nombres de la API de YouTube Reporting están en minúsculas y usan guiones bajos, como ad_type.
En las siguientes tablas, se identifican los diferentes nombres que usan las dos APIs para identificar las mismas métricas y dimensiones. En algunos casos, la diferencia entre los dos nombres es mayor que la que obtendrías después de convertir un nombre de camelCase a guiones bajos. Por ejemplo, la dimensión video en la API de YouTube Analytics se llama video_id en la API de YouTube Reporting.