Solicitudes de API de ejemplo

Denuncias de videos

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

Esta consulta recupera los recuentos de vistas diarias, las métricas de tiempo de reproducción y los recuentos de suscriptores nuevos de 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 los recuentos de vistas diarios, las tasas de clics y de cierre de las anotaciones, y las impresiones de las anotaciones del 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

Vistas diarias de playlists de un canal

Esta solicitud recupera los recuentos de vistas diarias (una métrica de video agregada), las vistas de playlists (una métrica dentro de la playlist), las reproducciones de playlists, los minutos estimados que se miraron y las vistas por reproducción de playlist del canal del usuario autenticado. Los resultados se ordenan en forma cronológica.

dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=day

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 las cantidades de vistas, las métricas de tiempo de reproducción y las cifras de suscripciones específicas de un país 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 los recuentos de vistas, las tasas de clics de anotaciones, los porcentajes de cierres de anotaciones y las impresiones de anotaciones para los videos del canal de un país específico. 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 cada provincia para los estados de EE.UU. y Washington D.C.

Esta solicitud recupera un desglose de los recuentos de vistas, los minutos de reproducción estimados y la duración promedio de vistas de los videos del canal en cada provincia. 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 en orden descendente.

Nota: Para utilizar este informe, debes especificar un valor para el parámetro de solicitud sort y establecer el parámetro maxResults en un valor entero de 10 o menos.

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

Las 10 ciudades de EE.UU. con más vistas en total

Esta consulta recupera una lista de las 10 ciudades de EE.UU. que generaron la mayor cantidad de vistas del contenido del canal durante el período especificado. La consulta se podría modificar para solicitar datos de otro país si se elige otro valor válido para ese filtro. Del mismo modo, la consulta se podría modificar para recuperar datos de un subcontinente, como Europa occidental o el sudeste asiático, con el filtro subContinent y uno de sus valores válidos. También se admiten otros filtros. Los resultados se ordenan por recuento de vistas en forma descendente.

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

Las 10 ciudades principales de EE.UU. por vistas totales de cada tipo de contenido

Esta consulta recupera una lista de las 10 ciudades de EE.UU. que generaron la mayor cantidad de vistas del contenido del canal durante el período especificado para cada creatorContentType compatible. Los resultados se ordenan por recuento de vistas en 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 más populares durante el período especificado en los que una ciudad de 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 que ocurrió el tiempo de reproducción y la ciudad en la que se calculó que se vio el 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

Top 10: Videos más vistos en Europa

Esta consulta recupera los 10 videos más vistos del canal en Europa, según la cantidad de vistas durante el período especificado. La consulta se podría modificar para solicitar datos de otro continente si se 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, usando el filtro subContinent y uno de sus valores válidos. Los resultados se ordenan por recuento de vistas en orden descendente.

Nota: Para utilizar este informe, debes especificar un valor para el parámetro de solicitud sort y establecer el parámetro maxResults en un valor 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 playlists de un canal

Esta consulta recupera los recuentos de vistas específicos de cada país (una métrica de video agregada), las vistas de playlists (una métrica dentro de la playlist) y las métricas de tiempo de reproducción de las playlists de un canal. El informe muestra una fila de datos para cada país en el que se miraron las playlists 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
sort=-estimatedMinutesWatched

Top 10: Playlists que más se iniciaron en Estados Unidos

Esta consulta recupera las 10 playlists que los usuarios de Estados Unidos comenzaron a mirar con mayor frecuencia durante el período especificado. Los resultados se ordenan por cantidad de veces que se inició la playlist en orden descendente.

Nota: Como 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 entero de 10 o menos.

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts

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 agregan según el tipo de página o aplicación en la que se reprodujo el video y se ordenan en orden descendente según la cantidad de vistas.

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

Cantidad de vistas diarias y tiempo de reproducción desde diferentes ubicaciones de reproducción

Esta consulta recupera el recuento de vistas diarias y el tiempo de reproducción estimado en 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 los recuentos de vistas y el tiempo de reproducción estimado de un video o un 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 orden descendente según la cantidad de vistas. Ten en cuenta que, para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena VIDEO_ID en el valor del parámetro filters por una lista separada por comas de uno o más IDs de video para los videos que subiste.

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

Informes de lista de reproducción

Cantidad de vistas y tiempo de reproducción de las playlists desde diferentes ubicaciones de reproducción

Esta consulta recupera la cantidad de recuentos de vistas (una métrica de video agregada), las vistas de playlists (una métrica dentro de la playlist), el tiempo de reproducción estimado y las reproducciones de playlists de un canal en particular. Los resultados se agregan según el tipo de página o aplicación en la que se produjeron las reproducciones de video y se ordenan en orden descendente según las reproducciones de playlist.

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

Cantidad de vistas diarias de las playlists y tiempo de reproducción desde diferentes ubicaciones de reproducción

Esta consulta recupera los inicios diarios de playlists, los recuentos de vistas (una métrica de video agregada), las vistas de playlists (una métrica en la playlist) y el tiempo de reproducción estimado en Estados Unidos para las playlists 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 vistas de playlist. Los resultados se ordenan en orden cronológico.

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

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.

dimensions=creatorContentType
metrics=likes,dislikes

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

Los recuentos diarios de vistas y el tiempo de reproducción de diferentes fuentes de tráfico

Esta solicitud recupera los recuentos de vistas diarios y el tiempo de reproducción estimado diario de 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 vistas de los resultados de la búsqueda de YouTube para uno o más videos específicos. Los resultados se ordenan por recuento de vistas en orden descendente. Ten en cuenta que, para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena VIDEO_ID en el valor del parámetro filters por una lista separada por comas de hasta 500 IDs de video.

Por ejemplo, puedes ejecutar la consulta para un solo video o reemplazar VIDEO_ID para identificar los términos de búsqueda que generan más tráfico para ese video. También puedes enumerar todos los videos de una playlist en particular para determinar qué términos de búsqueda generan más tráfico para cualquiera de los videos de esa playlist.

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

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

Esta consulta recupera los 10 sitios web externos que generaron la mayor cantidad de vistas para un video o grupo de videos específico. 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 APIs, debes reemplazar la cadena VIDEO_ID en el valor del parámetro filters por una lista separada por comas de hasta 500 IDs de video para los videos que subiste.

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

Informes de lista de reproducción

Los recuentos de vistas y el tiempo de reproducción de las playlists de diferentes fuentes de tráfico en un país

Esta solicitud recupera la cantidad de vistas (una métrica de video agregada), las vistas de playlist (una métrica dentro de la playlist), las activaciones de playlist y el tiempo de reproducción estimado de las vistas de playlist en un país específico. Las métricas se agrupan por fuente de tráfico, que describe la forma en que los usuarios llegaron a la playlist.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==US

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

Esta solicitud recupera las vistas diarias de las playlists de un canal (una métrica dentro de la playlist), los inicios de playlists y el tiempo de reproducción estimado. También recupera el total de vistas (una métrica agregada de video). 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,playlistStarts,playlistViews
sort=day

Denuncias de videos

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

Esta consulta recupera diariamente los recuentos de vistas y el tiempo de reproducción estimado en 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 el recuento de vistas diarias y el tiempo de reproducción estimado en 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 los recuentos diarios 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 playlists en el sistema operativo Android

Esta consulta recupera las vistas diarias (una métrica de video agregada), las vistas de las playlists (una métrica dentro de la playlist) y el tiempo de reproducción estimado en dispositivos Android para las playlists de un canal en particular. Los resultados se agrupan por día para cada tipo de dispositivo en el que se produjeron las vistas de la playlist. Los resultados se ordenan en forma cronológica.

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

Métricas diarias del sistema operativo para las vistas de playlists en dispositivos móviles

Esta consulta recupera las vistas diarias (una métrica de video agregada), las vistas de playlists (una métrica en la playlist) y el tiempo de reproducción estimado en dispositivos móviles para las playlists de un canal en particular. Los resultados se agrupan por día para cada sistema operativo en el que se produjeron las vistas de las playlists. Los resultados se ordenan en forma cronológica.

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

Denuncias de videos

Datos demográficos de los usuarios en California (grupo etario y género)

Este informe recupera estadísticas sobre el grupo etario y el género de los usuarios de California que miraron los videos del canal. Los resultados se ordenan por género y, luego, por rango de edad. Esta consulta se podría modificar para recuperar las mismas estadísticas de todos los usuarios en todo el mundo o de todos los usuarios de un país, continente, subcontinente o de 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 de usuarios de playlists en California (grupo de edad y género)

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

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

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

Esta solicitud recupera la cantidad de veces que los usuarios usaron 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

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

En este informe, se mide la capacidad de un video para retener a 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 APIs, debes reemplazar la cadena VIDEO_ID en 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 las vistas orgánicas, que son el resultado de una acción directa del usuario, como la búsqueda de un video o un clic en un video sugerido. Por lo tanto, el informe no incluye datos de las vistas de los anuncios TrueView in-stream ni de los anuncios TrueView in-display. Puedes quitar el filtro para recuperar los datos de retención de público del video de 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 para las consultas que usen el filtro para intentar recuperar datos de fechas anteriores. Las consultas que no usan el filtro funcionan para cualquier fecha posterior al 1 de julio de 2008.

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

Métricas de ingresos del canal y rendimiento de los anuncios

Esta solicitud recupera las métricas de rendimiento de los anuncios y los ingresos 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 de ingresos diarios y rendimiento de los anuncios

Esta solicitud recupera los ingresos diarios y las métricas de rendimiento de los anuncios de un canal.

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

Métricas de ingresos y rendimiento de los anuncios específicas de cada país

Esta solicitud recupera las métricas de rendimiento de los anuncios y los ingresos específicos de un país de un canal. Los resultados se ordenan de forma descendente por importe de ingresos, lo que significa que el primer país que aparece en la lista será aquel en el que el socio obtuvo los mayores ingresos netos.

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

Los 10 principales: Videos con los ingresos más altos

Esta solicitud recupera las métricas de ingresos y rendimiento de los anuncios de los 10 videos del canal con los ingresos más altos. Los resultados se ordenan en forma descendente según el importe de los 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 te permite comparar los valores de ingresos y CPM en diferentes tipos de anuncios.

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

Denuncias de videos

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

Esta consulta recupera las métricas de tiempo de reproducción diarias, así como los recuentos de vistas, las reproducciones monetizadas y los recuentos de impresiones de los videos que subió el propietario del contenido. 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 los recuentos de vistas diarios, las tasas de clics de las anotaciones, las tasas de cierre de las anotaciones y las impresiones de las anotaciones del contenido reclamado por el 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

Vistas diarias de playlists de un propietario de contenido

Esta solicitud recupera las métricas de las interacciones diarias de los usuarios con los videos de las playlists del propietario del contenido. Las métricas recuperadas en el informe son playlistViews, playlistStarts, playlistEstimatedMinutesWatched y viewsPerPlaylistStart. Todas estas métricas son métricas dentro de la playlist. Dado que todas las métricas solicitadas son métricas de la playlist, la solicitud no necesita incluir el filtro de playlist o grupo.

dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=day

Denuncias de videos

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

Esta consulta recupera los recuentos de vistas, las métricas de tiempo de reproducción y los ingresos publicitarios estimados para 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 los recuentos de vistas, las tasas de clics y de cierre, y las impresiones de anotaciones específicas de cada país para los videos subidos por el 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 estimados de reproducción y la duración promedio de vistas de los videos reclamados por el 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 de EE.UU. con más vistas en total

Esta consulta recupera una lista de las 10 ciudades de EE.UU. que generaron la mayor cantidad de vistas de los videos reclamados del propietario del contenido durante el período especificado. La consulta se podría modificar para solicitar datos de otro país si se elige otro valor válido para ese filtro. Del mismo modo, la consulta se podría modificar para recuperar datos de un subcontinente, como Europa occidental o el sudeste asiático, con el filtro subContinent y uno de sus valores válidos. También se admiten otros filtros. Los resultados se ordenan por recuento de vistas en orden descendente.

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

Las 10 ciudades de EE.UU. principales según el total de vistas para cada tipo de contenido

Esta consulta recupera una lista de las 10 ciudades de EE.UU. que generaron la mayor cantidad de vistas del contenido reclamado del propietario del contenido durante el período especificado para cada creatorContentType compatible. Los resultados se ordenan por recuento de vistas en orden 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 más populares durante el período especificado en los que una ciudad de EE.UU. 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 que se produjo y la ciudad en la que se estimó que se vio el contenido. Los resultados se ordenan en orden descendente según el tiempo de reproducción total.

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

Top 10: Videos más vistos en Europa

Esta consulta recupera los 10 videos más vistos en Europa, entre los videos reclamados por el propietario del contenido, según la cantidad de vistas durante el período especificado. La consulta se podría modificar para solicitar datos de otro continente si se elige otro valor válido para ese filtro. Del mismo modo, la consulta se podría modificar para recuperar datos de un subcontinente, como Europa occidental o el sudeste asiático, con el filtro subContinent y uno de sus valores válidos. Los resultados se ordenan por recuento de vistas en 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 de cada país para las playlists de un propietario de contenido

Esta consulta recupera las métricas de vistas y tiempo de reproducción de las playlists específicas de cada país para todas las playlists de los canales del propietario del contenido. El informe muestra una fila de datos para cada país en el que se miraron las playlists. Las filas se ordenan en orden descendente según la cantidad de minutos reproducidos.

dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatched

Top 10: Playlists que más se iniciaron en Estados Unidos

Esta consulta recupera las 10 playlists de los canales del propietario del contenido que los usuarios de Estados Unidos comenzaron a mirar con más frecuencia durante el período especificado. Los resultados se ordenan por cantidad de inicios de playlist 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 establecer el parámetro maxResults en un valor entero de 10 o menos.

dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStarts

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 APIs, debes reemplazar la cadena CHANNEL_ID en el valor del parámetro filters por una lista separada por comas de hasta 500 IDs de canal para tus canales.

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID

Denuncias de videos

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

Esta consulta recupera la cantidad de vistas y el tiempo de reproducción estimado de los videos subidos a un canal o grupo de canales en particular. Los resultados se agregan según el tipo de página o aplicación en la que se reprodujo el video y se ordenan en orden descendente según la cantidad de vistas. Ten en cuenta que, para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena CHANNEL_ID en el valor del parámetro filters por una lista separada por comas de hasta 500 IDs de canal para tus canales.

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

Cantidad de vistas diarias y tiempo de reproducción desde diferentes ubicaciones de reproducción

Esta consulta recupera el recuento de vistas diarias y el tiempo de reproducción estimado en 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 APIs, debes reemplazar la cadena CHANNEL_ID en el valor del parámetro filters por una lista separada por comas de hasta 500 IDs 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 los recuentos de vistas 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 orden descendente según la cantidad de vistas. Ten en cuenta que para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena VIDEO_ID en el valor del parámetro filters por una lista separada por comas de hasta 500 IDs de video para los videos que subiste.

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

Informes de lista de reproducción

Cantidad de vistas y tiempo de reproducción de las playlists desde diferentes ubicaciones de reproducción

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

dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStarts

Cantidad de vistas y tiempo de reproducción de las playlists desde diferentes ubicaciones de reproducción

Esta consulta recupera las reproducciones diarias de playlists, los recuentos de vistas de playlists y el tiempo de reproducción estimado de playlists en Estados Unidos para todas las playlists de los canales de un propietario de contenido. Se muestran resultados para cada tipo de página o aplicación en la que se produjeron las vistas de la playlist.

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched
filters=country==US

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

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

Esta solicitud recupera las cantidades diarias de vistas y el tiempo de reproducción estimado diario de los videos del propietario del 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 son compatibles con fuentes de tráfico específicas. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES y NO_LINK_EMBEDDED son algunas de las fuentes de tráfico que no se admiten.

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 vistas de los resultados de la Búsqueda de YouTube para un video o un grupo de videos específicos. Los resultados se ordenan por recuento de vistas en orden descendente. Ten en cuenta que para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena VIDEO_ID en el valor del parámetro filters por una lista separada por comas de hasta 500 IDs de video para los videos que subiste.

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

Top 10: Sitios web externos que generan más tráfico para un video

Esta consulta recupera los 10 sitios web externos que generaron la mayor cantidad de vistas desde los resultados de la Búsqueda de Google para un video o grupo de videos específico. 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 APIs, debes reemplazar la cadena VIDEO_ID en el valor del parámetro filters por una lista separada por comas de hasta 500 IDs de video para los videos que subiste.

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

Informes de lista de reproducción

Los recuentos de vistas y el tiempo de reproducción de las playlists de diferentes fuentes de tráfico en un país

Esta solicitud recupera la cantidad de vistas de listas de reproducción, de inicios de listas de reproducción y el tiempo de reproducción estimado de listas de reproducción para las vistas de listas de reproducción en un país específico. Las métricas se agregan por fuente de tráfico, lo que describe la forma en que los usuarios llegaron a la playlist.

dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==US

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

Esta solicitud recupera las vistas, las reproducciones y el tiempo de reproducción estimado de las playlists de uno o más de los canales de un propietario de contenido. Las métricas se agregan por fuente de tráfico. Ten en cuenta que, para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena CHANNEL_ID en el valor del parámetro filters por una lista de hasta 500 IDs de canal de tus canales separados por comas.

dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID

Denuncias de videos

Métricas diarias de tipo de dispositivo para videos reclamados

Esta consulta recupera las cantidades de vistas diarias y el tiempo de reproducción estimado por tipo de dispositivo para los videos que reclamó 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 el recuento de vistas diarias y el tiempo de reproducción estimado por sistema operativo para las vistas de videos reclamados por un propietario de contenido específico que se produjeron 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 los recuentos de vistas 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 de tipo de dispositivo para las vistas de las playlists en el sistema operativo Android

Esta consulta recupera el recuento de vistas y el tiempo de reproducción estimado de las playlists en dispositivos Android para las playlists de uno o más de los canales de un propietario de contenido. Los resultados se muestran para cada tipo de dispositivo en el que se produjeron las vistas de la playlist. Ten en cuenta que, para ejecutar esta consulta en el Explorador de APIs, debes reemplazar la cadena CHANNEL_ID en el valor del parámetro filters por una lista separada por comas de hasta 500 IDs de canal para tus canales.

dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROID

Métricas del sistema operativo para las vistas de playlists en dispositivos móviles

Esta consulta recupera el recuento de vistas y el tiempo de reproducción estimado de las playlists en dispositivos móviles para las playlists de cualquiera de los canales de un propietario de contenido. Los resultados se muestran para cada sistema operativo en el que se produjeron las vistas de la playlist.

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

Denuncias de videos

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

En este informe, se recuperan estadísticas sobre el grupo etario y el género de los usuarios de California que miraron el contenido reclamado del propietario. Los resultados se ordenan por género y, luego, por edad. Esta consulta se podría modificar para recuperar las mismas estadísticas de todos los usuarios en todo el mundo o de todos los usuarios de un país, continente, subcontinente o de 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

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

Esta solicitud recupera la cantidad de veces que los usuarios usaron el botón Share para compartir 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

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

En este informe, se mide la capacidad de un video para retener a 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 APIs, debes reemplazar la cadena VIDEO_ID en 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 las vistas orgánicas, que son el resultado de una acción directa del usuario, como la búsqueda de un video o un clic en un video sugerido. Por lo tanto, el informe no incluye datos de las vistas de los anuncios TrueView in-stream ni de los anuncios TrueView in-display. Puedes quitar el filtro para recuperar los datos de retención de público del video de todos los tipos de público.

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

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

Métricas de ingresos y rendimiento de los anuncios para el contenido reclamado

Esta solicitud recupera los ingresos y las métricas de rendimiento de los 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 de ingresos diarios y rendimiento de los anuncios

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

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

Métricas de ingresos y rendimiento de los anuncios específicas de cada país

Esta solicitud recupera las métricas de rendimiento de los anuncios y los ingresos específicos de cada país para el contenido reclamado del propietario del contenido. Los resultados se ordenan de forma descendente por importe de ingresos, lo que significa que el primer país que aparece en la lista será aquel en el que el socio tuvo los mayores ingresos estimados.

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

Top 10: Videos con los ingresos más altos

Esta solicitud recupera las métricas de ingresos y rendimiento de los anuncios de los 10 videos que reclamó el propietario del contenido y que tuvieron los ingresos más altos. Los resultados se ordenan de forma descendente por el importe de los ingresos, lo que significa que el primer video será el que tuvo 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 te permite comparar los valores de ingresos y CPM en diferentes tipos de anuncios.

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