Solicitudes de API de ejemplo

Esta página muestra ejemplos de solicitudes a la API de YouTube Analytics. En cada ejemplo, se describe brevemente el informe que se recupera y, luego, se muestran los valores de los parámetros dimensions, metrics, filters y sort correspondientes. (Los documentos Informes de canales e Informes de propietarios de contenido identifican los informes que la API admite).

Cada ejemplo se vincula al Explorador de API de Google y lo propaga con los valores que se muestran. En los ejemplos, también se usan las fechas de inicio y finalización predeterminadas (YYYY-MM-DD) de 2022-01-01 y 2022-06-30.

Después de la vinculación con el Explorador de API, aún debes especificar el canal o el propietario del contenido para el cual vas a recuperar los informes. El Explorador de API propagará el valor del parámetro ids con channel==MINE o contentOwner==CONTENT_OWNER_ID, según la consulta en la que hayas hecho clic. En el caso de los informes de canales, puedes cambiar MINE por el ID del canal del usuario autenticado. Para los informes de propietarios de contenido, debes reemplazar CONTENT_OWNER_ID con tu ID de propietario de contenido.

También debes autenticarte como el canal o propietario del contenido especificados para que el Explorador de API pueda autorizar tus solicitudes a la API mediante OAuth 2.0.

  1. Ordena solicitudes por varias dimensiones/métricas
  2. Informes de canales
  3. Informes de propietarios de contenido

Orden de solicitudes por múltiples dimensiones/métricas

La API admite la capacidad de ordenar los datos de respuesta usando múltiples dimensiones o métricas. Por ejemplo, la siguiente solicitud recupera datos de origen de tráfico diario para los videos de un canal en particular. Cada fila del conjunto de resultados identifica la cantidad de reproducciones y el tiempo de reproducción estimado que se originó a partir de un tipo de fuente de tráfico determinado (por ejemplo EXT_URL) en un día en particular.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedWatchTime
sort=day,-views

En la respuesta, los resultados se ordenan cronológicamente. Dentro del conjunto de resultados para cada día, los resultados se ordenan en forma descendente por cantidad de vistas. Así, la primera fila del conjunto de resultados contiene los datos de la fuente de tráfico que genera la mayor cantidad de reproducciones en el primer día del intervalo de fechas solicitado. La segunda fila contiene los datos de la fuente de tráfico que generó la siguiente mayor cantidad de reproducciones en el primer día.

Informes de canales

Estadísticas básicas

Denuncias de videos

Cantidad total de vistas, tiempo estimado de reproducción y otros datos de un canal

Esta consulta recupera métricas globales del contenido del canal. El informe muestra una sola fila de datos que contiene los totales de cada métrica solicitada durante el intervalo de fechas especificado.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration

Recuento de vistas específico del país (y otros datos) de un canal

Esta consulta recupera métricas para un país específico para los videos de un canal. El informe muestra una sola fila de datos que contiene los totales de cada métrica solicitada durante el intervalo de fechas especificado.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=country==US

Los 10 principales: Videos más vistos de un canal

Esta consulta recupera los 10 videos más vistos de un canal, medidos según la estimación de minutos vistos durante el intervalo de fechas especificado. Los resultados se ordenan por minutos estimados de reproducción en forma descendente.

Nota: Este informe requiere que especifiques un valor para el parámetro de solicitud sort y que establezcas el parámetro maxResults en un número entero de 10 o menos.

dimensions=video
metrics=estimatedMinutesWatched,views,likes,subscribersGained
maxResults=10
sort=-estimatedMinutesWatched

Los 10 principales: Tasas de clics de anotaciones para los videos más vistos de un canal

Esta solicitud recupera los recuentos de vistas, las tasas de clics de anotaciones y las tasas de cierres de anotaciones para las 10 videos más vistos del canal. Los resultados se ordenan por cantidad de reproducciones de forma descendente, lo cual significa que los videos más vistos aparecerán primero.

Nota: Este informe requiere que especifiques un valor para el parámetro de solicitud sort y que establezcas el parámetro maxResults en un número entero de 10 o menos.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
maxResults=10
sort=-views

Informes de lista de reproducción

Vistas totales de la lista de reproducción de un canal

Esta solicitud recupera el total de inicios de las listas de reproducción, los minutos de reproducción estimados, las vistas y las vistas por el inicio de las listas de reproducción en el canal del usuario autenticado. La métrica views solo cuenta las vistas de video que se produjeron en el contexto de una lista de reproducción.

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1

Estadísticas de una lista de reproducción específica

Esta solicitud recupera el total de inicios de las listas de reproducción, los minutos estimados de reproducción, las vistas y las vistas por el inicio de una lista de reproducción específica. La métrica views solo cuenta las vistas de video que se produjeron en el contexto de una lista de reproducción. Ten en cuenta que para ejecutar esta consulta en el Explorador de API, debes reemplazar la string PLAYLIST_ID por el valor del parámetro filters por el ID de la lista de reproducción en el canal del usuario autenticado.

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1;playlist==PLAYLIST_ID

Para recuperar las estadísticas globales de varias listas de reproducción, también puedes reemplazar la cadena PLAYLIST_ID por una lista separada por comas de hasta 500 ID de listas de reproducción de las listas de reproducción en el canal del usuario autenticado.

Los 10 principales: Listas de reproducción más vistas para un canal

Esta consulta recupera las 10 listas de reproducción más vistas de un canal, medida por los minutos de reproducción estimados durante el intervalo de fechas especificado. También recupera muchas otras métricas de la lista de reproducción, como la cantidad de veces que los espectadores iniciaron la reproducción de cada lista y la cantidad promedio de tiempo que un usuario miró videos en la lista de reproducción después de su inicio. Los resultados se ordenan por minutos estimados de reproducción en forma descendente.

Nota: Dado que este informe usa la dimensión playlist, debes especificar un valor para el parámetro de solicitud sort y también establecer el parámetro maxResults en un valor de número entero de 10 o menos.

dimensions=playlist
metrics=estimatedMinutesWatched,views,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
maxResults=10
sort=-estimatedMinutesWatched
Temporal

Denuncias de videos

Métricas de tiempo de reproducción diario para los videos de un canal

Esta consulta recupera diariamente la cantidad de vistas, las métricas de tiempo de reproducción y los nuevos recuentos de suscriptores para los videos de un canal. El informe muestra una fila de datos para cada día del intervalo de fechas solicitado. Las filas se ordenan en forma cronológica.

dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=day

Métricas de anotación diarias para los videos de un canal

Esta solicitud recupera diariamente la cantidad de vistas, las tasas de clics de anotaciones, los porcentajes de cierres de anotaciones y las impresiones de anotaciones para el contenido del canal. Los resultados se ordenan en forma cronológica.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day

Informes de lista de reproducción

Reproducciones diarias de las listas de reproducción de un canal

Esta solicitud recupera diariamente la cantidad de reproducciones, los inicios de listas de reproducción, los minutos vistos y las reproducciones por lista de reproducción del canal del usuario autenticado. Los resultados se ordenan en forma cronológica.

dimensions=day
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1
sort=day
Geográfico

Denuncias de videos

Métricas de tiempo de reproducción específicas de un país para los videos de un canal

Esta consulta recupera los recuentos de reproducciones específicos de cada país, las métricas de tiempo de reproducción y las cifras de suscripciones para los videos de un canal. El informe muestra una fila de datos para cada país en el que se reprodujeron los videos del canal. Las filas se ordenan en forma descendente, según la cantidad de minutos de reproducción.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatched

Métricas de anotaciones específicas del país para los videos de un canal

Esta solicitud recupera la cantidad de vistas, los porcentajes de conversiones posclic de anotaciones, los porcentajes de cierres de anotaciones y las impresiones de anotaciones para los videos del canal. Los resultados se ordenan por tasa de clics de anotaciones en forma descendente, lo que significa que el país con la mayor tasa de clics de anotaciones aparece en el primer lugar de la lista.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

Métricas específicas de la provincia para los estados de EE.UU. y Washington D.C.

Esta solicitud recupera un desglose por provincia de los recuentos de vistas, los minutos estimados de reproducción y la duración promedio de vistas de los videos del canal. Los datos abarcan los estados de EE.UU. y Washington D.C. Los resultados se ordenan alfabéticamente según los códigos ISO 3166-2 de las provincias.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Los 10 principales: Videos más reproducidos en un país específico

Esta consulta recupera los 10 videos más reproducidos del canal, medidos según la cantidad de reproducciones durante el intervalo de fechas especificado, en un país determinado. Los resultados se ordenan por recuento de vistas de forma descendente.

Nota: Este informe requiere que especifiques un valor para el parámetro de solicitud sort y que establezcas el parámetro maxResults en un número entero de 10 o menos.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views

Las 10 ciudades principales de EE.UU. por cantidad total de vistas

Esta consulta recupera una lista de las 10 ciudades de Estados Unidos que representaron la mayor cantidad de reproducciones del contenido del canal durante el intervalo de fechas especificado. La consulta podría modificarse a fin de solicitar datos de otro país si elige otro valor válido para ese filtro. De manera similar, la consulta podría modificarse para recuperar datos de un subcontinente, como Europa occidental o el Sudeste Asiático, mediante el filtro subContinent y uno de sus valores válidos. También se admiten otros filtros. Los resultados se ordenan por recuento de vistas de forma descendente.

    dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views

Las 10 ciudades principales de EE.UU. por cantidad total de vistas en cada tipo de contenido

Esta consulta recupera una lista de las 10 ciudades de Estados Unidos que representaron la mayor cantidad de reproducciones del contenido del canal durante el período especificado para cada creatorContentType admitido. Los resultados se ordenan por recuento de vistas de forma descendente.

    dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views

Las 10 ciudades principales de EE.UU. por tiempo de reproducción total

Esta consulta recupera una lista de los 10 días principales durante el intervalo de fechas especificado cuando cualquier ciudad de los EE.UU. representó el mayor tiempo de reproducción diario total del contenido del canal. Los resultados de la consulta identifican el tiempo de reproducción total, la fecha en la que ocurrió el tiempo de reproducción y la ciudad en la que se calculó la reproducción del contenido. Los resultados se ordenan en forma descendente según el tiempo de reproducción total.

    dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime

Los 10 principales: Los videos más vistos en Europa

Esta consulta recupera los 10 videos más reproducidos del canal en Europa, medidos según la cantidad de reproducciones durante el intervalo de fechas especificado. La consulta podría modificarse a fin de solicitar datos de otro continente con la elección de otro valor válido para ese filtro. De manera similar, la consulta podría modificarse para recuperar datos de un subcontinente, como Europa occidental o el Sudeste Asiático, mediante el filtro subContinent y uno de sus valores válidos. Los resultados se ordenan por recuento de vistas de forma descendente.

Nota: Este informe requiere que especifiques un valor para el parámetro de solicitud sort y que establezcas el parámetro maxResults en un número entero de 10 o menos.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views

Informes de lista de reproducción

Métricas de tiempo de reproducción específicas del país para las listas de reproducción de un canal

Esta consulta recupera métricas de tiempo de reproducción y recuentos de vistas específicos de cada país para las listas de reproducción de un canal. El informe muestra una fila de datos para cada país en el que se miraron las listas de reproducción del canal. Las filas se ordenan en forma descendente, según la cantidad de minutos de reproducción.

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
sort=-estimatedMinutesWatched

Las 10 principales: Listas de reproducción más iniciadas en Estados Unidos

Esta consulta recupera las 10 listas de reproducción que los espectadores de los Estados Unidos comenzaron a mirar con más frecuencia durante el período especificado. Los resultados se ordenan por cantidad de veces que la lista de reproducción comienza en orden descendente.

Nota: Dado que este informe usa la dimensión playlist, debes especificar un valor para el parámetro de solicitud sort y también establecer el parámetro maxResults en un valor de número entero de 10 o menos.

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts
Ubicación de reproducción

Denuncias de videos

Cantidad de reproducciones y tiempo de reproducción de diferentes ubicaciones de reproducción

Esta consulta recupera la cantidad de reproducciones y el tiempo de reproducción estimado para los videos de un canal en particular. Los resultados se agrupan según el tipo de página o aplicación en la que se produjeron las reproducciones de video, y los resultados se ordenan en forma descendente por recuento de vistas.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-views

Recuentos diarios de vistas y tiempo de reproducción de diferentes ubicaciones de reproducción

Esta consulta recupera diariamente la cantidad de reproducciones y el tiempo de reproducción estimado en los Estados Unidos para los videos de un canal en particular. Los resultados se agrupan por día para cada tipo de página o aplicación en la que se produjeron las reproducciones de video. Los resultados se ordenan en forma cronológica.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US
sort=day

Los 10 principales: Sitios de terceros que generan la mayor cantidad de reproducciones de un video integrado

Esta consulta recupera la cantidad de reproducciones y el tiempo de reproducción estimado para un video o grupo de videos en particular. Los resultados se agrupan según el sitio del tercero en el que se integró el video. Los resultados se ordenan en forma descendente por cantidad de vistas. Ten en cuenta que para ejecutar esta consulta en el Explorador de API, debes reemplazar la string VIDEO_ID por el valor del parámetro filters con una lista separada por comas de uno o más ID de video para los videos subidos.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Informes de lista de reproducción

Recuentos de vistas de listas de reproducción y tiempo de reproducción de diferentes ubicaciones de reproducción

Esta consulta recupera la cantidad de reproducciones, el tiempo de reproducción estimado y las reproducciones de las listas de reproducción de un canal en particular. Los resultados se recopilan según el tipo de página o aplicación en la que se produjeron las reproducciones de video, y los resultados se ordenan en forma descendente por inicio de lista de reproducción.

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts
filters=isCurated==1
sort=-playlistStarts

Recuento diario de vistas y tiempo de reproducción de diferentes ubicaciones de reproducción

Esta consulta recupera los inicios diarios de las listas de reproducción, los recuentos de reproducciones y el tiempo de reproducción estimado en Estados Unidos para las listas de reproducción de un canal en particular. Los resultados se agrupan por día para cada tipo de página o aplicación donde se visualizaron las listas de reproducción. Los resultados se ordenan en forma cronológica.

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,views,estimatedMinutesWatched
filters=isCurated==1;country==US
sort=day
Fuente de tráfico

Denuncias de videos

Cantidad de reproducciones y tiempo de reproducción de diferentes fuentes de tráfico en un país

Esta solicitud recupera la cantidad de reproducciones y la estimación de tiempo de reproducción para los videos del canal en un país determinado. Las métricas se recopilan por fuente de tráfico, lo que describe la manera en que los usuarios llegaron al video.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==US

Recuentos diarios de vistas y tiempo de reproducción de diferentes fuentes de tráfico

Esta solicitud recupera diariamente la cantidad de reproducciones y el tiempo de reproducción estimado para los videos del canal. Las métricas se recopilan a diario por fuente de tráfico y se ordenan en forma cronológica.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day

Los 10 principales: Términos de búsqueda de YouTube que generan la mayor parte del tráfico para un video

Esta consulta recupera los 10 términos de búsqueda que generaron la mayor cantidad de reproducciones de los resultados de búsqueda de YouTube para uno o más videos específicos. Los resultados se ordenan por recuento de vistas de forma descendente. Ten en cuenta que para ejecutar esta consulta en el Explorador de API, debes reemplazar la string VIDEO_ID por el valor del parámetro filters con una lista separada por comas de hasta 500 ID de video.

Por ejemplo, puedes ejecutar la consulta de un solo video o reemplazar VIDEO_ID para identificar los términos de búsqueda que generan la mayor cantidad de tráfico para ese video. También puedes hacer una lista de todos los videos en una lista de reproducción en particular para determinar qué términos de búsqueda generan el mayor tráfico para cualquiera de los videos en esa lista de reproducción.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Los 10 principales: Sitios web externos que generan el mayor tráfico para un video

Esta consulta recupera los 10 sitios web externos que generaron más reproducciones para un video o grupo de videos específicos. Los resultados se ordenan por tiempo estimado de reproducción en forma descendente. Ten en cuenta que para ejecutar esta consulta en el Explorador de API, debes reemplazar la string VIDEO_ID por el valor del parámetro filters con una lista separada por comas de hasta 500 ID de video por los videos subidos.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Informes de lista de reproducción

Recuentos de vistas de listas de reproducción y tiempo de reproducción de diferentes fuentes de tráfico en un país

Esta solicitud recupera la cantidad de reproducciones de listas de reproducción, inicios de listas de reproducción y tiempo de reproducción estimado para las reproducciones de las listas de reproducción en un país especificado. Las métricas se recopilan por fuente de tráfico, lo que describe la manera en que los usuarios llegaron a la lista de reproducción.

dimensions=insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1;country==US

Recuentos diarios de las listas de reproducción y el tiempo de reproducción de diferentes fuentes de tráfico

Con esta solicitud se recuperan las reproducciones diarias de la lista de reproducción, los inicios de una lista de reproducción y el tiempo de reproducción estimado para las reproducciones de la lista de reproducción. Las métricas se recopilan a diario por fuente de tráfico y se ordenan en forma cronológica.

dimensions=day,insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1
sort=day
Dispositivo/SO

Denuncias de videos

Métricas diarias de tipo de dispositivo para el sistema operativo Android

Esta consulta recupera diariamente la cantidad de reproducciones y el tiempo de reproducción estimado en los dispositivos Android para los videos de un canal en particular. Los resultados se agrupan por día para cada tipo de dispositivo en el que se produjeron las reproducciones de video. Los resultados se ordenan en forma cronológica.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=day

Métricas diarias de sistema operativo para dispositivos móviles

Esta consulta recupera diariamente la cantidad de reproducciones y el tiempo de reproducción estimado en los dispositivos móviles para los videos de un canal en particular. Los resultados se agrupan por día para cada sistema operativo en el que se produjeron las reproducciones de video. Los resultados se ordenan en forma cronológica.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=day

Métricas diarias de sistema operativo y tipo de dispositivo

Esta consulta recupera diariamente la cantidad de vistas y el tiempo de reproducción estimado para un canal. Las estadísticas se agrupan según el sistema operativo y el tipo de dispositivo. Los resultados se ordenan en forma cronológica.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Informes de lista de reproducción

Métricas diarias de tipo de dispositivo para las vistas de listas de reproducción en el sistema operativo Android

Esta consulta recupera diariamente la cantidad de reproducciones de la lista de reproducción y el tiempo de reproducción estimado en los dispositivos Android para las listas de reproducción de un canal en particular. Los resultados se agrupan por día para cada tipo de dispositivo donde se vieron las listas de reproducción. Los resultados se ordenan en forma cronológica.

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched
filters=isCurated==1;operatingSystem==ANDROID
sort=day

Métricas diarias de sistema operativo para vistas de listas de reproducción en dispositivos móviles

Esta consulta recupera diariamente la cantidad de reproducciones de la lista de reproducción y el tiempo de reproducción estimado en los dispositivos móviles para las listas de reproducción de un canal en particular. Los resultados se agrupan por día para cada sistema operativo en el que se produjeron las vistas de listas de reproducción. Los resultados se ordenan en forma cronológica.

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=isCurated==1;deviceType==MOBILE
sort=day
Datos demográficos

Denuncias de videos

Datos demográficos de los espectadores en California (edad y género)

Este informe recupera estadísticas sobre el grupo etario y el sexo de los espectadores en California que miraron los videos del canal. Los resultados se ordenan por sexo y, luego, por edad. Esta consulta se podría modificar a fin de recuperar las mismas estadísticas para todos los usuarios de todo el mundo o todos los usuarios de un país, continente, subcontinente o cualquier otro estado de EE.UU. ajustando el valor del parámetro filters.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

Informes de lista de reproducción

Datos demográficos del espectador de la lista de reproducción en California (edad y género)

Este informe recupera estadísticas sobre el grupo etario y el género de los espectadores en California que miraron las listas de reproducción del canal. Los resultados se ordenan por sexo y, luego, por edad. Esta consulta se podría modificar a fin de recuperar las mismas estadísticas para todos los usuarios de todo el mundo o todos los usuarios de un país, continente, subcontinente o cualquier otro estado de EE.UU. ajustando el valor del parámetro filters.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=isCurated==1;province==US-CA
sort=gender,ageGroup
Social

Métricas de uso compartido, recopiladas por servicio donde se compartieron videos

Esta solicitud recupera la cantidad de veces que los usuarios utilizaron el botón Share para compartir los videos de un canal. Los resultados se recopilan por servicio de uso compartido (Google+, Twitter, etc.) y se ordenan en forma descendente por cantidad de usos compartidos.

dimensions=sharingService
metrics=shares
sort=-shares
Retención de público

Métricas de retención de público de un video

Este informe mide la capacidad de un video para retener su público. El informe solo se puede recuperar para un video a la vez. Ten en cuenta que para ejecutar esta consulta en el Explorador de API, debes reemplazar la string VIDEO_ID por el valor del parámetro filters con el ID de video de uno de tus videos subidos. Ten en cuenta que los informes de retención de público no admiten la capacidad de especificar varios valores para el filtro video.

En este ejemplo, el informe usa el filtro audienceType para restringir la respuesta, de modo que solo contenga datos de vistas orgánicas, que son el resultado de una acción directa del usuario, como una búsqueda de un video o un clic en un video sugerido. Por lo tanto, el informe no incluye datos para las vistas de anuncios TrueView In-stream ni TrueView en display. Puedes quitar el filtro para recuperar los datos de retención de público del video en todos los tipos de público.

Ten en cuenta que los datos del filtro audienceType están disponibles desde el 25 de septiembre de 2013. La API no mostrará datos de las consultas que usan el filtro para intentar recuperar datos de fechas anteriores. Las consultas que no utilizan el filtro funcionan para ninguna fecha posterior al 1 de julio de 2008.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC
Ingresos/anuncios

Métricas de ingresos por canales y rendimiento de los anuncios

Esta solicitud recupera las métricas de ingresos y de rendimiento de los anuncios de un canal. El informe muestra una sola fila de datos que contiene los totales de cada métrica solicitada durante el intervalo de fechas especificado.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Métricas diarias de ingresos y rendimiento del anuncio

Con esta solicitud se recuperan los ingresos diarios de un canal y las métricas de rendimiento de los anuncios.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Métricas de ingresos y rendimiento del anuncio específicos por país

Con esta solicitud se recuperan los ingresos por país y las métricas de rendimiento de los anuncios de un canal. Los resultados se ordenan de forma descendente según el importe de los ingresos, lo que significa que el primer país que aparezca será el que tenga más ingresos netos del socio.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue

Los 10 principales: Videos con los mayores ingresos

Esta solicitud recupera las métricas de ingresos y de rendimiento de los anuncios para los 10 videos del canal con los mayores ingresos. Los resultados se ordenan en forma descendente por cantidad de ingresos, lo que significa que el primer video será el que tenga los ingresos estimados más altos.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenue

Métricas de rendimiento de los anuncios para diferentes tipos de anuncios

Esta solicitud recupera las métricas de rendimiento de los anuncios para el contenido reclamado del propietario del contenido. Los resultados se agrupan por tipo de anuncio, lo que le permite comparar valores de ingresos y CPM en diferentes tipos de anuncios.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

Informes de propietarios de contenido

Estadísticas básicas

Denuncias de videos

Cantidad total de vistas, tiempo de reproducción estimado y mucho más para todo el contenido reclamado

Esta consulta recupera métricas recopiladas para el contenido reclamado del propietario del contenido. El informe muestra una sola fila de datos que contiene los totales de cada métrica solicitada durante el intervalo de fechas especificado.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed

Recuento de vistas específico del país (y otros datos) de todos los videos subidos

Esta consulta recupera métricas para un país específico palos videos que el propietario del contenido subió. El informe muestra una sola fila de datos que contiene los totales de cada métrica solicitada durante el intervalo de fechas especificado.

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==self;country==FR

Total de reproducciones (y otros datos) de todo el contenido reclamado de terceros

Esta consulta recupera métricas recopiladas para videos que el propietario del contenido reclamó, pero no subió. El informe muestra una sola fila de datos que contiene los totales de cada métrica solicitada durante el intervalo de fechas especificado.

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==thirdParty;claimedStatus==claimed

Recuentos totales de vistas (y otros datos) de todo el contenido subido

Esta consulta recupera métricas recopiladas para los videos que el propietario del contenido subió. El informe muestra una sola fila de datos que contiene los totales de cada métrica solicitada durante el intervalo de fechas especificado.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self

Recuentos totales de vistas (y otros datos) de todo el contenido subido y reclamado

Esta consulta recupera métricas recopiladas para videos que el propietario del contenido subió y reclamó. El informe muestra una sola fila de datos que contiene los totales de cada métrica solicitada durante el intervalo de fechas especificado.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self;claimedStatus==claimed

Los 10 principales: Videos más reproducidos para un propietario de contenido

Esta consulta recupera los 10 videos más reproducidos, medidos por la cantidad de reproducciones durante el intervalo de fechas especificado, que el propietario del contenido subió. Los resultados se ordenan por recuento de vistas de forma descendente.

dimensions=video
metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions
filters=uploaderType==self
maxResults=10
sort=-views

Los 10 principales: Videos más vistos para un propietario de contenido

Esta consulta recupera los 10 videos más vistos, medidos por minutos de reproducción estimados durante el intervalo de fechas especificado, que el propietario del contenido subió. Los resultados se ordenan por minutos estimados de reproducción en forma descendente.

dimensions=video
metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained
filters=uploaderType==self
maxResults=10
sort=-estimatedMinutesWatched

Los 10 principales: Videos más reproducidos para el canal de un propietario de contenido

Esta consulta recupera los 10 videos más reproducidos para un canal o grupo de canales específicos que el propietario de contenido administra. Los resultados se ordenan por recuento de vistas de forma descendente. Ten en cuenta que para ejecutar esta consulta en el Explorador de API, debes reemplazar la string CHANNEL_ID por el valor del parámetro filters con una lista separada por comas de hasta 500 ID de canal para tus canales.

dimensions=video
metrics=views
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

Los 10 principales: Tasas de clics de anotaciones para los videos más vistos de un canal

Esta solicitud recupera la cantidad de vistas, las tasas de clics de anotaciones y las tasas de cierre de anotaciones y las impresiones de anotaciones para los 10 videos más reproducidos de un canal o grupo de canales específico. Los resultados se ordenan por cantidad de reproducciones de forma descendente, lo cual significa que los videos más vistos aparecerán primero. Ten en cuenta que para ejecutar esta consulta en el Explorador de API, debes reemplazar la string CHANNEL_ID por el valor del parámetro filters con una lista separada por comas de hasta 500 ID de canal para tus canales.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

Informes de lista de reproducción

Reproducciones de las listas de reproducción de los canales de un propietario del contenido

Esta solicitud recupera el total de inicios de las listas de reproducción, los minutos de reproducción estimados, las vistas y las vistas por el inicio de las listas de reproducción en los canales del propietario del contenido. La métrica views solo cuenta las vistas de video que se produjeron en el contexto de una lista de reproducción.

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1

Vistas de la lista de reproducción de un canal en particular

Esta solicitud recupera el total de inicios de las listas de reproducción, los minutos de reproducción estimados, las vistas y las vistas por el inicio de las listas de reproducción en los canales del propietario del contenido. La métrica views solo cuenta las vistas de video que se produjeron en el contexto de una lista de reproducción. Ten en cuenta que para ejecutar esta consulta en el Explorador de API, debes reemplazar la string CHANNEL_ID por el valor del parámetro filters con una lista separada por comas de hasta 500 ID de canal para tus canales.

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1;channel==CHANNEL_ID

Estadísticas de una lista de reproducción

Esta solicitud recupera el total de inicios de las listas de reproducción, los minutos estimados de reproducción, las vistas y las vistas por el inicio de una lista de reproducción específica. La métrica views solo cuenta las vistas de video que se produjeron en el contexto de una lista de reproducción. Ten en cuenta que para ejecutar esta consulta en el Explorador de API, debes reemplazar la string PLAYLIST_ID por el valor del parámetro filters con el ID de la lista de reproducción en uno de los canales del propietario del contenido.

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1;playlist==PLAYLIST_ID

Para recuperar las estadísticas globales de varias listas de reproducción, también puedes reemplazar la cadena PLAYLIST_ID por una lista separada por comas de hasta 500 ID de listas de reproducción por las listas de reproducción en los canales del propietario del contenido.

Las 10 principales: Listas de reproducción más vistas de un propietario de contenido

Esta consulta recupera las 10 listas de reproducción más vistas del propietario de contenido, medida por los minutos de reproducción estimados durante el intervalo de fechas especificado. También recupera muchas otras métricas de la lista de reproducción, como la cantidad de veces que los espectadores iniciaron la reproducción de cada lista y la cantidad promedio de tiempo que un usuario miró videos en la lista de reproducción después de su inicio. Los resultados se ordenan por minutos estimados de reproducción en forma descendente.

Nota: Dado que este informe usa la dimensión playlist, debes especificar un valor para el parámetro de solicitud sort y también establecer el parámetro maxResults en un valor de número entero de 10 o menos.

dimensions=playlist
metrics=estimatedMinutesWatched,views,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
maxResults=10
sort=-estimatedMinutesWatched
Temporal

Denuncias de videos

Métricas de tiempo de reproducción diario para el contenido subido

Esta consulta recupera diariamente métricas de tiempo de reproducción, así como recuentos de vistas, reproducciones monetizadas y recuentos de impresiones para videos que el propietario del contenido subió. El informe muestra una fila de datos para cada día en el intervalo de fechas solicitado y las filas se ordenan en forma cronológica.

dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day

Métricas de anotaciones para el contenido reclamado

Esta solicitud recupera diariamente la cantidad de vistas, las tasas de clics de anotaciones y las tasas de cierre de anotaciones y las impresiones de anotaciones para el contenido reclamado del propietario del contenido. Los resultados se ordenan en forma cronológica.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day

Informes de lista de reproducción

Reproducciones diarias de las listas de reproducción de un propietario de contenido

Esta solicitud recupera diariamente la cantidad de reproducciones, los inicios de listas de reproducción, los minutos de reproducción estimados y las reproducciones por lista de reproducción de todas las listas de reproducción en los canales del propietario del contenido. Los resultados se ordenan en forma cronológica.

dimensions=day
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1
sort=day
Geográfico

Denuncias de videos

Métricas de tiempo de reproducción específicas del país para el contenido subido

Esta consulta recupera la cantidad de vistas, las métricas del tiempo de reproducción y los ingresos estimados por anuncios de cada país. Las métricas son para los videos que el propietario del contenido subió. El informe muestra una fila de datos para cada país donde se reprodujeron los videos y las filas se ordenan en forma descendente, según la cantidad de minutos de reproducción.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched

Métricas de anotaciones específicas del país para el contenido subido

Esta solicitud recupera la cantidad de reproducciones, los porcentajes de conversiones posclic de anotaciones, los porcentajes de cierres de anotaciones y las impresiones de anotaciones para los videos subidos del propietario del contenido. Los resultados se ordenan por tasa de clics de anotaciones en forma descendente, lo que significa que el país con la mayor tasa de clics de anotaciones aparece en el primer lugar de la lista.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate

Métricas específicas de la provincia para los estados de EE.UU. y Washington D.C.

Esta solicitud recupera un desglose por provincia de los recuentos de vistas, los minutos de reproducción estimados y la duración promedio de vistas para los videos reclamados del propietario del contenido. Los datos abarcan los estados de EE.UU. y Washington D.C. Los resultados se ordenan alfabéticamente según los códigos ISO 3166-2 de las provincias.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Las 10 ciudades principales de EE.UU. por cantidad total de vistas

Esta consulta recupera una lista de las 10 ciudades de los Estados Unidos que representaron la mayor cantidad de reproducciones de los videos reclamados por el propietario del contenido durante el intervalo de fechas especificado. La consulta podría modificarse a fin de solicitar datos de otro país si elige otro valor válido para ese filtro. De manera similar, la consulta podría modificarse para recuperar datos de un subcontinente, como Europa occidental o el Sudeste Asiático, mediante el filtro subContinent y uno de sus valores válidos. También se admiten otros filtros. Los resultados se ordenan por recuento de vistas de forma descendente.

    dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Las 10 ciudades principales de EE.UU. por cantidad total de vistas en cada tipo de contenido

Esta consulta recupera una lista de las 10 ciudades de EE.UU. que representaron la mayor cantidad de reproducciones del contenido reclamado del propietario de contenido durante el período especificado para cada creatorContentType admitido. Los resultados se ordenan por recuento de vistas de forma descendente.

    dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Las 10 ciudades principales de EE.UU. por tiempo de reproducción total

Esta consulta recupera una lista de los 10 días principales durante el período especificado cuando cualquier ciudad de los Estados Unidos representó el mayor tiempo de reproducción diario total del contenido reclamado del propietario del contenido. Los resultados de la consulta identifican el tiempo de reproducción total, la fecha en la que ocurrió el tiempo de reproducción y la ciudad en la que se calculó la reproducción del contenido. Los resultados se ordenan en forma descendente según el tiempo de reproducción total.

    dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

Los 10 principales: Videos más vistos en Europa

Esta consulta recupera los 10 videos más reproducidos de Europa, entre los videos reclamados por el propietario del contenido, medidos según la cantidad de reproducciones durante el intervalo de fechas especificado. La consulta podría modificarse a fin de solicitar datos de otro continente con la elección de otro valor válido para ese filtro. De manera similar, la consulta podría modificarse para recuperar datos de un subcontinente, como Europa occidental o el Sudeste Asiático, mediante el filtro subContinent y uno de sus valores válidos. Los resultados se ordenan por recuento de vistas de forma descendente.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched

Informes de lista de reproducción

Métricas de tiempo de reproducción específicas del país para las listas de reproducción del propietario del contenido

Esta consulta recupera métricas de reproducción y de recuentos de vistas específicos de países para todas las listas de reproducción en los canales del propietario del contenido. El informe muestra una fila de datos para cada país donde se miraron las listas de reproducción. Las filas se ordenan en forma descendente, según la cantidad de minutos de reproducción.

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
sort=-estimatedMinutesWatched

Las 10 principales: Listas de reproducción más iniciadas en Estados Unidos

Esta consulta recupera las 10 listas de reproducción de los canales del propietario del contenido que los espectadores de Estados Unidos comenzaron a ver con más frecuencia durante el intervalo de fechas especificado. Los resultados se ordenan por cantidad de veces que la lista de reproducción comienza en orden descendente.

Nota: Dado que este informe usa la dimensión playlist, debes especificar un valor para el parámetro de solicitud sort y también establecer el parámetro maxResults en un valor de número entero de 10 o menos.

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts
Detalles de reproducción

Denuncias de videos

"Me gusta" y "No me gusta" por tipo de contenido

Esta consulta recupera la cantidad de Me gusta y No me gusta para cada tipo de contenido en un canal o grupo de canales en particular. Ten en cuenta que para ejecutar esta consulta en el Explorador de API, debes reemplazar la string CHANNEL_ID por el valor del parámetro filters con una lista separada por comas de hasta 500 ID de canal para tus canales.

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID
Ubicación de reproducción

Denuncias de videos

Cantidad de reproducciones y tiempo de reproducción de diferentes ubicaciones de reproducción

Esta consulta recupera la cantidad de reproducciones y el tiempo de reproducción estimado para videos subidos a un canal o grupo de canales en particular. Los resultados se agrupan según el tipo de página o aplicación en la que se produjeron las reproducciones de video, y los resultados se ordenan en forma descendente por recuento de vistas. Ten en cuenta que para ejecutar esta consulta en el Explorador de API, debes reemplazar la string CHANNEL_ID por el valor del parámetro filters con una lista separada por comas de hasta 500 ID de canal para tus canales.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

Recuentos diarios de vistas y tiempo de reproducción de diferentes ubicaciones de reproducción

Esta consulta recupera diariamente la cantidad de reproducciones y el tiempo de reproducción estimado en los Estados Unidos para los videos subidos a un canal o grupo de canales en particular. Los resultados se agrupan por día para cada tipo de página o aplicación en la que se produjeron las reproducciones de video. Los resultados se ordenan en forma cronológica inversa. Ten en cuenta que para ejecutar esta consulta en el Explorador de API, debes reemplazar la string CHANNEL_ID por el valor del parámetro filters con una lista separada por comas de hasta 500 ID de canal para tus canales.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day

Los 10 principales: Sitios de terceros que generan la mayor cantidad de reproducciones de un video integrado

Esta consulta recupera la cantidad de reproducciones y el tiempo de reproducción estimado para un video o grupo de videos en particular. Los resultados se agrupan según el sitio del tercero en el que se integró el video. Los resultados se ordenan en forma descendente por cantidad de vistas. Ten en cuenta que para ejecutar esta consulta en el Explorador de API, debes reemplazar la string VIDEO_ID por el valor del parámetro filters con una lista separada por comas de hasta 500 ID de video por los videos subidos.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Informes de lista de reproducción

Recuentos de vistas de listas de reproducción y tiempo de reproducción de diferentes ubicaciones de reproducción

Esta consulta recupera la cantidad de reproducciones, tiempo de reproducción estimado y inicio de todas las listas de reproducción en los canales de un propietario de contenido. Los resultados se recopilan según el tipo de página o aplicación en la que se produjeron las reproducciones de video, y los resultados se ordenan en forma descendente por inicio de lista de reproducción.

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts
filters=isCurated==1
sort=-playlistStarts

Recuento diario de vistas y tiempo de reproducción de diferentes ubicaciones de reproducción

Esta consulta recupera los inicios de las listas de reproducción diarias, los recuentos de vistas y el tiempo de reproducción estimado en Estados Unidos para todas las listas de reproducción de los canales de un propietario de contenido. Los resultados se agrupan por día para cada tipo de página o aplicación donde se visualizaron las listas de reproducción. Los resultados se ordenan en forma cronológica.

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,views,estimatedMinutesWatched
filters=isCurated==1;country==US
sort=day
Fuente de tráfico

Denuncias de videos

Cantidad de reproducciones y tiempo de reproducción de diferentes fuentes de tráfico

Esta solicitud recupera la cantidad de reproducciones y el tiempo de reproducción estimado para los videos del propietario de contenido. Las métricas se recopilan por fuente de tráfico, lo que describe la manera en que los usuarios llegaron al video.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

Recuentos diarios de vistas y tiempo de reproducción de diferentes fuentes de tráfico

Esta solicitud recupera diariamente la cantidad de vistas y el tiempo de reproducción estimado para los videos del propietario de contenido. Las métricas se recopilan a diario por fuente de tráfico y se ordenan en forma cronológica inversa.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day

Nota: Los siguientes dos informes de muestra solo se admiten para fuentes de tráfico específicas. Por ejemplo, la fuente de tráfico NO_LINK_EMBEDDED no tiene detalles adicionales y, por lo tanto, estos informes no están disponibles para esa fuente. Consulta la definición de insightTrafficSourceType a fin de obtener detalles sobre las fuentes de tráfico para las que están disponibles estos tipos de informes.

Los 10 principales: Términos de búsqueda de YouTube que generan la mayor parte del tráfico para un video

Esta consulta recupera los 10 términos de búsqueda que generaron la mayor cantidad de reproducciones a partir de los resultados de búsqueda de YouTube para un video o grupo de videos específicos. Los resultados se ordenan por recuento de vistas de forma descendente. Ten en cuenta que para ejecutar esta consulta en el Explorador de API, debes reemplazar la string VIDEO_ID por el valor del parámetro filters con una lista separada por comas de hasta 500 ID de video por los videos subidos.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Los 10 principales: Sitios web externos que generan el mayor tráfico para un video

Esta consulta recupera los 10 sitios web externos que generaron la mayor cantidad de reproducciones a partir de los resultados de búsqueda de Google para un video o grupo de videos específicos. Los resultados se ordenan por tiempo estimado de reproducción en forma descendente. Ten en cuenta que para ejecutar esta consulta en el Explorador de API, debes reemplazar la string VIDEO_ID por el valor del parámetro filters con una lista separada por comas de hasta 500 ID de video por los videos subidos.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Informes de lista de reproducción

Recuentos de vistas de listas de reproducción y tiempo de reproducción de diferentes fuentes de tráfico en un país

Esta solicitud recupera la cantidad de reproducciones de listas de reproducción, inicios de listas de reproducción y tiempo de reproducción estimado para las reproducciones de las listas de reproducción en un país especificado. Las métricas se recopilan por fuente de tráfico, lo que describe la manera en que los usuarios llegaron a la lista de reproducción.

dimensions=insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1;country==US

Recuentos diarios de las listas de reproducción y el tiempo de reproducción de diferentes fuentes de tráfico

Esta solicitud recupera diariamente las reproducciones, los inicios de las listas de reproducción y el tiempo de reproducción estimado para las listas de reproducción en uno o más de los canales de un propietario de contenido. Las métricas se recopilan a diario por fuente de tráfico y se ordenan en forma cronológica. Ten en cuenta que para ejecutar esta consulta en el Explorador de API, debes reemplazar la string CHANNEL_ID por el valor del parámetro filters con una lista separada por comas de hasta 500 ID de canal para tus canales.

dimensions=day,insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1;channel==CHANNEL_ID
sort=day
Dispositivo/SO

Denuncias de videos

Métricas diarias de tipo de dispositivo para videos reclamados

Esta consulta recupera diariamente la cantidad de reproducciones y el tiempo de reproducción estimado por tipo de dispositivo para los videos reclamados por un propietario de contenido en particular. Los resultados se agrupan por día para cada tipo de dispositivo en el que se produjeron las reproducciones de video. Los resultados se ordenan en forma cronológica.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day

Métricas diarias de sistema operativo para videos reclamados reproducidos en dispositivos móviles

Esta consulta recupera diariamente la cantidad de reproducciones y el tiempo de reproducción estimado por sistema operativo para las reproducciones de videos reclamados por un propietario de contenido especificado que se llevó a cabo en dispositivos móviles. Los resultados se agrupan por día para cada sistema operativo en el que se produjeron las reproducciones de video. Los resultados se ordenan en forma cronológica.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=day

Métricas diarias de sistema operativo y tipo de dispositivo

Esta consulta recupera diariamente la cantidad de reproducciones y el tiempo de reproducción estimado para los videos reclamados por un propietario de contenido en particular. Las estadísticas se agrupan según el sistema operativo y el tipo de dispositivo. Los resultados se ordenan en forma cronológica.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Informes de lista de reproducción

Métricas diarias de tipo de dispositivo para las vistas de listas de reproducción en el sistema operativo Android

Esta consulta recupera diariamente la cantidad de reproducciones de la lista de reproducción y el tiempo de reproducción estimado en los dispositivos Android para las listas de reproducción en uno o más de los canales del propietario del contenido. Los resultados se agrupan por día para cada tipo de dispositivo donde se vieron las listas de reproducción. Los resultados se ordenan en forma cronológica. Ten en cuenta que para ejecutar esta consulta en el Explorador de API, debes reemplazar la string CHANNEL_ID por el valor del parámetro filters con una lista separada por comas de hasta 500 ID de canal para tus canales.

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched
filters=isCurated==1;channel==CHANNEL_ID;operatingSystem==ANDROID
sort=day

Métricas diarias de sistema operativo para vistas de listas de reproducción en dispositivos móviles

Esta consulta recupera diariamente la cantidad de vistas de las listas de reproducción y el tiempo de reproducción estimado en dispositivos móviles para las listas de reproducción en cualquiera de los canales de un propietario de contenido. Los resultados se agrupan por día para cada sistema operativo en el que se produjeron las vistas de listas de reproducción. Los resultados se ordenan en forma cronológica.

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=isCurated==1;deviceType==MOBILE
sort=day
Datos demográficos

Denuncias de videos

Datos demográficos de los espectadores en California (edad y género)

Este informe recupera estadísticas sobre el grupo etario y el sexo de los espectadores en California que miraron el contenido reclamado del propietario del contenido. Los resultados se ordenan por sexo y, luego, por edad. Esta consulta se podría modificar a fin de recuperar las mismas estadísticas para todos los usuarios de todo el mundo o todos los usuarios de un país, continente, subcontinente o cualquier otro estado de EE.UU. ajustando el valor del parámetro filters.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup

Informes de lista de reproducción

Datos demográficos del espectador de la lista de reproducción en California (edad y género)

Este informe recupera estadísticas sobre el grupo etario y el género de los espectadores en California que miraron las listas de reproducción en cualquiera de los canales del propietario del contenido. Los resultados se ordenan por sexo y, luego, por edad. Esta consulta se podría modificar a fin de recuperar las mismas estadísticas para todos los usuarios de todo el mundo o todos los usuarios de un país, continente, subcontinente o cualquier otro estado de EE.UU. ajustando el valor del parámetro filters.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=isCurated==1;province==US-CA
sort=gender,ageGroup
Redes sociales

Métricas de uso compartido, recopiladas por servicio donde se compartieron videos

Esta solicitud recupera la cantidad de veces que los usuarios utilizaron el botón Share para compartir los videos que subió el propietario del contenido. Los resultados se recopilan por servicio de uso compartido (Google+, Twitter, etc.) y se ordenan en forma descendente por cantidad de usos compartidos.

dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-shares
Retención de público

Métricas de retención de público de un video

Este informe mide la capacidad de un video para retener su público. El informe solo se puede recuperar para un video a la vez. Ten en cuenta que para ejecutar esta consulta en el Explorador de API, debes reemplazar la string VIDEO_ID por el valor del parámetro filters con el ID de video de uno de tus videos subidos. Ten en cuenta que los informes de retención de público no admiten la capacidad de especificar varios valores para el filtro video.

En este ejemplo, el informe usa el filtro audienceType para restringir la respuesta, de modo que solo contenga datos de vistas orgánicas, que son el resultado de una acción directa del usuario, como una búsqueda de un video o un clic en un video sugerido. Por lo tanto, el informe no incluye datos para las vistas de anuncios TrueView In-stream ni TrueView en display. Puedes quitar el filtro para recuperar los datos de retención de público del video en todos los tipos de público.

Ten en cuenta que los datos del filtro audienceType están disponibles desde el 25 de septiembre de 2013. La API no mostrará datos de las consultas que usan el filtro para intentar recuperar datos de fechas anteriores. Las consultas que no utilizan el filtro funcionan para ninguna fecha posterior al 1 de julio de 2008.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC
Ingresos/anuncios

Métricas de ingresos y rendimiento del anuncio para el contenido reclamado

Esta solicitud recupera métricas de ingresos y de rendimiento de anuncios para el contenido reclamado del propietario del contenido. El informe muestra una sola fila de datos que contiene los totales de cada métrica solicitada durante el intervalo de fechas especificado.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Métricas diarias de ingresos y rendimiento del anuncio

Esta solicitud recupera diariamente ingresos y métricas de rendimiento de anuncios para el contenido reclamado del propietario del contenido.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Métricas de ingresos y rendimiento del anuncio específicos por país

Esta solicitud recupera métricas de rendimiento de anuncios y de ingresos específicos de cada país para el contenido reclamado del propietario del contenido. Los resultados se ordenan de forma descendente según el importe de los ingresos, lo que significa que el primer país que se indique será el que tenga más ingresos estimados del socio.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue

Los 10 principales: Videos con los mayores ingresos

Esta solicitud recupera las métricas de ingresos y de rendimiento de anuncios para los 10 videos que reclamó el propietario de contenido y que tuvieron los ingresos más altos. Los resultados se ordenan en forma descendente por cantidad de ingresos, lo que significa que el primer video será el que tenga los ingresos estimados más altos.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenue

Métricas de rendimiento de los anuncios para diferentes tipos de anuncios

Esta solicitud recupera las métricas de rendimiento de los anuncios para el contenido reclamado del propietario del contenido. Los resultados se agrupan por tipo de anuncio, lo que le permite comparar valores de ingresos y CPM en diferentes tipos de anuncios.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType