En esta página, se enumeran los cambios en la API y las actualizaciones de la documentación de la API de YouTube Reporting y la API de YouTube Analytics. Ambas APIs permiten que los desarrolladores accedan a los datos de YouTube Analytics, aunque de diferentes maneras. Suscríbete a este registro de cambios.
6 de mayo de 2024
La API de YouTube Analytics (búsquedas segmentadas) admite tres informes nuevos para canales:
-
El informe Actividad del usuario por DMA es un informe geográfico que proporciona estadísticas de la actividad del usuario según el Área de mercado designada (DMA). Para este informe, debes establecer el valor del parámetro
filters
encountry==US
. -
En el informe Espectadores simultáneos, se muestra la cantidad de usuarios simultáneos en diferentes partes de un solo video transmitido en vivo.
-
En el informe Cancelaciones de miembros, se proporcionan estadísticas que muestran por qué los usuarios cancelaron sus membresías del canal.
En este informe, se utiliza la nueva dimensión
membershipsCancellationSurveyReason
, que especifica por qué un usuario canceló una membresía del canal. También usa la nueva métricamembershipsCancellationSurveyResponses
, que indica cuántas membresías del canal se cancelaron por ese motivo.
Además, se mejoró el informe de retención de público para admitir tres métricas nuevas:
7 de abril de 2024
La API de YouTube Analytics (búsquedas segmentadas) tiene varias actualizaciones relacionadas con los informes de playlists de propietarios de contenido. Las actualizaciones son iguales a las relacionadas con los informes de listas de reproducción de canales, que se anunciaron el 19 de enero de 2024.
La siguiente entrada del historial de revisión proporciona casi la misma información que la entrada del 19 de enero de 2024. Sin embargo, ten en cuenta que los informes de playlists de propietarios del contenido admitirán la dimensión isCurated
hasta el 31 de diciembre de 2024, mientras que la dimensión se admitirá para los informes de listas de reproducción de canales hasta el 30 de junio de 2024.
-
Nota: Este es un anuncio de baja.
La dimensión
isCurated
dejó de estar disponible para los informes de playlists de propietarios del contenido. Dejará de ser compatible a partir del 31 de diciembre de 2024. La definición de esa dimensión se actualizó según corresponda.Para conservar la retrocompatibilidad cuando quitas la dimensión
isCurated
, también debes actualizar tu código para recuperar la métricaplaylistViews
, en lugar de la métricaviews
, solo para los informes de listas de reproducción. Debido a que la métricaviews
sigue siendo compatible con los informes de listas de reproducción, aunque con un significado diferente, la API seguirá mostrando datos si no actualizas el nombre de la métrica. Por supuesto, puedes modificar tu aplicación para recuperar y mostrarviews
yplaylistViews
.Además de la dimensión
isCurated
, ya no se admite la siguiente funcionalidad de la API en los informes nuevos:- Los filtros de ubicación, como
continent
ysubcontinent
, no son compatibles con los nuevos informes de listas de reproducción de canales. - Las métricas
redViews
yestimatedRedMinutesWatched
ya no son compatibles con los nuevos informes de playlists de canales. Estas métricas no están disponibles en YouTube Studio, por lo que el cambio alinea la funcionalidad de la API con la que está disponible en la app de Studio. - Las dimensiones
subscribedStatus
yyoutubeProduct
ya no se admiten como filtros para los informes de listas de reproducción de canales. Estos filtros no estaban disponibles en YouTube Studio, por lo que este cambio alinea la funcionalidad de la API con la que está disponible en la app de Studio.
- Los filtros de ubicación, como
-
Se actualizó la sección de informes de listas de reproducción de la documentación de informes de propietarios del contenido para explicar con más detalle los tipos de métricas compatibles con los informes de listas de reproducción:
- Las métricas agregadas de video proporcionan métricas de impresiones y actividades del usuario que se agregan para todos los videos en las playlists del propietario del contenido que también son propiedad de ese propietario. Las métricas de video agregadas solo se admiten para las solicitudes a la API que no usan la dimensión
isCurated
. - Las métricas en la playlist reflejan la actividad y la participación de los usuarios en el contexto de la página de la playlist. Estas métricas incluyen datos de las vistas de videos que no son de tu propiedad en la playlist, pero solo cuando esas vistas se producen en el contexto de la playlist.
- La sección métricas de playlists admitidas identifica las métricas globales de los videos y las métricas dentro de las playlists que se admiten en los informes de listas de reproducción.
- Las métricas agregadas de video proporcionan métricas de impresiones y actividades del usuario que se agregan para todos los videos en las playlists del propietario del contenido que también son propiedad de ese propietario. Las métricas de video agregadas solo se admiten para las solicitudes a la API que no usan la dimensión
-
Las siguientes métricas nuevas en la playlist son compatibles con los informes de listas de reproducción para propietarios de contenido. Ten en cuenta que estas métricas solo se admiten si la solicitud a la API para recuperar los informes no usa la dimensión
isCurated
. Consulta la documentación sobre metrics para obtener definiciones de cada métrica: -
El comportamiento de la métrica
views
ahora depende de si la solicitud a la API que recuperó el informe de la playlist usó la dimensiónisCurated
:- Cuando una solicitud incluye la dimensión
isCurated
, la métricaviews
es una métrica dentro de la playlist que indica la cantidad de veces que se vieron videos en el contexto de las playlists del propietario del contenido. - Cuando una solicitud no incluye la dimensión
isCurated
, la métricaviews
es una métrica de video agregada que especifica la cantidad total de veces que se vieron los videos de las playlists del propietario del contenido, independientemente de si esas vistas se produjeron en el contexto de la playlist. El total agregado incluye solo las vistas de los videos que pertenecen al propietario del contenido asociado con el canal al que pertenece la playlist.
En estos informes, que no usan la dimensiónisCurated
, la métricaplaylistViews
indica la cantidad de veces que se vieron videos en el contexto de la playlist. Esa métrica cuenta las vistas de todos los videos de la playlist, sin importar el canal que los posea.
- Cuando una solicitud incluye la dimensión
-
Para cada informe de playlist, la documentación de informes de propietarios de contenido ahora incluye tablas que muestran las métricas compatibles para ese informe, en función de si la solicitud a la API incluye la dimensión
isCurated
. Para ver un ejemplo, consulta la sección en la que se definen los informes de listas de reproducción basadas en el tiempo.
19 de enero de 2024
La API de YouTube Analytics (búsquedas segmentadas) tiene varias actualizaciones relacionadas con los informes de playlists de canales. Las actualizaciones incluyen una dimensión obsoleta y varias métricas nuevas y actualizadas:
-
Nota: Este es un anuncio de baja.
La dimensión
isCurated
dejó de estar disponible para los informes de canales. Ya no se admitirá a partir del 30 de junio de 2024. La definición de esa dimensión se actualizó según corresponda.Para conservar la retrocompatibilidad cuando quitas la dimensión
isCurated
, también debes actualizar tu código para recuperar la métricaplaylistViews
, en lugar de la métricaviews
, solo para los informes de listas de reproducción. Debido a que la métricaviews
sigue siendo compatible con los informes de listas de reproducción, aunque con un significado diferente, la API seguirá mostrando datos si no actualizas el nombre de la métrica. Por supuesto, puedes modificar tu aplicación para recuperar y mostrarviews
yplaylistViews
.Además de la dimensión
isCurated
, ya no se admite la siguiente funcionalidad de la API en los informes nuevos:- Los filtros de ubicación, como
continent
ysubcontinent
, no son compatibles con los nuevos informes de listas de reproducción de canales. - Las métricas
redViews
yestimatedRedMinutesWatched
ya no son compatibles con los nuevos informes de playlists de canales. Estas métricas no están disponibles en YouTube Studio, por lo que el cambio alinea la funcionalidad de la API con la que está disponible en la app de Studio. - Las dimensiones
subscribedStatus
yyoutubeProduct
ya no se admiten como filtros para los informes de listas de reproducción de canales. Estos filtros no estaban disponibles en YouTube Studio, por lo que este cambio alinea la funcionalidad de la API con la que está disponible en la app de Studio.
- Los filtros de ubicación, como
-
La sección de informes de listas de reproducción de la documentación de informes de canales se actualizó para explicar con más detalle los tipos de métricas compatibles con los informes de listas de reproducción:
- Las métricas globales de video proporcionan métricas de impresiones y actividades del usuario que se agregan para todos los videos de las playlists del canal que también son propiedad de ese canal. Las métricas de video agregadas solo se admiten para las solicitudes a la API que no usan la dimensión
isCurated
. - Las métricas en la playlist reflejan la actividad y la participación de los usuarios en el contexto de la página de la playlist. Estas métricas incluyen datos de las vistas de videos que no son de tu propiedad en la playlist, pero solo cuando esas vistas se producen en el contexto de la playlist.
- La sección métricas de playlists admitidas identifica las métricas globales de los videos y las métricas dentro de las playlists que se admiten en los informes de listas de reproducción.
- Las métricas globales de video proporcionan métricas de impresiones y actividades del usuario que se agregan para todos los videos de las playlists del canal que también son propiedad de ese canal. Las métricas de video agregadas solo se admiten para las solicitudes a la API que no usan la dimensión
-
Las siguientes métricas nuevas de un en la playlist son compatibles con los informes de listas de reproducción de canales. Estas métricas aún no son compatibles con los informes de propietarios de contenido. Ten en cuenta que estas métricas solo se admiten si la solicitud a la API para recuperar los informes no usa la dimensión
isCurated
. Consulta la documentación sobre metrics para obtener definiciones de cada métrica: -
El comportamiento de la métrica
views
ahora depende de si la solicitud a la API que recuperó el informe de la playlist usó la dimensiónisCurated
:- Cuando una solicitud incluye la dimensión
isCurated
, la métricaviews
es una métrica dentro de la playlist que indica la cantidad de veces que se vieron videos en el contexto de las playlists del canal. - Cuando una solicitud no incluye la dimensión
isCurated
, la métricaviews
es una métrica de video agregada que especifica la cantidad total de veces que se miró un video de las playlists del canal, independientemente de si esas vistas se produjeron en el contexto de la playlist. El total agregado incluye solo las vistas de los videos que pertenecen al canal propietario de la playlist.
En estos informes, que no usan la dimensiónisCurated
, la métricaplaylistViews
indica la cantidad de veces que se vieron videos en el contexto de la playlist. Esa métrica cuenta las vistas de todos los videos de la playlist, sin importar el canal que los posea.
- Cuando una solicitud incluye la dimensión
-
Para cada informe de lista de reproducción, la documentación de informes de canales ahora incluye tablas que muestran las métricas compatibles para ese informe, en función de si la solicitud a la API incluye la dimensión
isCurated
. Para ver un ejemplo, consulta la sección en la que se definen los informes de listas de reproducción basadas en el tiempo.
4 de diciembre de 2023
Se actualizó la API de YouTube Analytics (búsquedas segmentadas) para combinar dos valores de dimensión insightTrafficSourceType
. Anteriormente, se diferenciaba la dimensión de los videos reproducidos como parte de una playlist (PLAYLIST
) y las vistas que se originaban en una página que enumera todos los videos de una playlist (YT_PLAYLIST_PAGE
). En el futuro, ambos tipos de vistas se asociarán con el valor de la dimensión PLAYLIST
.
15 de diciembre de 2022
La API de YouTube Analytics (búsquedas segmentadas) admite dos dimensiones y un informe nuevos:
-
Un nuevo informe muestra la actividad de los usuarios por ciudad. Este informe está disponible para los canales y los propietarios del contenido. Este informe contiene la nueva dimensión
city
, que identifica la estimación de YouTube sobre la ciudad donde tuvo lugar la actividad del usuario. -
La nueva dimensión
creatorContentType
identifica el tipo de contenido de YouTube asociado con las métricas de actividad del usuario en la fila de datos. Los valores admitidos sonLIVE_STREAM
,SHORTS
,STORY
yVIDEO_ON_DEMAND
.La dimensión
creatorContentType
se admite como una dimensión opcional para todos los informes de video del propietario del contenido y del canal. -
Ahora, la guía de muestras de solicitudes de la API de YouTube Analytics incluye ejemplos para ambas dimensiones nuevas.
-
Las referencias a las dimensiones
7DayTotals
y30DayTotals
se quitaron de la documentación. Estas dimensiones se anunció que dejarán de estar disponibles en octubre de 2019.
26 de agosto de 2022
La API de YouTube Analytics (consultas segmentadas) y la API de informes masivos de YouTube admiten un nuevo valor detallado de fuente de tráfico:
- En la API de la API de YouTube Analytics (Targeted Queries), si el valor de la dimensión
insightTrafficSourceType
esSUBSCRIBER
, el valorinsightTrafficSourceDetail
se puede establecer enpodcasts
, lo que indica que el tráfico proviene de la página de destino de Podcasts. - En la API de informes masivos de YouTube, si el valor de la dimensión
traffic_source_type
es3
, el valortraffic_source_detail
se puede establecer enpodcasts
, lo que indica que el tráfico proviene de la página de destino de Podcasts.
11 de febrero de 2022
El conjunto de valores válidos para la dimensión gender
cambiará a partir del 11
de agosto de 2022. Esto podría ser un cambio que genere incompatibilidad con versiones anteriores de la implementación de tu API. Conforme a la sección Cambios incompatibles con versiones anteriores de las Condiciones del Servicio de la API de YouTube, este cambio se anuncia seis meses antes de su entrada en vigencia. Actualiza tu implementación de la API antes del 11 de agosto de 2022 para garantizar una transición sin problemas al nuevo conjunto de valores.
Los cambios específicos que se harán son los siguientes:
- Actualmente, en la API de YouTube Analytics (búsquedas segmentadas), la dimensión
gender
admite dos valores:female
ymale
. A partir del 11 de agosto de 2022, esa dimensión admitirá tres valores:female
,male
yuser_specified
. - En la API de informes de YouTube (informes masivos), la dimensión
gender
actualmente admite tres valores:FEMALE
,MALE
yGENDER_OTHER
. A partir del 11 de agosto de 2022, el conjunto de valores admitidos cambiará aFEMALE
,MALE
yUSER_SPECIFIED
.
9 de febrero de 2022
Desde el 13 de diciembre de 2021, se actualizaron dos métricas para excluir el tráfico de clips en bucle. Este cambio afecta a la API de YouTube Analytics (búsquedas segmentadas) y a la API de informes masivos de YouTube.
- En la API de YouTube Analytics (búsquedas segmentadas), las métricas
averageViewDuration
yaverageViewPercentage
excluyen el tráfico de clips en bucle desde el 13 de diciembre de 2021. - En la API de informes masivos de YouTube, las métricas
average_view_duration_seconds
yaverage_view_duration_percentage
excluyen el tráfico de clips en bucle desde el 13 de diciembre de 2021.
2 de febrero de 2022
Esta API de informes masivos de YouTube admite un nuevo valor de dimensión de fuente de tráfico que indica que las vistas se originaron en Live Redirects:
- En la API de informes masivos de YouTube, la dimensión
traffic_source_type
admite el valor28
.
Para este tipo de fuente de tráfico, la dimensión traffic_source_detail
especifica el ID del canal desde el que se hizo referencia al usuario.
23 de septiembre de 2020
Esta API de YouTube Analytics (búsquedas segmentadas) y la API de informes masivos de YouTube admiten un nuevo valor de dimensión de fuente de tráfico que indica que se recomendó al usuario deslizando el dedo verticalmente en la experiencia de visualización de YouTube Shorts:
- En la API de la API de YouTube Analytics (búsquedas segmentadas), la dimensión
insightTrafficSourceType
admite el valorSHORTS
. - En la API de informes masivos de YouTube, la dimensión
traffic_source_type
admite el valor24
.
La dimensión de detalles de la fuente de tráfico (insightTrafficSourceDetail
en la API de YouTube Analytics o traffic_source_detail
en la API de informes de YouTube) no se propaga para este tipo de fuente de tráfico nuevo.
20 de julio de 2020
Esta actualización abarca dos cambios que afectan a la API de YouTube Analytics (consultas segmentadas):
- El tamaño máximo de un grupo de informes de YouTube Analytics aumentó de 200 a 500 entidades.
- El parámetro
filters
del métodoreports.query
identifica una lista de filtros que se deben aplicar cuando se recuperan datos de YouTube Analytics. El parámetro admite la capacidad de especificar varios valores para los filtrosvideo
,playlist
ychannel
, y la cantidad máxima de IDs que se pueden especificar para esos filtros aumentó de 200 a 500 IDs.
13 de febrero de 2020
Esta actualización incluye los siguientes cambios relacionados con la API de YouTube Analytics (consultas segmentadas) y la API de informes masivos de YouTube. Obtén más información sobre estos cambios en el Centro de ayuda de YouTube.
En ambas APIs, está cambiando el conjunto de posibles valores detallados de las fuentes de tráfico para las notificaciones.
En las consultas segmentadas, las notificaciones se informan como insightTrafficSourceType=NOTIFICATION
. En los informes masivos, las notificaciones se informan como traffic_source_type=17
.
Los nuevos valores dividen las notificaciones relacionadas con videos subidos y transmisiones en vivo, que antes se registraban como uploaded
, en dos categorías:
uploaded_push
: Las vistas se originaron a partir de notificaciones push enviadas a los suscriptores cuando se subió un video.uploaded_other
: Son las vistas que se originan a partir de notificaciones no push, como las notificaciones por correo electrónico o Recibidos, que se envían a los suscriptores cuando se sube un video.
Estos valores se muestran para el intervalo de tiempo que comienza el 13/01/2020 (13 de enero de 2020).
Además, a modo de recordatorio, estos valores no representan las notificaciones, sino las fuentes de tráfico que generaron determinadas vistas de YouTube. Por ejemplo, si una fila de informe indica views=3
, traffic_source_type=17
(NOTIFICATION
) y traffic_source_detail=uploaded_push
, la fila indica que se obtuvieron tres vistas de los usuarios que hicieron clic en las notificaciones push enviadas cuando se subió el video.
15 de octubre de 2019
Esta actualización incluye los siguientes cambios relacionados con la API de YouTube Analytics (búsquedas segmentadas):
-
Nota: Este es un anuncio de baja.
YouTube quitará la compatibilidad con las dimensiones
7DayTotals
y30DayTotals
. Podrás recuperar datos utilizando esas dimensiones hasta el 15 de abril de 2020. A partir de esa fecha, los intentos de recuperar informes con las dimensiones7DayTotals
o30DayTotals
mostrarán un error.Ten en cuenta que los usuarios pueden reproducir algunos de los datos de estas dimensiones realizando consultas con la dimensión
day
y agregando o derivando datos en períodos de siete o 30 días. Por ejemplo:- Para calcular el número de reproducciones en un período de siete días, se suma la cantidad de reproducciones de cada día de ese período.
- ElviewerPercentage para un período de siete días se puede calcular multiplicando la cantidad de vistas que se produjeron cada día por el valor del valor de audiencePercentage de ese día para conocer la cantidad de usuarios que accedieron al video cuando vieron el video ese día. Luego, se puede agregar la cantidad de usuarios que accedieron a sus cuentas para todo el período y dividirla por la cantidad total de vistas de ese período para obtener el valor deviewerPercentage de todo el período.
- No se puede calcular la cantidad de usuarios únicos de un período de siete días, ya que se puede calcular el mismo usuario como un usuario único durante distintos días. Sin embargo, es posible que puedas usar la dimensión
month
en lugar de la dimensión30DayTotals
para extrapolar datos sobre la cantidad de usuarios únicos durante un período de 30 días. Ten en cuenta que la dimensiónmonth
hace referencia a los meses calendario, mientras que la dimensión30DayTotals
calcula períodos de 30 días según las fechas de inicio y finalización especificadas.
27 de junio de 2019
Esta actualización incluye los siguientes cambios relacionados con la API de YouTube Analytics (búsquedas segmentadas):
-
Dado que la versión 1 de la API dejó de estar disponible por completo, se actualizó la documentación para quitar las referencias a esa versión, incluido el aviso de baja y la guía de migración en la que se explica cómo actualizar a la versión 2.
1 de noviembre de 2018
Esta actualización incluye los siguientes cambios relacionados con la API de YouTube Analytics (búsquedas segmentadas):
-
La versión 1 de la API dejó de estar disponible. Si aún no lo has hecho, actualiza tus clientes de API para que usen la versión 2 de la API lo antes posible y, así, minimizar las interrupciones del servicio. Consulta la guía de migración para obtener más detalles.
Ten en cuenta que el programa de esta baja se anunció por primera vez el 26 de abril de 2018.
17 de septiembre de 2018
Esta actualización incluye los siguientes cambios relacionados con la API de YouTube Analytics (búsquedas segmentadas):
-
En la nueva sección sobre anonimización de datos del documento de descripción general Modelo de datos, se explica que algunos datos de YouTube Analytics están limitados cuando las métricas no cumplen con un umbral específico. Esto puede ocurrir en diversos casos. En la práctica, significa que un informe podría no contener todos (ni algunos) tus datos si:
-
un video o canal tiene tráfico limitado durante un período específico
o
-
Seleccionaste un filtro o una dimensión, como una fuente de tráfico o un país, para los que los valores no cumplen con un umbral determinado.
En la nueva sección, también se incluyen los tipos de datos que podrían estar limitados en los informes de YouTube Analytics.
-
-
Los documentos de informes de canales e informes de propietarios de contenido se actualizaron para reflejar que las métricas
redViews
yestimatedRedMinutesWatched
ya no son compatibles con los informes de ubicación de reproducción, fuente de tráfico ni tipo de dispositivo o sistema operativo.
18 de junio de 2018
Esta actualización incluye los siguientes cambios en la API de YouTube Analytics (consultas segmentadas):
- Cambiaron los requisitos de alcance para los siguientes métodos:
- Las solicitudes al método
reports.query
deben tener acceso al alcancehttps://www.googleapis.com/auth/youtube.readonly
. - Las solicitudes al método
groupItems.list
deben tener acceso a lo siguiente:- el
https://www.googleapis.com/auth/youtube
alcance
o - el permiso
https://www.googleapis.com/auth/youtube.readonly
y
el permisohttps://www.googleapis.com/auth/yt-analytics.readonly
La primera opción usa un alcance, que resulta ser un alcance de lectura y escritura, mientras que la segunda usa dos alcances de solo lectura.
- el
- Las solicitudes al método
23 de mayo de 2018
Esta actualización incluye los siguientes cambios en la API de YouTube Analytics (consultas segmentadas):
- La descripción general de la API contiene una nueva sección, métricas agregadas y elementos borrados, que explica cómo las respuestas de la API manejan los datos asociados con recursos borrados, como videos, playlists o canales.
- La sección de prácticas recomendadas de la descripción general de la API se actualizó para recordarte que puedes usar la API de datos de YouTube para recuperar metadatos adicionales para los recursos identificados en las respuestas de la API de YouTube Analytics. Como se indica en las Políticas para Desarrolladores de los Servicios de la API de YouTube (artículos III.E.4.b a III.E.4.d), los clientes de la API deben borrar o actualizar los metadatos de recursos almacenados de la API después de 30 días.
22 de mayo de 2018
Esta actualización incluye los siguientes cambios relacionados con la API de informes masivos de YouTube:
- Actualmente, los siguientes cambios están programados para entrar en vigencia en julio de 2018, y las nuevas políticas se aplican a nivel global a todos los trabajos de informes y generación de informes.
-
Después del cambio, la mayoría de los informes de las APIs, incluidos los informes de reabastecimiento, estarán disponibles durante 60 días desde la fecha en que se generan. Sin embargo, los informes que contengan datos históricos estarán disponibles durante 30 días desde la fecha en que se crearon.
Antes de este anuncio, todos los informes de las APIs estaban disponibles durante 180 días desde la fecha en que se crearon. Para ser claros, cuando entre en vigencia este cambio de política, tampoco se podrá acceder a los informes de datos históricos que tengan más de 30 días de antigüedad a través de la API. Tampoco podrá acceder a los demás informes con más de 60 días de antigüedad. Por lo tanto, la documentación ahora indica que los informes creados antes del cambio de política estarán disponibles por hasta 180 días.
-
Después del cambio, cuando programes un trabajo de informes, YouTube generará informes a partir de ese día, que abarcarán el período de 30 días anterior a la hora en que se programó el trabajo. Antes del cambio, cuando programes un trabajo de informe, YouTube generará informes que abarquen el período de 180 días previos a la hora en que se programó el trabajo.
-
-
La sección de prácticas recomendadas se actualizó para recordarte que puedes usar la API de datos de YouTube para recuperar metadatos adicionales de los recursos identificados en los informes. Como se indica en las Políticas para Desarrolladores de los Servicios de la API de YouTube (artículos III.E.4.b a III.E.4.d), los clientes de la API deben borrar o actualizar los metadatos de recursos almacenados de la API después de 30 días.
-
La sección Características de informes se actualizó para indicar que, aunque los datos de los informes no se hayan filtrado, los informes que contengan datos de un período a partir del 1 de junio de 2018 no incluirán ninguna referencia a los recursos de YouTube que se borraron al menos 30 días antes de la fecha en que se generó el informe.
-
La sección Datos históricos de la descripción general de la API se actualizó para indicar que cuando se programa un nuevo trabajo de informes, los informes históricos se publican, por lo general, en un par de días. Anteriormente, en la documentación se indicaba que los informes podían tardar hasta 30 días en estar disponibles.
-
Se actualizó la sección de datos de reabastecimiento de la descripción general de la API para definir con mayor claridad los datos de reabastecimiento como un conjunto de datos que reemplaza un conjunto publicado anteriormente.
26 de abril de 2018
La versión 2 de la API (v2) de YouTube Analytics (consultas segmentadas) ya está disponible para el público. En la siguiente lista se identifican los cambios de productos y documentación relacionados con la nueva versión de la API:
-
La API v2 es casi idéntica a la API v1. Sin embargo, es probable que debas actualizar tu código para reflejar los cambios que se indican a continuación. Todos estos cambios se explican en detalle en la nueva guía de migración.
- La versión de la API cambió de
v1
av2
. - La URL base para las solicitudes a la API cambió de
https://www.googleapis.com/youtube/analytics/v1
ahttps://youtubeanalytics.googleapis.com/v2
. - Varios parámetros del método
reports.query
tienen nombres actualizados. Específicamente, los nombres de parámetros que contienen guiones, comoend-date
en la API v1, usan mayúsculas mediales (endDate
) en lugar de guiones en la API v2. Este cambio hace que los nombres de parámetros sean coherentes en toda la API, ya que los métodos de la API para crear y administrar grupos ya usaban el uso de mayúsculas mediales para los nombres de parámetros. - La API v2 no admite solicitudes por lotes enviadas al extremo de lotes HTTP global de Google (
www.googleapis.com/batch
). Si envías solicitudes por lotes en la API v2, debes usar el extremohttps://youtubeanalytics.googleapis.com/v2
en su lugar.
Además, la API v2 no admite algunas funciones de la v1:
- El método
reports.query
ya no admite los parámetros de solicitudalt
,quotaUser
yuserIp
. - La API v2 no proporciona un extremo de lote que admita lotes compuestos de solicitudes a diferentes API. (Sin embargo, un lote puede estar compuesto por solicitudes a diferentes métodos de la misma API). Esta baja no es específica de la API de YouTube Analytics, ya que Google dará de baja el extremo de lote global en todas sus APIs.
- La API v2 no es compatible con el protocolo JSON-RPC, que era compatible con la API v1. Recuerda que esta baja no es específica para la API de YouTube Analytics.
- La versión de la API cambió de
-
Nota: Este es un anuncio de baja.
La versión 1 de la API (v1) dejó de estar disponible y se admitirá hasta el 31 de octubre de 2018. Todas las solicitudes a la API v1 dejarán de funcionar después de esa fecha. Por lo tanto, asegúrate de actualizar a la versión 2 de la API a más tardar el 31 de octubre de 2018 para evitar interrupciones en el acceso a los datos de YouTube Analytics mediante la API.
21 de febrero de 2018
Esta actualización incluye los siguientes cambios en la API de YouTube Analytics (consultas segmentadas):
- Los informes demográficos de los usuarios, que agregan estadísticas de reproducción según el grupo etario y el género de los espectadores, ya no admiten la dimensión
youtubeProduct
, que identifica el servicio de YouTube en el que se produjo la actividad del usuario.
18 de enero de 2018
Esta actualización incluye los siguientes cambios:
-
API de YouTube Reporting (informes masivos)
- La dimensión
operating_system
, que identifica el sistema de software del dispositivo en el que se produjeron las vistas, ahora admite el siguiente valor:25
: KaiOS
- La dimensión
-
API de YouTube Analytics (búsquedas segmentadas)
- La dimensión
operatingSystem
admite el valor de dimensiónKAIOS
.
- La dimensión
20 de diciembre de 2017
Esta actualización incluye dos cambios relacionados con la API de informes de YouTube:
-
El servidor de la API ahora admite la compresión gzip para las solicitudes que descargan informes. Ten en cuenta que la compresión gzip no es compatible con otros tipos de solicitudes a la API. Si habilitas la compresión gzip, se reduce el ancho de banda necesario para cada respuesta de la API. Si bien tu aplicación necesitará tiempo de CPU adicional para descomprimir las respuestas de la API, el beneficio de consumir menos recursos de red suele superar ese costo.
Para recibir una respuesta codificada en gzip, configura el encabezado de la solicitud HTTP
Accept-Encoding
comogzip
, como se muestra en el siguiente ejemplo:Accept-Encoding: gzip
Esta funcionalidad se explica en la descripción general de la API y en la definición de la propiedad
downloadUrl
del recursoreport
. -
Se corrigió la documentación de las dimensiones
age group
ygender
a fin de mostrar los valores reales que la API muestra para esas dimensiones. Ten en cuenta que esta es una corrección de documentación y no refleja un cambio en la funcionalidad o el comportamiento de la API. Específicamente, cambiaron los siguientes valores:- Los valores de la dimensión
age_group
usan letras mayúsculas, contienen guiones bajos entre la palabraAGE
y los números de la edad, y usan guiones bajos en lugar de guiones. Por lo tanto, los valores comoage13-17
yage18-24
se corrigieron aAGE_13_17
yAGE_18_24
, respectivamente. - Los valores de la dimensión
gender
usan letras mayúsculas. Por lo tanto, los valoresfemale
,male
ygender_other
se corrigieron aFEMALE
,MALE
yGENDER_OTHER
.
- Los valores de la dimensión
10 de agosto de 2017
El 10 de agosto de 2016, mediante esta documentación, se anunció la baja de la métrica earnings
de la API de YouTube Analytics. (Al mismo tiempo, la API agregó compatibilidad con una métrica nueva, llamada estimatedRevenue
, que proporciona los mismos datos).
Dado que la métrica earnings
era una métrica principal, se admitió durante un año a partir de la fecha del anuncio. Sin embargo, ahora que ese período de un año finalizó, la métrica earnings
ya no es compatible. Como resultado, las solicitudes a la API que especifican la métrica earnings
ahora muestran un código de respuesta HTTP 400
. Si aún no actualizaste tu app para que use la métrica estimatedRevenue
en lugar de la métrica earnings
, hazlo lo antes posible.
Se actualizó la documentación de la API para quitar las referencias restantes a la métrica earnings
.
6 de julio de 2017
Esta actualización incluye los siguientes cambios:
-
API de YouTube Analytics (búsquedas segmentadas)
-
La documentación de la API se actualizó para reflejar el hecho de que las respuestas de la API contienen datos hasta el último día en el período solicitado para el que todas las métricas que se consultan están disponibles.
Por ejemplo, si una solicitud especifica la fecha de finalización el 5 de julio de 2017 y los valores de todas las métricas solicitadas solo están disponibles hasta el 3 de julio de 2017, esa será la última fecha para la que se incluirán datos en la respuesta. (Esto es así incluso si los datos de algunas de las métricas solicitadas están disponibles para el 4 de julio de 2017).
-
Ahora, la dimensión
adType
admite el valorreservedBumperInstream
, que hace referencia a un anuncio de video que no se puede omitir y tiene un máximo de 6 segundos que se reproduce antes de mirar el video. El formato del anuncio es idéntico al del anuncioauctionBumperInstream
, pero este tipo hace referencia a los anuncios que se venden mediante reserva en lugar de hacerlo por subasta.
-
-
API de YouTube Reporting (informes masivos)
-
La dimensión
ad_type
ahora admite el valor20
, que hace referencia a los anuncios bumper que se venden en forma reservada. Los anuncios bumper son anuncios de video que no se pueden omitir y duran un máximo de 6 segundos que se reproducen antes de que se inicie el video. Ten en cuenta que el valor19
de esta dimensión también alude a los anuncios bumper que se venden mediante una subasta en lugar de una reserva. -
Se borraron los trabajos de informes para los siguientes informes de la API de informes de YouTube:
channel_basic_a1
channel_province_a1
channel_playback_location_a1
channel_traffic_source_a1
channel_device_os_a1
channel_subtitles_a1
channel_combined_a1
content_owner_basic_a2
content_owner_province_a1
content_owner_playback_location_a1
content_owner_traffic_source_a1
content_owner_device_os_a1
content_owner_subtitles_a1
content_owner_combined_a1
content_owner_asset_basic_a1
content_owner_asset_province_a1
content_owner_asset_playback_location_a1
content_owner_asset_traffic_source_a1
content_owner_asset_device_os_a1
content_owner_asset_combined_a1
Estos tipos de informes se dieron de baja el 15 de septiembre de 2016 y, a partir del 15 de diciembre de 2016, ya no se generaban informes para esos tipos de informes. Los informes generados con anterioridad permanecían disponibles durante 180 días desde la fecha en que se generaron. Por lo tanto, algunos informes estuvieron accesibles desde el 15 de junio de 2017. Sin embargo, dado que los informes ya no están disponibles, tampoco se necesitan los trabajos asociados con ellos.
-
24 de mayo de 2017
Se borraron todos los trabajos de informes de los siguientes informes de la API de informes de YouTube:
content_owner_ad_performance_a1
content_owner_asset_estimated_earnings_a1
content_owner_estimated_earnings_a1
Estos tipos de informes se dieron de baja el 22 de junio de 2016 y, después del 22 de septiembre de 2016, ya no se generaban informes para esos tipos de informes. Los informes generados con anterioridad permanecían disponibles durante 180 días desde la fecha en que se generaron. Por lo tanto, algunos informes fueron accesibles desde el 22 de marzo de 2017. Sin embargo, dado que los informes ya no están disponibles, tampoco se necesitan los trabajos asociados con ellos.
22 de mayo de 2017
Esta actualización incluye los siguientes cambios:
-
API de YouTube Reporting (informes masivos)
- La dimensión
sharing_service
, que identifica el servicio que se usó para compartir videos, ahora admite los siguientes valores:85
: YouTube Music86
: YouTube Gaming87
: YouTube Kids88
: YouTube TV
Además, en la documentación, se actualizó el nombre que se usa para identificar el valor
52
a Kakao (Kakao Talk) para diferenciarlo con mayor claridad del valor73
(Kakao Story). Este cambio no refleja ninguna modificación en el comportamiento de la API ni en la clasificación de los videos compartidos con estos servicios.
- La dimensión
-
API de YouTube Analytics (búsquedas segmentadas)
- La dimensión
sharingService
ahora admite los siguientes valores:YOUTUBE_GAMING
YOUTUBE_KIDS
YOUTUBE_MUSIC
YOUTUBE_TV
- La dimensión
28 de marzo de 2017
Los propietarios de canales que pueden acceder a los datos de ingresos a través de YouTube Analytics en Creator Studio ahora también pueden acceder a ellos mediante la API de YouTube Analytics:
-
La API admite las siguientes métricas relacionadas con los ingresos:
adImpressions
cpm
estimatedAdRevenue
estimatedRedPartnerRevenue
estimatedRevenue
grossRevenue
monetizedPlaybacks
playbackBasedCpm
Estas métricas son compatibles con los siguientes informes:
-
Los propietarios de canal ahora también pueden recuperar un informe de rendimiento del anuncio, que admite las dimensiones
adType
yday
, que es opcional. -
Ahora, la guía de solicitudes de ejemplo de la API de YouTube Analytics incluye una sección para los informes de ingresos de los canales.
17 de marzo de 2017
Esta actualización incluye los siguientes cambios:
-
La API de YouTube Analytics es compatible con las métricas
redViews
yestimatedRedMinutesWatched
, que se relacionan con los usuarios de YouTube Red. De hecho, hace tiempo que la API es compatible con estas métricas, y la API de informes de YouTube ya admite ambas métricas, como se anunció el 15 de septiembre de 2016.- La métrica
redViews
identifica la cantidad de veces que los miembros de YouTube Red vieron un video. - La métrica
estimatedRedMinutesWatched
identifica la cantidad de minutos que los miembros de YouTube Red miraron un video.
La documentación de los informes de canales y de los informes de propietarios de contenido se actualizó para mostrar qué informes admiten las dos métricas nuevas. Se admiten en todos los informes que ya admitían las métricas
views
yestimatedMinutesWatched
. - La métrica
3 de marzo de 2017
Esta actualización incluye los siguientes cambios:
-
API de YouTube Reporting (informes masivos)
-
Se corrigió la definición de la dimensión
date
para tener en cuenta que el valor de la dimensión hace referencia al período que comienza a las 12:00 a.m. de la hora del Pacífico y finaliza a las 11:59 p.m. (hora del Pacífico) del día, mes y año especificados. Según la época del año, la hora del Pacífico puede ser UTC-7 o UTC-8.Si bien las fechas suelen representar un período de 24 horas, las fechas en las que los relojes se ajustan hacia adelante representan un período de 23 horas y las fechas en las que se ajustan los relojes representan un período de 25 horas. (Anteriormente, la documentación indicaba que cada fecha representaba un período único de 24 horas y que la hora del Pacífico siempre era UTC-8).
Ten en cuenta que esta corrección no representa un cambio en el comportamiento real de la API.
- La dimensión
operating_system
, que identifica el sistema de software del dispositivo en el que se produjeron las vistas, ahora admite los siguientes valores:22
: Tizen23
: Firefox24
: RealMedia
-
Se borraron todos los trabajos de informes para el tipo de informe
content_owner_basic_a1
. Ese tipo de informe dejó de estar disponible el 19 de agosto de 2016, pero los informes decontent_owner_basic_a1
generados anteriormente siguen disponibles por 180 días desde la fecha en que se crearon. Por lo tanto, algunos informes estuvieron accesibles desde el 19 de febrero de 2017. Sin embargo, dado que los informes ya no están disponibles, tampoco se necesitan los trabajos asociados con ellos.
-
-
API de YouTube Analytics (búsquedas segmentadas)
-
Se corrigió la descripción de las dimensiones relacionadas con
time periods
para tener en cuenta que el valor de la dimensión hace referencia al período que comienza a las 12:00 a.m. de la hora del Pacífico y finaliza a las 11:59 p.m. (hora del Pacífico) del día, mes y año especificados. Según la época del año, la hora del Pacífico puede ser UTC-7 o UTC-8.Si bien las fechas suelen representar un período de 24 horas, las fechas en las que los relojes se ajustan hacia adelante representan un período de 23 horas y las fechas en las que se ajustan los relojes representan un período de 25 horas. (Anteriormente, la documentación indicaba que la hora del Pacífico era UTC-8 y no mencionaba la posibilidad de que un día no represente un período de 24 horas).
Ten en cuenta que esta corrección no representa un cambio en el comportamiento real de la API.
-
La documentación de los informes de canales se actualizó para indicar que, actualmente, estos informes no contienen métricas de ingresos ni de rendimiento de los anuncios. Como resultado, actualmente el alcance
https://www.googleapis.com/auth/yt-analytics-monetary.readonly
no otorga acceso a los datos monetarios en los informes de canales. - La dimensión
operatingSystem
admite tres nuevos valores de dimensión:FIREFOX
REALMEDIA
TIZEN
-
8 de febrero de 2017
La API de YouTube Analytics ahora admite el parámetro opcional include-historical-channel-data
. Ten en cuenta que este parámetro solo es relevante cuando se recuperan informes de propietarios de contenido.
El parámetro permite que un propietario del contenido indique que una respuesta de la API debe incluir el tiempo de reproducción y los datos de visualización de los canales desde el período anterior a la vinculación de los canales con el propietario del contenido. El valor del parámetro predeterminado es false
, lo que significa que, de forma predeterminada, la respuesta de la API solo incluye el tiempo de reproducción y los datos de visualización desde el momento en que los canales se vincularon con el propietario del contenido.
Estas reglas también se aplican si la solicitud a la API recupera datos de varios canales:
- Si el valor del parámetro es
false
, los datos de tiempo de reproducción y vistas que se muestran de un canal determinado se basan en la fecha en la que ese canal se vinculó con el propietario del contenido.
Es importante recordar que varios canales podrían haberse vinculado a un propietario del contenido en fechas diferentes. Si la solicitud a la API recupera datos de varios canales y el valor del parámetro esfalse
, la respuesta de la API contiene el tiempo de reproducción y los datos de visualización según la fecha de vinculación para cada canal respectivo. - Si el valor del parámetro es
true
, la respuesta muestra el tiempo de reproducción y los datos de visualización de todos los canales según las fechas de inicio y finalización especificadas en la solicitud a la API.
15 de diciembre de 2016
Los siguientes informes de la API de informes de YouTube ya no son compatibles y se quitaron de la documentación. Hay una versión más reciente de cada informe disponible. (El anuncio de baja de estos informes se realizó el 15 de septiembre de 2016).
-
Informes de canales
channel_basic_a1
: Se reemplazó por el informechannel_basic_a2
.channel_province_a1
: Se reemplazó por el informechannel_province_a2
.channel_playback_location_a1
: Se reemplazó por el informechannel_playback_location_a2
.channel_traffic_source_a1
: Se reemplazó por el informechannel_traffic_source_a2
.channel_device_os_a1
: Se reemplazó por el informechannel_device_os_a2
.channel_subtitles_a1
: Se reemplazó por el informechannel_subtitles_a2
.channel_combined_a1
: Se reemplazó por el informechannel_combined_a2
.
-
Informes de propietarios de contenido
content_owner_basic_a2
: Se reemplazó por el informecontent_owner_basic_a3
.content_owner_province_a1
: Se reemplazó por el informecontent_owner_province_a2
.content_owner_playback_location_a1
: Se reemplazó por el informecontent_owner_playback_location_a2
.content_owner_traffic_source_a1
: Se reemplazó por el informecontent_owner_traffic_source_a2
.content_owner_device_os_a1
: Se reemplazó por el informecontent_owner_device_os_a2
.content_owner_subtitles_a1
: Se reemplazó por el informecontent_owner_subtitles_a2
.content_owner_combined_a1
: Se reemplazó por el informecontent_owner_combined_a2
.content_owner_asset_basic_a1
: Se reemplazó por el informecontent_owner_asset_basic_a2
.content_owner_asset_province_a1
: Se reemplazó por el informecontent_owner_asset_province_a2
.content_owner_asset_playback_location_a1
: Se reemplazó por el informecontent_owner_asset_playback_location_a2
.content_owner_asset_traffic_source_a1
: Se reemplazó por el informecontent_owner_asset_traffic_source_a2
.content_owner_asset_device_os_a1
: Se reemplazó por el informecontent_owner_asset_device_os_a2
.content_owner_asset_combined_a1
: Se reemplazó por el informecontent_owner_asset_combined_a2
.
También se actualizó la lista de tipos de informes actuales en la documentación de referencia de la API.
11 de noviembre de 2016
Esta actualización incluye los siguientes cambios:
-
Informes de pantalla final
- El informe de pantalla final de los videos del canal contiene estadísticas de todos los videos de un canal.
- El informe de pantalla final de los videos de propietarios de contenido contiene estadísticas para los videos de cualquiera de los canales de un propietario del contenido.
- El informe de pantalla final de los activos de propietario del contenido contiene estadísticas de los activos asociados con los videos en los que se muestran las pantallas finales.
-
Dimensiones de la pantalla final
end_screen_element_type
: Es el tipo de elemento de pantalla final asociado con las estadísticas.end_screen_element_id
: Es el ID que YouTube usa para identificar de forma única el elemento de pantalla final.
Métricas de las pantallas finales
Nota: Los datos de las métricas de las pantallas finales están disponibles desde el 1 de mayo de 2016.
end_screen_element_impressions
: Es la cantidad total de impresiones de elementos de pantalla final. Se registra una impresión por cada elemento de pantalla final que se muestra.end_screen_element_clicks
: Es la cantidad de veces que se hizo clic en los elementos de pantalla final.end_screen_element_click_rate
: Es la tasa de clics de los elementos de pantalla final.
-
Los siguientes informes ya no son compatibles y se quitaron de la documentación. Hay una versión más reciente de cada informe disponible. (El anuncio de baja de estos informes se realizó el 22 de junio de 2016).
content_owner_ad_performance_a1
: Se reemplazó por el informecontent_owner_ad_rates_a1
.content_owner_estimated_earnings_a1
: Se reemplazó por el informecontent_owner_estimated_revenue_a1
.content_owner_asset_estimated_earnings_a1
: Se reemplazó por el informecontent_owner_asset_estimated_revenue_a1
.
-
Las métricas de la siguiente lista están completamente obsoletas y ya no se admiten. Tal como se anunció el 10 de agosto de 2016, ya se admiten nuevas métricas que hagan referencia a los mismos datos. En la siguiente tabla, se muestra el nombre de la métrica obsoleta y el nombre de la métrica nueva:
Métrica obsoleta Nueva métrica adEarnings
estimatedAdRevenue
impressionBasedCpm
cpm
impressions
adImpressions
redPartnerRevenue
estimatedRedPartnerRevenue
- Ingresos publicitarios mensuales y globales por video
- Ingresos publicitarios diarios y por país por video
- Ingresos publicitarios mensuales y globales por activo
- Ingresos publicitarios diarios y por país por activo
- Reclamos (este informe no contiene datos sobre los ingresos)
-
La API es compatible con dos métricas nuevas relacionadas con los usuarios de YouTube Red:
red_views
: Es la cantidad de veces que los miembros de YouTube Red vieron un video.red_watch_time_minutes
: Muestra la cantidad de minutos que los miembros de YouTube Red miraron un video.
-
La API admite versiones nuevas de 20 informes. Todas las versiones nuevas admiten las nuevas métricas
red_views
yred_watch_time_minutes
.En cada informe, el número del ID del tipo de informe nuevo es un número superior al del ID del tipo de informe anterior. (Las versiones anteriores de estos informes ya no están disponibles, como se describe más adelante en este historial de revisión). Por ejemplo, el informe
channel_basic_a1
dejó de estar disponible y se reemplazó por el informechannel_basic_a2
.En las siguientes listas, se identifican los IDs de los nuevos tipos de informes:
Informes de videos del canal
Informes de videos de propietarios de contenido
Informes de activos de propietarios de contenido
-
Nota: Este es un anuncio de baja.
Ten en cuenta que, si ya tienes trabajos para crear alguna de las versiones anteriores de los informes enumerados anteriormente, debes crear trabajos nuevos para los informes a los que les cambiaste el nombre. Junto con el lanzamiento de las nuevas versiones de informes, dejaron de estar disponibles las siguientes versiones:
channel_basic_a1
channel_province_a1
channel_playback_location_a1
channel_traffic_source_a1
channel_device_os_a1
channel_subtitles_a1
channel_combined_a1
content_owner_basic_a2
content_owner_province_a1
content_owner_playback_location_a1
content_owner_traffic_source_a1
content_owner_device_os_a1
content_owner_subtitles_a1
content_owner_combined_a1
content_owner_asset_basic_a1
content_owner_asset_province_a1
content_owner_asset_playback_location_a1
content_owner_asset_traffic_source_a1
content_owner_asset_device_os_a1
content_owner_asset_combined_a1
Si tienes trabajos para alguno de esos informes, no deberías esperar que YouTube genere informes nuevos para ellos después del 15 de diciembre de 2016. Los informes generados seguirán disponibles durante 180 días desde la fecha en que se generaron.
-
El informe
content_owner_basic_a1
dejó de estar disponible y se quitó de la documentación. YouTube ya no generará informes nuevos de ese tipo. Sin embargo, los informes que ya se hayan generado seguirán disponibles por 180 días desde el momento en que se crearon.El reemplazo del informe
content_owner_basic_a1
es el informecontent_owner_basic_a2
, como se explica en la entrada del historial de revisión correspondiente al 19 de mayo de 2016. -
Las Condiciones del Servicio de los servicios de la API de YouTube publicadas recientemente (“las Condiciones Actualizadas”), que se analizan en detalle en el Blog para desarrolladores y ingeniería de YouTube, proporcionan un conjunto completo de actualizaciones de las Condiciones del Servicio actuales. Además de las Condiciones Actualizadas, que entrarán en vigencia el 10 de febrero de 2017, esta actualización incluye varios documentos de respaldo para ayudar a explicar las políticas que deben seguir los desarrolladores.
El conjunto completo de documentos nuevos se describe en el historial de revisión de las Condiciones actualizadas. Además, los próximos cambios que se realicen en las Condiciones actualizadas o en los documentos de respaldo también se explicarán en ese historial de revisión. Puedes suscribirte a un feed RSS que muestre los cambios en ese historial de revisión desde un vínculo en el documento.
-
API de YouTube Analytics (búsquedas segmentadas)
-
Nota: Este es un anuncio de baja.
Las métricas de la siguiente tabla dejarán de estar disponibles. Al mismo tiempo, se introducen nuevas métricas que hacen referencia a los mismos datos. En efecto, esto significa que se cambiará el nombre de las métricas anteriores, aunque la API de YouTube Analytics admitirá ambos nombres hasta las fechas de baja que se indican en la tabla.
Nombre de la métrica anterior Nombre de la métrica nueva Fecha de compatibilidad earnings
estimatedRevenue
10 de agosto de 2017 adEarnings
estimatedAdRevenue
4 de noviembre de 2016 redPartnerRevenue
estimatedRedPartnerRevenue
4 de noviembre de 2016 impressionBasedCpm
cpm
4 de noviembre de 2016 impressions
adImpressions
4 de noviembre de 2016 Ten en cuenta que la métrica
earnings
era una métrica principal, por lo que se admitirá durante un año a partir de la fecha de este anuncio. Las demás métricas, que no eran métricas principales, se brindarán asistencia durante tres meses, hasta el 4 de noviembre de 2016.Por ejemplo, hasta el 4 de noviembre de 2016, una solicitud a la API puede especificar la métrica
impressionBasedCpm
, la métricacpm
o ambas. Sin embargo, después de esa fecha, solo se admitirá la métricacpm
. - La dimensión
insightTrafficSourceType
admite dos nuevos valores de dimensión:CAMPAIGN_CARD
: Esta fuente de tráfico solo se admite en los informes de propietarios de contenido. Indica que las vistas se originaron de videos subidos por usuarios reclamados y que el propietario del contenido utilizó para promocionar el contenido visto.END_SCREEN
: Los datos corresponden a las vistas que se originaron en la pantalla final de otro video.
Para ambas fuentes de tráfico nuevas, también puedes recuperar un informe de
traffic source detail
. En ambos casos, la dimensióninsightTrafficSourceDetail
identifica el video desde el que provino el usuario. -
Ahora, la dimensión
adType
admite el valorauctionBumperInstream
, que hace referencia a un anuncio de video que no se puede omitir y tiene un máximo de 6 segundos que se reproduce antes de mirar el video.
-
-
API de YouTube Reporting (informes masivos)
- La dimensión
traffic_source_type
ahora admite los siguientes valores:19
: Esta fuente de tráfico solo se admite en los informes de propietarios de contenido. Indica que las vistas se originaron de videos subidos por usuarios reclamados y que el propietario del contenido utilizó para promocionar el contenido visto.20
: Los datos corresponden a las vistas que se originaron en la pantalla final de otro video.
Para ambas fuentes de tráfico nuevas, la dimensión
traffic_source_detail
identifica el video desde el que llegó al usuario. -
Se corrigió la lista de métricas principales de la API para que muestre
estimated_partner_revenue
como métrica principal y quiteearnings
de esa lista. La API de informes de YouTube nunca admite la métricaearnings
. -
La dimensión
ad_type
ahora admite el valor19
, que hace referencia a los anuncios bumper, que son anuncios de video que no se pueden omitir y tienen un máximo de 6 segundos que se reproducen antes de que se pueda ver un video.
- La dimensión
-
API de YouTube Analytics (búsquedas segmentadas)
- Se actualizaron las listas de métricas admitidas de los siguientes informes de canales para incluir las métricas de tarjetas. La compatibilidad con las métricas de tarjetas en estos informes se agregó el 28 de junio de 2016. La entrada del historial de revisión de esa fecha explica el cambio con más detalle. Los informes son los siguientes:
- Actividad básica de los usuarios por estado de EE.UU.
- Actividad de los usuarios por estado de Estados Unidos y por período de tiempo específico
- Actividad de los usuarios por provincia
- Actividad de los usuarios por estado de suscripción
- Actividad de los usuarios por estado de suscripción para provincias
- Videos más populares por estado
- Videos más populares entre los usuarios suscritos o no suscritos
-
Las listas de filtros se corrigieron para los informes de retención de público del canal y los informes de retención de público de los propietarios de contenido para reflejar que se requiere el filtro
video
y que no se admite el filtrogroup
.Anteriormente, en la documentación de ambos informes se indicaba de forma incorrecta que el informe podía recuperarse con uno de esos dos filtros o con ninguno de los dos.
- Se actualizaron las listas de métricas admitidas de los siguientes informes de canales para incluir las métricas de tarjetas. La compatibilidad con las métricas de tarjetas en estos informes se agregó el 28 de junio de 2016. La entrada del historial de revisión de esa fecha explica el cambio con más detalle. Los informes son los siguientes:
-
API de YouTube Reporting (informes masivos)
- En la descripción general de la API, se corrigió la sección que explica cómo recuperar la URL de descarga de un informe para indicar que YouTube sí genera informes descargables correspondientes a los días en los que no había datos disponibles. Esos informes contienen una fila de encabezado, pero no contienen datos adicionales. Esta información ya se había actualizado en la sección Características de informes del mismo documento el 12 de abril de 2016.
- Se corrigió la lista de dimensiones del informe
content_owner_asset_cards_a1
para reflejar que el informe utiliza la dimensióncard_id
. Anteriormente, en la documentación, el nombre de la dimensión se mostraba de forma incorrecta comocard_title
.
- Estadísticas básicas(canales, propietarios del contenido)
- Basadas en el tiempo(canales, propietarios del contenido)
- Ubicación geográfica del usuario (canales, propietarios del contenido)
- Actividad de los usuarios por estado de suscripción (canales, propietarios del contenido)
- Videos más exitosos (canales, propietarios del contenido)
-
Se actualizó la sección Características de informes de la descripción general de la API para aclarar que los informes estarán disponibles a través de la API durante 180 días desde la fecha en que se crearon.
Anteriormente, en la documentación se indicaba que los informes estaban disponibles hasta por 180 días antes de la fecha en que se envió la solicitud a la API. Si bien técnicamente también es cierto, el texto original era, en el mejor de los casos, bastante confuso.
-
La API admite nuevas versiones de tres informes. Dos de esos informes también contienen métricas nuevas y a las que se les cambió el nombre:
-
El informe
content_owner_ad_rates_a1
es la nueva versión del informecontent_owner_ad_performance_a1
. El informe con el nuevo nombre es idéntico a la versión anterior. -
Se cambió el nombre de dos informes con versiones nuevas:
- La nueva versión del informe de
content_owner_estimated_earnings_a1
se denominacontent_owner_estimated_revenue_a1
. - La nueva versión del informe de
content_owner_asset_estimated_earnings_a1
se denominacontent_owner_asset_estimated_revenue_a1
.
Ambos informes con nuevo nombre difieren de sus predecesores en los siguientes aspectos:
- Agrega la nueva métrica
estimated_partner_red_revenue
, que calcula los ingresos totales de las suscripciones a YouTube Red. - Agrega la nueva métrica
estimated_partner_transaction_revenue
, que calcula los ingresos de las transacciones, como el contenido pago y la financiación de fans, menos cualquier reembolso cobrado por los socios. - Cambian el nombre de la métrica
estimated_partner_ad_sense_revenue
aestimated_partner_ad_auction_revenue
. - Cambian el nombre de la métrica
estimated_partner_double_click_revenue
aestimated_partner_ad_reserved_revenue
.
- La nueva versión del informe de
Ten en cuenta que, si ya tienes trabajos para crear alguna de las versiones anteriores de estos informes, debes crear trabajos nuevos para los informes a los que les cambiaste el nombre. Junto con el lanzamiento de las nuevas versiones de informes, dejaron de estar disponibles los informes
content_owner_ad_performance_a1
,content_owner_estimated_earnings_a1
ycontent_owner_asset_estimated_earnings_a1
.Si tienes trabajos para alguno de esos informes, no deberías esperar que YouTube genere informes nuevos para ellos después del 22 de septiembre de 2016. Los informes generados seguirán disponibles durante 180 días desde la fecha en que se generaron.
-
-
Se actualizó la definición de la propiedad
id
del recursoreportType
para reflejar el conjunto actual de informes disponibles. -
En la documentación, se corrigieron los nombres de dos métricas para que coincidan con los nombres que aparecen en los informes. Esto es solo una corrección de documentación y no refleja un cambio en el contenido real del informe:
- Se actualizó el nombre de la métrica
estimated_partner_adsense_revenue
aestimated_partner_ad_sense_revenue
. Sin embargo, ten en cuenta que esta métrica solo aparece en dos informes que dejarán de estar disponibles con esta actualización. Como se describió anteriormente, se cambió el nombre de esta métrica aestimated_partner_ad_auction_revenue
en las versiones más recientes de esos informes. - Se actualizó el nombre de la métrica
estimated_partner_doubleclick_revenue
aestimated_partner_double_click_revenue
. Una vez más, ten en cuenta que esta métrica solo aparece en dos informes que dejarán de estar disponibles con esta actualización. Como se describió anteriormente, se cambió el nombre de esta métrica aestimated_partner_ad_reserved_revenue
en las versiones más recientes de esos informes.
- Se actualizó el nombre de la métrica
-
Se actualizó la documentación de dimensiones para la API de Reporting y ya no muestra las propiedades
elapsed_video_time_percentage
yaudience_retention_type
. Actualmente, estas dimensiones no son compatibles con ningún informe disponible a través de la API. -
La API admite una versión nueva del informe de actividad del usuario para propietarios de contenido. El ID del tipo de informe para el informe nuevo es
content_owner_basic_a2
. A diferencia de la versión anterior del informe,content_owner_basic_a1
, la nueva versión admite las métricaslikes
ydislikes
.Si ya tienes un trabajo para crear el informe
content_owner_basic_a1
, aún debes crear un trabajo nuevo para el informecontent_owner_basic_a2
. YouTube no está migrando automáticamente a los propietarios del contenido a la nueva versión del informe ni creando automáticamente un trabajo para generar la nueva versión del informe. En algunas implementaciones, la apariencia de un trabajo inesperado nuevo podría ser un cambio rotundo.Junto con el lanzamiento del nuevo informe, dejó de estar disponible el informe
content_owner_basic_a1
. Si tienes un trabajo para ese informe, no deberías esperar que YouTube genere informes nuevos para él después del 19 de agosto de 2016. Los informes generados seguirán disponibles durante 180 días desde la fecha en que se generaron. -
Los recursos
reportType
,job
yreport
admiten una nueva propiedad que identifica si el recurso asociado representa un tipo de informe obsoleto:-
La propiedad
deprecateTime
del recursoreportType
especifica la fecha y hora en que el tipo de informe dejará de estar disponible. Esta propiedad solo tiene un valor para los informes que se anunciaron como obsoletos, y el valor representa la fecha en la que YouTube dejará de generar informes de ese tipo.Después de que un tipo de informe se anuncia como obsoleto, YouTube genera informes de ese tipo durante otros tres meses. Por ejemplo, esta actualización del 19 de mayo de 2016 anuncia la baja del informe
content_owner_basic_a1
. Por lo tanto, eldeprecateTime
de ese tipo de informe especifica una hora el 19 de agosto de 2016, después de la cual YouTube dejará de generar informes de ese tipo. -
La propiedad
expireTime
del recursojob
especifica la fecha y hora en que el trabajo venció o vencerá. Esta propiedad tiene un valor si el tipo de informe asociado con el trabajo dejó de estar disponible o si los informes generados para el trabajo no se descargaron durante un período prolongado. La fecha indica el momento en que YouTube ya no genera informes nuevos para el trabajo. -
La propiedad
jobExpireTime
del recursoreport
especifica la fecha y hora en que el trabajo asociado con el informe venció o vencerá. Esta propiedad contiene el mismo valor que la propiedadexpireTime
en el recursojob
, como se describe en el elemento anterior de esta lista.
-
-
El método
jobs.create
ahora muestra un código de respuesta HTTP400
(Bad Request
) si intentas crear un trabajo para un informe obsoleto. Además, ahora la documentación del método enumera varias otras razones que provocan que una solicitud a la API falle. -
Actualmente, YouTube genera datos que abarcan el período de 180 días anteriores al momento en que se programó la tarea de generación de informes por primera vez. Anteriormente, la API de Reporting no entregaba datos históricos. Este cambio afecta a todos los trabajos, incluidos los creados antes de este anuncio.
Los informes históricos se publican tan pronto como están disponibles, aunque los datos históricos de un trabajo demoran aproximadamente un mes en publicarse. Por lo tanto, un mes después de programar un trabajo de informe, tendrás acceso a aproximadamente siete meses de datos. (Todos los datos históricos de los empleos creados antes de este anuncio se deben publicar en el plazo de un mes a partir del anuncio).
Ten en cuenta que los datos históricos solo están disponibles desde el 1.o de julio de 2015. Como resultado, los trabajos creados antes del 28 de diciembre de 2015 tendrán menos de 180 días de datos históricos.
Todos estos cambios se explican en la nueva sección de datos históricos de la descripción general de la API de Reporting.
-
La sección de características de informes de la descripción general de la API de informes de YouTube se actualizó con los siguientes cambios:
-
En la documentación, ahora se indica que los informes estarán disponibles durante un período de 180 días después de su creación y, por lo tanto, estarán disponibles para que los clientes de la API los descarguen. Anteriormente, en la documentación se indicaba que los informes estaban disponibles durante un período de hasta seis meses antes de la fecha en que se envió la solicitud de la API.
-
La documentación se actualizó para reflejar el hecho de que la API ahora genera informes descargables correspondientes a los días en los que no había datos disponibles. Esos informes contendrán filas de encabezado, pero no contendrán datos adicionales.
-
-
La API de informes de YouTube pronto admitirá un conjunto de informes generados automáticamente y administrados por el sistema que contienen datos de ingresos publicitarios o de suscripciones a YouTube Red. Los informes estarán disponibles para los propietarios del contenido, que ya pueden acceder a los informes de ingresos descargables de forma manual en YouTube Creator Studio. Por lo tanto, la nueva funcionalidad de la API proporcionará acceso programático a esos datos.
Ahora se anuncian los siguientes cambios en la API como preparación para el lanzamiento de los informes administrados por el sistema:
-
La nueva propiedad
systemManaged
del recursojob
indica si el recurso describe un trabajo que genera informes administrados por el sistema. YouTube genera automáticamente informes administrados por el sistema para los propietarios del contenido de YouTube, y estos últimos no pueden modificar ni borrar los trabajos que crean esos informes. -
El nuevo parámetro
includeSystemManaged
del métodojobs.list
indica si la respuesta de la API debe incluir trabajos para los informes administrados por el sistema. El valor predeterminado del parámetro esfalse
. -
El nuevo parámetro
startTimeAtOrAfter
del métodojobs.reports.list
indica que la respuesta de la API solo debe contener informes si los primeros datos del informe son iguales o posteriores a la fecha especificada. De manera similar, el parámetrostartTimeBefore
indica que la respuesta de la API solo debe contener informes si los primeros datos del informe son anteriores a la fecha especificada.A diferencia del parámetro
createdAfter
del método, que corresponde a la hora en que se creó el informe, los parámetros nuevos se relacionan con los datos del informe. -
La nueva propiedad
systemManaged
del recursoreportType
indica si el recurso describe un informe administrado por el sistema. -
El nuevo parámetro
includeSystemManaged
del métodoreportTypes.list
indica si la respuesta de la API debe incluir informes administrados por el sistema. El valor predeterminado del parámetro esfalse
.
-
- En la API de informes de YouTube, la dimensión
sharing_service
admite estos valores nuevos:82
: Diálogo de actividad del sistema iOS83
: Recibidos de Google84
: Android Messenger
- En la API de YouTube Analytics, la dimensión
sharingService
admite estos valores nuevos:ANDROID_MESSENGER
: Android MessengerINBOX
: Recibidos de GoogleIOS_SYSTEM_ACTIVITY_DIALOG
: Diálogo de actividad del sistema iOS
- La dimensión
playback_location_type
admite dos nuevos valores de dimensión:7
: Los datos corresponden a las vistas que se produjeron en la página principal o la pantalla principal de YouTube, en el feed de suscripción del usuario o en otra función de navegación de YouTube.8
: Los datos corresponden a las vistas que se produjeron directamente en la página de resultados de búsqueda de YouTube.
- La dimensión
traffic_source_type
ahora admite18
como valor de dimensión. Este valor indica que las reproducciones de video se originaron de una página que enumera todos los videos de una playlist. Esta fuente difiere del tipo de fuente14
, que indica que las vistas se produjeron mientras el video se reproducía como parte de una playlist. - La dimensión
insightPlaybackLocationType
admite dos nuevos valores de dimensión:BROWSE
: Los datos corresponden a las vistas que se produjeron en la página principal o la pantalla principal de YouTube, en el feed de suscripción del usuario o en otra función de navegación de YouTube.SEARCH
: Los datos corresponden a las vistas que se produjeron directamente en la página de resultados de búsqueda de YouTube.
- La dimensión
insightTrafficSourceType
ahora admiteYT_PLAYLIST_PAGE
como valor de dimensión. Este valor indica que las reproducciones de video se originaron de una página que enumera todos los videos de una playlist. Esta fuente difiere del tipo de fuentePLAYLIST
, que indica que las reproducciones se produjeron mientras el video se reproducía como parte de una playlist. - En la API de informes de YouTube, la dimensión
operating_system
usa el valor21
para identificar las vistas que se realizan mediante Chromecast. - En la API de YouTube Analytics, la dimensión
operatingSystem
usa el valorCHROMECAST
para identificar las vistas que se realizan mediante Chromecast. -
La API de YouTube Analytics ahora admite tres nuevas dimensiones de detalles de reproducción, que se pueden usar en varios informes de canales y propietarios de contenido:
liveOrOnDemand
: Esta dimensión indica si los datos del informe describen la actividad del usuario que ocurrió durante una transmisión en vivo.subscribedStatus
: Esta dimensión indica si las métricas de actividad del usuario incluidas en los datos están asociadas con usuarios suscritos al canal del video o la playlist.youtubeProduct
: Esta dimensión identifica la propiedad de YouTube en la que se produjo la actividad del usuario. Entre los valores posibles, se incluyen el sitio web principal de YouTube (o la app de YouTube), YouTube Gaming y YouTube Kids.
La documentación se actualizó para identificar nuevos informes de detalles de reproducción disponibles para canales y propietarios de contenido. Además, se actualizaron muchos otros informes para indicar que una o más de estas dimensiones se pueden utilizar opcionalmente como dimensiones o filtros en esos informes.
-
El formato de las tablas que explican los informes cambió para que sea más fácil identificar combinaciones válidas de dimensiones, métricas y filtros que se pueden utilizar para recuperar cada informe. En la siguiente tabla, en la que se explica el informe "Tipo de dispositivo" para los canales, se muestra el nuevo formato:
Contenido Dimensiones: Obligatorio deviceType Usa 0 o más day, liveOrOnDemand, subscribedStatus, youtubeProduct Métricas: Usa 1 o más vistas, estimatedMinutesWatched Filtros: Usa 0 o 1 country, provincia, continent y subContinent Usa 0 o 1 video, grupo Usa 0 o más operatingSystem, liveOrOnDemand, subscribedStatus y youtubeProduct La terminología que describe los campos obligatorios y opcionales se explica en la documentación de los informes de canales y propietarios de contenido.
-
Ahora, la API de YouTube Analytics descarta automáticamente las entidades de las que el usuario de la API no puede recuperar datos de filtros que admiten varios valores (
video
,playlist
ychannel
). Antes, el servidor de la API mostraba un error si el usuario de la API no podía acceder a los datos de al menos uno de los elementos especificados.Por ejemplo, supongamos que un usuario envía una solicitud a la API en la que el filtro
video
muestra una lista de 20 IDs de video. El usuario es propietario de 18 de los videos. Sin embargo, un ID de video identifica un video que pertenece a otro canal y otro ID identifica un video que se eliminó y, por lo tanto, ya no existe. En este caso, en lugar de mostrar un error, el servidor de la API ahora descarta los dos videos a los que el usuario no puede acceder, y la respuesta de la API contiene datos de los 18 videos que posee el usuario de la API. -
Si solicitas datos de un
group
de YouTube Analytics vacío, la API mostrará un conjunto de datos vacío en lugar de un error. -
El método
groupItems.insert
de la API de YouTube Analytics ahora muestra un error no autorizado (código de respuesta HTTP403
) si intentas agregar una entidad a un grupo, pero no tienes acceso a ella. Anteriormente, la API te habría permitido agregar la entidad al grupo, pero luego mostró un error no autorizado cuando intentaste recuperar los datos de informes de ese grupo. -
El método
groups.list
de la API de YouTube Analytics ahora admite la paginación. Si la respuesta de la API no contiene todos los grupos disponibles, el parámetronextPageToken
de la respuesta especifica un token que se puede usar para recuperar la siguiente página de resultados. Establece el parámetropageToken
del método en ese valor para recuperar resultados adicionales. -
La API de YouTube Analytics ahora admite la métrica
redPartnerRevenue
, que informa los ingresos totales estimados de las suscripciones a YouTube Red para las dimensiones de informe seleccionadas. El valor de la métrica refleja los ingresos provenientes del contenido musical y no musical, y está sujeto a un ajuste de fin de mes.Se actualizó la lista de informes de propietarios de contenido de la API de YouTube Analytics para identificar los informes de videos que admiten la métrica
redPartnerRevenue
:- Estadísticas básicas
- Basado en el tiempo
- Ubicación geográfica del usuario
- Videos más exitosos: En este informe, también puedes usar
redPartnerRevenue
como métrica para ordenar, lo que significa que puedes recuperar una lista de videos ordenados según sus ingresos de YouTube Red.
-
La definición del informe Videos más exitosos para la API de YouTube Analytics ahora indica que este informe también admite las siguientes métricas de ingresos:
earnings
,adEarnings
,grossRevenue
,monetizedPlaybacks
,playbackBasedCpm
,impressions
yimpressionBasedCpm
. -
Se corrigió la documentación de la dimensión
date
de la API de informes de YouTube para reflejar que las fechas hacen referencia al período de 24 horas a partir de las 12:00 a.m., hora del Pacífico (UTC-8). Anteriormente, en la documentación se indicaba que la fecha comenzaba a las 12:00 a.m. (GMT).Además, se actualizó la documentación de la API de YouTube Analytics para indicar que todas las dimensiones relacionadas con las fechas (
day
,7DayTotals
,30DayTotals
ymonth
) hacen referencia a las fechas que comienzan a las 12:00 a.m., hora del Pacífico (UTC-8). -
El método
jobs.reports.list()
de la API de informes de YouTube ahora admite el parámetro de búsquedacreatedAfter
. Si se especifica, este parámetro indica que la respuesta de la API solo debe incluir los informes creados después de la fecha y hora especificadas, incluidos los informes nuevos con datos reabastecidos. Ten en cuenta que el valor del parámetro corresponde a la hora en que se creó el informe y no a las fechas asociadas con los datos que se muestran.El valor del parámetro es una marca de tiempo en el formato RFC3339 UTC “Zulú”, con precisión de microsegundos. Ejemplo:
"2015-10-02T15:01:23.045678Z"
.También se actualizaron las prácticas recomendadas de la API de informes de YouTube para explicar cómo puedes usar el parámetro
createdAfter
y evitar procesar el mismo informe de forma reiterada. -
Se corrigieron las definiciones de la propiedad
createTime
del recursojob
y las propiedadesstartTime
,endTime
ycreateTime
del recursoreport
para tener en cuenta que los valores de la propiedad son precisos en microsegundos, no nanosegundos. Además, todas las definiciones ahora reflejan con precisión que el valor de la propiedad es una marca de tiempo. -
Se actualizó la documentación de la dimensión
sharingService
de la API de YouTube Analytics para incluir una lista de posibles valores de dimensión. La lista incluye varios servicios admitidos recientemente.La definición de la dimensión
sharing_service
de la API de informes de YouTube también se actualizó para mostrar los nuevos valores admitidos. Los valores de enumeración mayores que59
son los nuevos en la lista. -
La nueva API de informes de YouTube recupera informes de datos masivos que contienen datos de YouTube Analytics de un canal o propietario de contenido. Está diseñada para aplicaciones que pueden importar grandes conjuntos de datos y que proporcionan herramientas para filtrar, ordenar y extraer esos datos.
Cada informe de la API de informes de YouTube contiene un conjunto predefinido de dimensiones y métricas. (Los informes de la API de YouTube Analytics también utilizan métricas y dimensiones). En un informe, cada fila de datos tiene una combinación única de valores de dimensiones. Puedes agregar datos en filas según los valores de las dimensiones para calcular métricas de videos individuales, países, videos en vivo, usuarios suscritos, etcétera.
Puedes usar la API para programar trabajos de informes, cada uno de los cuales identifica un informe que YouTube debe generar. Una vez que hayas configurado un trabajo, YouTube generará un informe diario que puede descargarse de forma asíncrona. Cada informe contiene datos para un período único de 24 horas.
-
Aunque son APIs diferentes, la API de YouTube Analytics y la API de YouTube Reporting permiten que los desarrolladores recuperen datos de YouTube Analytics. Debido a que las dos APIs proporcionan acceso a conjuntos de datos similares, la documentación de las dos APIs se publica como un solo conjunto de documentos.
- La pestaña Guides del conjunto de documentación contiene información común para ambas APIs, incluidas las instrucciones para autorizar solicitudes a las APIs.
- La pestaña Informes masivos contiene documentación de referencia y otro contenido específicamente para la API de informes de YouTube.
- La pestaña Consultas segmentadas incluye documentación de referencia y otro contenido específicamente para la API de YouTube Analytics.
- La pestaña Samples enumera las muestras de código disponibles para cualquiera de las dos APIs.
- En la pestaña Herramientas, se enumeran recursos adicionales disponibles para ayudar a los desarrolladores a implementar cualquiera de las dos APIs.
-
Se reestructuró la documentación de la API para facilitar su comprensión. Por lo tanto, estos cambios no describen funciones nuevas:
-
Ahora la documentación contiene una página que enumera todos los informes de canales disponibles y otra que enumera todos los informes de propietarios de contenido disponibles. Anteriormente, la documentación tenía páginas separadas para los informes de videos de canales, los informes de listas de reproducción de canales, etc.
-
El objetivo de la nueva descripción general del modelo de datos es ofrecer una introducción más clara al funcionamiento de la API. Específicamente, en este documento se pretende explicar mejor la manera en que YouTube utiliza métricas, dimensiones y filtros para calcular los valores de los informes.
-
El método
reports.query
de la API, que utilizas para recuperar informes, ahora se documenta por separado. La información de esa página ya se había incluido en otras. La página nueva está diseñada para ayudarte a identificar más fácilmente la información que debes enviar para recuperar un informe.
-
-
La nueva métrica
adEarnings
incluye el total de ingresos estimados (ingresos netos) de todas las fuentes de publicidad vendidas por Google. No es una métrica principal. La API admite la métricaadEarnings
para cualquier informe que ya admita la métricaearnings
.Además, se corrigió la definición de la métrica
earnings
para reflejar el hecho de que su valor incluye los ingresos totales estimados de todas las fuentes publicitarias vendidas por Google y de fuentes no publicitarias. Anteriormente, la definición indicaba incorrectamente que la métrica solo incluía ingresos de fuentes publicitarias. -
La métrica
primaryAdGrossRevenue
dejó de estar disponible. En su lugar, usa la métricagrossRevenue
para recuperar los datos de ingresos. -
Además de la métrica
primaryAdGrossRevenue
obsoleta, los informes de rendimiento de los anuncios ya no admiten las métricasmonetizedPlaybacks
niplaybackBasedCpm
. Sin embargo, varios informes de video todavía admiten esas métricas. -
La API ahora admite dos métricas nuevas para los informes de video:
videosAddedToPlaylists
yvideosRemovedFromPlaylists
. Las listas de informes de videos para canales y propietarios de contenido se actualizaron para identificar los informes que admiten las nuevas métricas.videosAddedToPlaylists
: la cantidad de veces que los videos en el alcance de la consulta se agregaron a las playlists de YouTube. Los videos podrían haberse agregado a la playlist del propietario del video o a las de otros canales.videosRemovedFromPlaylists
: la cantidad de veces que los videos incluidos en la consulta se eliminaron de las playlists de YouTube. Los videos podrían haberse eliminado de la playlist del propietario del video o de las playlists de otros canales.
Ambas métricas incluyen playlists predeterminadas, como la playlist “Ver más tarde”. Sin embargo, no cuentan las playlists a las que se agrega automáticamente un video, como las playlists de videos subidos de un canal o el historial de reproducciones de un usuario. También ten en cuenta que estas métricas reflejan el número absoluto de adiciones y eliminaciones. Por lo tanto, si un usuario agrega un video a una playlist, lo elimina y vuelve a agregarlo, las métricas indican que el video se agregó a dos playlists y se eliminó de una.
Los datos de estas métricas están disponibles desde el 1 de octubre de 2014.
-
Las métricas
favoritesAdded
yfavoritesRemoved
dejaron de estar disponibles a partir de este anuncio. Estas son métricas principales y están sujetas a la Política de Baja establecida en las Condiciones del Servicio. -
El nuevo parámetro
currency
te permite recuperar métricas de ingresos en una moneda distinta del dólar estadounidense (USD
). Si se configura el parámetro, la API convierte los valores de las métricasearnings
,grossRevenue
,playbackBasedCpm
yimpressionBasedCpm
a la moneda especificada. Los valores devueltos son estimaciones calculadas a partir de tipos de cambio que cambian diariamente.El valor del parámetro es un código de moneda ISO 4217 de tres letras. El valor predeterminado es
USD
. La definición del parámetro contiene una lista de códigos de moneda admitidos. -
La API ahora admite la capacidad de crear y administrar grupos de YouTube Analytics, así como la capacidad de recuperar datos de informes de esos grupos.
-
Crea y administra grupos
En esta actualización, se presentan los recursos
group
ygroupItem
para crear y administrar grupos.- El recurso
group
representa un grupo de Analytics, una colección personalizada de hasta 200 canales, videos, playlists o activos. La API admite los métodoslist
,insert
,update
ydelete
para este recurso. - El recurso
groupItem
representa un elemento en un grupo de Analytics. La API admite los métodoslist
,insert
ydelete
para este recurso.
Por ejemplo, puedes crear un grupo con el método
groups.insert
y, luego, agregar elementos a ese grupo con el métodogroupItems.insert
. - El recurso
-
Cómo recuperar datos de informes de un grupo
Actualizamos la documentación de dimensions para incluir la dimensión
group
, que se puede usar como filtro en muchos informes de canales y también informes de propietarios de contenido. Cuando usas el filtrogroup
, la API muestra datos de todos los elementos de ese grupo. Ten en cuenta que, actualmente, la API no admite la capacidad de crear informes para grupos de recursos.
Consulta el Centro de ayuda de YouTube para obtener más información sobre los grupos de YouTube Analytics.
-
-
La API ya no admite la dimensión
show
. -
La API ahora admite la capacidad de especificar varios valores para las dimensiones
video
,playlist
,channel
yshow
cuando se usan como filtros. Para especificar varios valores, establece el valor del parámetrofilters
en una lista separada por comas de los IDs de video, playlist, canal o programa para los que se debe filtrar la respuesta de la API. El valor del parámetro puede especificar hasta 200 ID.Si especificas varios valores para el mismo filtro, también puedes agregarlo a la lista de dimensiones que especificas para la solicitud. Esto se aplica incluso si el filtro no aparece como una dimensión admitida para un informe en particular. Si agregas el filtro a la lista de dimensiones, la API también utiliza los valores del filtro para agrupar los resultados.
Consulta la definición del parámetro
filters
para obtener detalles completos sobre esta funcionalidad. -
Cuando recuperas un informe de canales, ahora puedes recuperar datos para el canal del usuario autenticado si estableces el valor del parámetro
ids
enchannel==MINE
. (También puedes establecer el parámetroids
enchannel==CHANNEL_ID
para recuperar los datos del canal especificado). -
La API ahora admite informes de listas de reproducción, que contienen estadísticas relacionadas con las reproducciones de videos que se producen en el contexto de una playlist. Los informes de listas de reproducción están disponibles para los canales y los propietarios de contenido.
Todos los informes de listas de reproducción admiten las métricas
views
yestimatedMinutesWatched
, y algunos también admiten la métricaaverageViewDuration
.Además, todos los informes de listas de reproducción admiten las siguientes métricas nuevas. Ten en cuenta que cada una de estas métricas solo refleja las vistas de playlists que ocurrieron en la Web.
playlistStarts
: Cantidad de veces que los espectadores iniciaron la reproducción de una playlist.viewsPerPlaylistStart
: La cantidad promedio de vistas de video que se produjeron cada vez que se inició una playlist.averageTimeInPlaylist
: Es la cantidad de tiempo promedio estimada, en minutos, que un usuario vio videos de una playlist después de iniciarla.
Cualquier solicitud para recuperar un informe de playlist debe utilizar el filtro
isCurated
, que se debe establecer en1
(isCurated==1
). -
La API ahora admite un informe de retención de público. Este informe mide la capacidad de un video para retener a su público. La nueva dimensión
elapsedVideoTimeRatio
del informe mide la cantidad de video transcurrido para los valores de la métrica correspondientes:-
La métrica
audienceWatchRatio
identifica la proporción absoluta de usuarios que miran el video en un momento determinado. Para calcular la proporción, se compara la cantidad de veces que se miró una parte de un video con la cantidad total de vistas del video.Ten en cuenta que una parte de un video se podría mirar más de una vez (o no se podría mirar) en una vista determinada. Por ejemplo, si los usuarios retroceden y miran la misma parte de un video varias veces, la proporción absoluta de esa parte del video podría ser mayor que
1
. -
La métrica
relativeRetentionPerformance
muestra la eficacia con la que un video retiene usuarios durante las reproducciones en comparación con todos los videos de YouTube de duración similar. Un valor de 0 indica que el video retiene a los usuarios peor que cualquier otro video de duración similar, mientras que un valor de 1 indica que el video retiene a los usuarios mejor que cualquier otro video de duración similar. Un valor promedio de 0.5 indica que la mitad de los videos de duración similar retienen a los usuarios en mejores momentos, mientras que la mitad lo retienen peor.
También puedes utilizar el filtro
audienceType
para que el informe solo muestre datos asociados con las vistas orgánicas, las vistas de los anuncios TrueView in-stream o las de los anuncios TrueView en display. (Las vistas orgánicas son el resultado directo de las acciones de los usuarios, como la búsqueda de un video o un clic en un video sugerido). -
-
La API admite varias métricas nuevas relacionadas con las anotaciones. Las métricas que se indican a continuación se pueden recuperar con cualquier informe que anteriormente admitiera las métricas
annotationClickThroughRate
yannotationCloseRate
.annotationImpressions
: Es la cantidad total de impresiones de anotaciones.annotationClickableImpressions
: Es la cantidad de anotaciones que aparecieron y en las que se pudo hacer clic.annotationClosableImpressions
: Indica la cantidad de anotaciones que aparecieron y que se pudieron cerrar.annotationClicks
: Es la cantidad total de anotaciones en las que se hizo clic.annotationCloses
: Es la cantidad total de anotaciones cerradas.
Todas las métricas nuevas son métricas principales y están sujetas a la Política de Baja. Sin embargo, ten en cuenta que los datos están disponibles para las métricas nuevas desde el 16 de julio de 2013. (Los datos de las métricas
annotationClickThroughRate
yannotationCloseRate
están disponibles desde el 10 de junio de 2012). -
GOOGLE_SEARCH
ya no se informa como un valor independiente de la dimensióninsightTrafficSourceType
. En cambio, las referencias de los resultados de la Búsqueda de Google ahora se atribuyen al tipo de fuente de tráficoEXT_URL
. Como resultado, ya no es posible recuperar un informeinsightTrafficSourceDetail
que establezca el filtroinsightTrafficSourceType
enGOOGLE_SEARCH
. -
El documento de informes de propietarios de contenido se actualizó para reflejar que ahora se pueden recuperar las métricas
subscribersGained
ysubscribersLost
para el contenido reclamado o subido por un propietario del contenido.El cambio puede verse en el primer informe de estadísticas básicas para propietarios de contenido, que ahora admite los filtros
claimedStatus
yuploaderType
. -
El documento de solicitudes de ejemplo se rediseñó para agrupar ejemplos en categorías, con un formato de pestaña similar al que se lanzó recientemente para los informes de propietarios de contenido y canales. Con el nuevo diseño, los ejemplos se agrupan en las siguientes categorías:
- Estadísticas básicas
- Relacionadas con el tiempo
- Geográfico
- Ubicación de reproducción
- Fuente de tráfico
- Dispositivo/SO
- Segmento demográfico
- Redes sociales
- Ingresos/anuncios (solo para informes de propietarios de contenido)
-
El documento de solicitudes de ejemplo ahora incluye nuevos ejemplos para recuperar datos específicos de la provincia en los informes de canales o de propietarios de contenido.
-
Métricas específicas de la provincia para los estados de EE.UU. y Washington D.C.: Este informe recupera un desglose por provincia de los recuentos de vistas y otras estadísticas para los videos de un canal. Los datos abarcan los estados de EE.UU. y Washington D.C. En el ejemplo, se usa la dimensión
province
y el parámetrofilters
para restringir la respuesta de modo que solo incluya resultados para Estados Unidos. -
Datos demográficos de los usuarios en California (edad y género): Este informe recupera estadísticas sobre la edad y el género de los usuarios en California que miraron los videos de un canal o, en el caso de los informes de propietarios de contenido, el contenido reclamado de un propietario del contenido. En este ejemplo, se usa el parámetro
filters
para garantizar que la respuesta solo incluya datos de una provincia en particular.
-
-
Se actualizó la definición de la dimensión
province
para indicar que, cuandoprovince
se incluye en el valor del parámetrodimensions
, la solicitud también debe restringir los datos a Estados Unidos incluyendocountry==US
en el valor del parámetrofilters
. -
Se rediseñaron los documentos que enumeran los informes de canales y propietarios de contenido admitidos. En lugar de proporcionar una tabla que enumere todos los informes posibles, cada documento agrupa los informes en categorías:
- Estadísticas básicas
- Relacionadas con el tiempo
- Geográfico
- Ubicación de reproducción
- Fuente de tráfico
- Dispositivo/SO
- Segmento demográfico
- Redes sociales
- Videos más exitosos
Cada documento muestra estas categorías como una lista de pestañas, y puedes hacer clic en cualquier pestaña para ver los informes admitidos en esa categoría.
-
La API ahora admite tres nuevas dimensiones geográficas:
province
,continent
ysubContinent
.-
La dimensión
province
te permite recuperar estadísticas de los estados de EE.UU. y el distrito de Colombia. La API admite dos usos para esta dimensión:-
La API admite dos informes que desglosan las estadísticas estado por estado. Ambos informes están disponibles para los canales y los propietarios del contenido.
- El informe de estadísticas principales proporciona varias estadísticas, como recuentos de vistas y minutos de reproducción estimados.
- Los informes basados en el tiempo proporcionan las mismas estadísticas, pero agrupan datos diarios, 7 días, 30 días o mensualmente.
-
Puedes utilizar el parámetro de consulta
filters
para restringir un informe de modo que solo contenga estadísticas para un estado en particular. Varios informes admiten este tipo de filtrado, incluidos los informes geográficos, los informes de ubicaciones de reproducción, los informes de fuentes de tráfico, los informes de dispositivos, los informes de sistemas operativos, los informes demográficos y los informes de videos principales.
-
-
La dimensión
continent
especifica un código de región estadístico de las Naciones Unidas (ONU) que identifica un continente. Esta dimensión solo se puede usar como filtro. -
La dimensión
subContinent
especifica un código de región estadístico de las Naciones Unidas (ONU) que identifica una subregión de un continente. Esta dimensión también se puede usar únicamente como filtro.Dado que cada subregión solo está asociada con un continente, no es necesario usar el filtro
continent
si usas el filtrosubContinent
. (de hecho, la API devolverá un error si una solicitud utiliza ambas dimensiones).
-
-
Se corrigió la documentación para que la dimensión
insightTrafficSourceDetail
no incluya el valorPROMOTED
deinsightTrafficSourceType
como valor de filtro válido. -
Ahora, la API de YouTube Analytics está sujeta a la Política de Baja que se describe en las Condiciones del Servicio. Sin embargo, las dimensiones y métricas no principales de la API no están sujetas a la política de baja. Se actualizaron las páginas de dimensiones y metrics para enumerar las dimensiones y métricas principales. Además, se actualizaron las definiciones de esas páginas para identificar explícitamente dimensiones y métricas principales.
-
La API ahora admite
EXTERNAL_APP
como valor para la dimensióninsightPlaybackLocationType
. Junto con esta actualización, a partir del 10 de septiembre de 2013, las reproducciones ya no se clasifican como reproduccionesMOBILE
, aunque las reproducciones en dispositivos móviles que se produjeron antes de esa fecha aún se categorizarán con ese valor.Con esta actualización, las reproducciones en dispositivos móviles ahora se clasifican como reproducciones
WATCH
,EMBEDDED
oEXTERNAL_APP
, según el tipo de aplicación en la que se producen. -
La API ahora admite
PLAYLIST
como valor para la dimensióninsightTrafficSourceType
. El valor indica que las reproducciones del video proceden de una playlist. Anteriormente, estas vistas se clasificaban con la categoríaYT_OTHER_PAGE
de la dimensión. -
La API ahora admite la capacidad de ordenar los informes por múltiples dimensiones y métricas. El documento de solicitudes de ejemplo contiene un nuevo ejemplo, Ordenamiento de solicitudes según múltiples dimensiones/métricas, que demuestra esta funcionalidad. La solicitud recupera datos de fuente de tráfico y tiene un valor de parámetro
sort
deday,-views
. Los resultados se ordenan cronológicamente, pero dentro del conjunto de resultados para cada día, la primera fila contiene los datos de la fuente de tráfico que generó la mayor cantidad de reproducciones, la segunda fila contiene los datos de la fuente que generó la siguiente mayor cantidad de reproducciones, y así sucesivamente. -
La API ahora admite dos dimensiones nuevas,
deviceType
yoperatingSystem
, que se pueden usar para recuperar datos sobre los dispositivos en los que los usuarios miran tus videos. La API admite informes que utilizan una o ambas dimensiones.-
El informe
deviceType
te permite recuperar la cantidad de vistas y el tiempo de reproducción estimado para diferentes tipos de dispositivos, como computadoras, dispositivos móviles y tablets. También se puede utilizar el filtrooperatingSystem
para restringir el informe de tipo de dispositivo de modo que incluya solo estadísticas de los dispositivos que ejecutan un sistema operativo específico, como Android o iOS. -
El informe
operatingSystem
te permite recuperar la cantidad de vistas y el tiempo de reproducción estimado para diferentes sistemas operativos, como Android, iOS, Linux y muchos más. También puedes utilizar el filtrodeviceType
para restringir el informe de sistema operativo para que incluya solo estadísticas de un tipo específico de dispositivo, como dispositivos móviles o tablets.
Los nuevos informes de tipo de dispositivo y sistema operativo están disponibles para los canales y los propietarios de contenido.
-
-
El documento de solicitudes de ejemplo se actualizó para incluir tres informes de dispositivos para los canales y tres informes de dispositivo para los propietarios de contenido.
-
La dimensión
insightPlaybackLocationType
puede mostrar el valorYT_OTHER
, que identifica las vistas que no están clasificadas con uno de los otros valores de la dimensión. -
El documento de informes de propietarios de contenido se actualizó para reflejar que puedes ordenar el informe de videos principales en orden descendente de ingresos para identificar los videos que obtienen los ingresos más altos. Este es el primero que aparece en la segunda tabla de la sección Informes de actividad de los usuarios e ingresos.
-
YouTube ya no identifica elementos y servicios experimentales de la API. En cambio, ahora se ofrece una lista de API de YouTube que están sujetas a la política de baja.
-
La API ahora admite la capacidad de recuperar métricas de tiempo de reproducción (
estimatedMinutesWatched
,averageViewDuration
yaverageViewPercentage
) junto con otras métricas, como las de vistas, de participación, de ingresos y de rendimiento de anuncios.Las listas de informes de canales e informes de propietarios de contenido disponibles se actualizaron para reflejar este cambio. (En realidad, las listas son más cortas debido a que las métricas del tiempo de reproducción se pueden recuperar como parte de otros informes de la lista).
El documento Solicitudes de API de ejemplo también se actualizó.
-
Los informes que utilizan las dimensiones
insightPlaybackLocationDetail
yinsightTrafficSourceDetail
se mejoraron de las siguientes maneras:-
Ahora admiten un filtro
country
opcional. -
Los propietarios del contenido ahora pueden recuperar estos informes utilizando cualquiera de las siguientes combinaciones de
filter
nuevas. Ten en cuenta que todas estas combinaciones también admiten el filtrocountry
opcional.-
Detalles de la ubicación de reproducción
channel,insightPlaybackLocationType==EMBEDDED
show,insightPlaybackLocationType==EMBEDDED
claimedStatus,insightPlaybackLocationType==EMBEDDED
uploaderType,insightPlaybackLocationType==EMBEDDED
uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED
-
Detalles de la fuente de tráfico
channel,insightTrafficSourceType
show,insightTrafficSourceType
claimedStatus,insightTrafficSourceType
uploaderType,insightTrafficSourceType
uploaderType,claimedStatus,insightTrafficSourceType
-
-
-
El nuevo documento Solicitudes de API de ejemplo proporciona ejemplos que muestran cómo recuperar muchos tipos diferentes de informes mediante YouTube Analytics API. Cada ejemplo incluye una breve descripción del informe que la solicitud recupera y muestra las dimensiones, las métricas, los filtros y los parámetros de orden para la solicitud.
-
La dimensión
insightTrafficSourceType
ahora admiteSUBSCRIBER
como valor válido. Este valor identifica las reproducciones de video que proceden de los feeds en la página principal de YouTube o de los elementos de suscripción de YouTube. Si se usa esta fuente de tráfico como filtro, el campoinsightTrafficSourceDetail
especificará el feed de la página principal o cualquier otra página de la que provinieron las vistas. -
La API ahora admite dos métricas nuevas,
annotationClickThroughRate
yannotationCloseRate
, que se relacionan con las interacciones de los usuarios con las anotaciones que aparecen durante tus videos. Las listas de los informes de canales y los informes de propietarios de contenido se actualizaron para identificar los informes que admiten las nuevas métricas.annotationClickThroughRate
: la proporción de anotaciones en las que los espectadores hicieron clic con respecto a la cantidad total de impresiones de anotaciones en las que se puede hacer clic.annotationCloseRate
: proporción de las anotaciones que los espectadores cerraron con respecto a la cantidad total de impresiones de anotaciones.
-
La API ahora admite métricas de ingresos y de rendimiento de los anuncios, así como nuevos informes de rendimiento de los anuncios. Las métricas y los informes están disponibles solo para los socios de contenido de YouTube que participan en el Programa para socios de YouTube.
-
Los informes admitidos recientemente admiten métricas de rendimiento de los anuncios basadas en las reproducciones y métricas de rendimiento de los anuncios basadas en las impresiones. Consulta la documentación de informes de propietarios de contenido para obtener más información sobre los informes de rendimiento de los anuncios.
-
A continuación se muestran las métricas recién admitidas. La lista de informes de propietarios de contenido se actualizó para identificar los informes, incluidos los dos nuevos informes, que admiten estas métricas.
earnings
: ingresos totales estimados de todas las fuentes de publicidad vendidas por Google.grossRevenue
: Son los ingresos brutos estimados de los socios de Google o DoubleClick.primaryAdGrossRevenue
: Ingresos brutos estimados, sumados y clasificados en el tipo de anuncio principal para las reproducciones de video que abarca el informe, de socios de Google o DoubleClick.monetizedPlaybacks
: es la cantidad de reproducciones que mostraron al menos una impresión de anuncios.playbackBasedCpm
: ingresos brutos estimados por cada mil reproducciones.impressions
: es la cantidad de impresiones de anuncios verificadas publicadas.impressionBasedCpm
: Ingresos brutos estimados por cada mil impresiones de anuncios.
Nota: Consulta las definiciones de las métricas para obtener más información.
-
Toda solicitud que recupere métricas de ingresos o de rendimiento de anuncios debe enviar un token de autorización que otorgue acceso con el nuevo permiso
https://www.googleapis.com/auth/yt-analytics-monetary.readonly
.
-
-
La documentación de la API se ha reorganizado de manera tal que los diferentes tipos de informes se expliquen en páginas separadas. Por lo tanto, ahora hay páginas separadas en las que se explican los diferentes tipos de informes de canales e informes de propietarios de contenido.
-
La guía de referencia de la API ahora tiene una sección de ejemplos, que incluye ejemplos de códigos que muestran cómo invocar la API mediante las bibliotecas de cliente Java, JavaScript, Python y Ruby. El ejemplo de código JavaScript es el mismo que se analiza en detalle en la documentación de la aplicación de ejemplo.
-
La guía de referencia de la API ahora incluye el elemento APIs Explorer, que te permite llamar a la API, consultar la solicitud de la API y recuperar datos reales en la respuesta.
-
La API admite una serie de nuevos informes para canales y propietarios de contenido, que se describen a continuación. Cada informe está disponible como un informe de canales o un informe de propietarios de contenido. Las páginas de dimensiones y metrics también se actualizaron en consecuencia.
-
El informe de ubicación de reproducción especifica el número de reproducciones de videos que tuvieron lugar en diferentes tipos de páginas o aplicaciones.
-
El informe detallado de ubicaciones de reproducción identifica los reproductores integrados que generaron la mayor cantidad de reproducciones para un video determinado. Proporciona una perspectiva más precisa que el informe de ubicaciones de reproducción mediante la identificación de las direcciones URL asociadas con los principales reproductores integrados.
-
El informe de fuentes de tráfico identifica la cantidad de reproducciones de videos que se originaron a partir de diferentes tipos de URL de referencia.
-
El informe detallado de fuentes de tráfico identifica las URL de referencia que generaron la mayor cantidad de reproducciones para un video y un tipo de fuente de tráfico especificados. Por ejemplo, este informe podría indicar cuáles son los videos relacionados que enviaron el mayor tráfico a un video específico. Este informe admite varias fuentes de tráfico.
-
Los informes de tiempo de reproducción indican la cantidad de tiempo que los espectadores dedicaron a ver el contenido. Los informes pueden recopilar datos de un período de tiempo específico, un día, los siete días anteriores, los 30 días previos, etc.; o de un país determinado. Si un informe recopila datos, ya sea por día o país, también puede especificar la duración media de cada reproducción de video, así como el porcentaje promedio de cada video que los usuarios reprodujeron.
-
-
YouTube Analytics API ya está disponible para todos los desarrolladores. Puedes activar la API para tu proyecto, sin tener que solicitar acceso primero, en el panel Services de APIs console.
-
En la nueva sección Comenzar, se describen los requisitos previos y los pasos básicos para compilar una aplicación que use YouTube Analytics API.
-
La nueva sección comprensión del uso de la cuota proporciona pautas para optimizar el uso de tu cuota de API. El servidor de API calcula un costo de consulta para cada solicitud y dicho costo se deduce de tu cuota de uso de la API. Dado que los diversos tipos de informes pueden tener costos de consulta muy diferentes, debes planear el uso de tu cuota de manera eficiente, y tu aplicación solo debe solicitar las métricas y los datos realmente necesarios.
-
La sección de dimensiones temporales se actualizó para explicar que esas dimensiones indican que un informe de Analytics debe recopilar datos sobre la base de un período de tiempo. La API ahora admite las siguientes dimensiones temporales adicionales:
7DayTotals
: los datos del informe se recopilarán de manera que cada fila contenga los datos de un período de siete días.30DayTotals
: los datos del informe se recopilarán de manera que cada fila contenga los datos de un período de 30 días.month
: los datos del informe se recopilarán por mes calendario.
Del mismo modo, la sección informes disponibles se actualizó para reflejar la compatibilidad de la API con los informes que utilizan estas dimensiones.
-
La sección dimensiones de la entidad de informe se actualizó para indicar que las solicitudes de la API para recuperar informes de propietarios de contenido deben filtrar los datos con una de estas dimensiones (
video
,channel
oshow
) o una combinación admitida de las dimensionesclaimedStatus
yuploaderType
. -
La API ahora admite dos nuevas opciones de orden para los principales informes de video. Estos informes, que están disponibles como informes de canales o informes de propietarios de contenido, incluyen métricas (reproducciones, comentarios, "Me gusta", etc.) en función de cada país y desglosan las métricas por video. Ahora se pueden ordenar estos informes según la cantidad de usuarios que se suscribieron o que anularon su suscripción a un canal de la página de reproducción del video.
-
Se actualizaron las definiciones de las metrics
subscribersGained
ysubscribersLost
para explicar que un canal puede ganar o perder suscriptores en varios lugares, incluidos la página de reproducción del video, el canal de usuario y la guía que aparece en la página principal de YouTube. Cuando estas métricas aparecen en el informe de un video específico, solo se incluyen las estadísticas de la página de reproducción de ese video en particular.
La API de informes de YouTube admite tres nuevos informes de pantalla final, así como nuevas dimensiones y métricas para esos informes. Los informes proporcionan estadísticas de impresiones y clics para las pantallas finales que aparecen después de que se detiene la reproducción de un video.
El Centro de ayuda de YouTube contiene información más detallada para agregar pantallas finales a tus videos.
8 de noviembre de 2016
Esta actualización incluye los siguientes cambios en la API de YouTube Analytics:
27 de octubre de 2016
Ahora, YouTube genera automáticamente un conjunto de informes de ingresos por anuncios administrados por el sistema para los propietarios del contenido que tienen acceso a los informes correspondientes en la sección Informes de Creator Studio de YouTube. Los nuevos informes de la API administrada por el sistema están diseñados para proporcionar acceso programático a los datos que también están disponibles en los informes descargables manualmente de Creator Studio.
La descripción general de los informes administrados por el sistema ofrece una descripción general breve de los informes nuevos y explica el proceso para recuperarlos mediante la API. Este proceso es ligeramente diferente del de recuperar informes masivos de YouTube Analytics, ya que los socios no necesitan programar trabajos para generar los informes.
Se actualizó la propiedad id
del recurso reportType
para incluir una lista de los informes administrados por el sistema a los que puedes acceder a través de la API:
27 de septiembre de 2016
Nota: Este es un anuncio de baja.
La métrica uniques
de la API de YouTube Analytics dejó de estar disponible. Esta no es una métrica principal y se admitirá hasta el 31 de octubre de 2016.
15 de septiembre de 2016
Esta actualización incluye los siguientes cambios en la API de informes de YouTube:
19 de agosto de 2016
Esta actualización incluye el siguiente cambio en la API de informes de YouTube:
11 de agosto de 2016
Esta actualización incluye los siguientes cambios:
10 de agosto de 2016
Esta actualización incluye los siguientes cambios:
18 de julio de 2016
Esta actualización incluye los siguientes cambios:
28 de junio de 2016
Actualizamos la documentación de la API de YouTube Analytics para reflejar la compatibilidad con las métricas de tarjetas en varios informes de canales y propietarios del contenido. Las métricas nuevas admitidas son las siguientes:
Las métricas se admiten en los siguientes tipos de informes:
22 de junio de 2016
Esta actualización incluye los siguientes cambios en la API de informes de YouTube. El primer cambio corresponde a la API en general y los cambios restantes solo afectan a los informes de propietarios de contenido:
19 de mayo de 2016
Esta actualización incluye los siguientes cambios en la API de informes de YouTube:
12 de abril de 2016
Esta actualización incluye los siguientes cambios, que solo afectan a la API de informes de YouTube:
28 de marzo de 2016
La API de informes de YouTube y la API de YouTube Analytics ahora muestran estadísticas de vistas para varios servicios adicionales de uso compartido.
16 de marzo de 2016
Esta actualización incluye los siguientes cambios, que afectan tanto a la API de YouTube Reporting como a la de YouTube Analytics:
API de YouTube Reporting
API de YouTube Analytics
8 de febrero de 2016
Se actualizó la lista de métricas compatibles con la API de YouTube Analytics, de modo que las métricas de tarjetas ya no aparecen como métricas compatibles con esa API. (ninguno de los informes de esa API se había documentado como respaldo para ninguna de las métricas de las tarjetas).
Ten en cuenta que aún puedes recuperar las métricas de la tarjeta con la API de informes de YouTube, que admite esas métricas para varios informes de canales y propietarios de contenido.
6 de enero de 2016
La API de informes de YouTube y la API de YouTube Analytics ahora identifican específicamente las vistas que se producen a través de un dispositivo Chromecast.
21 de diciembre de 2015
En la documentación, se actualizaron los nombres de las métricas annotation_clickable_impressions
y annotation_closable_impressions
para que coincidan con los nombres que se muestran en los informes. Anteriormente, los nombres se documentaban como clickable_annotation_impressions
y closable_annotation_impressions
.
18 de diciembre de 2015
Las leyes de la Unión Europea (UE) exigen que se divulguen ciertas divulgaciones y que se obtenga el consentimiento de los usuarios finales de la UE. Por lo tanto, en el caso de los usuarios finales de la Unión Europea, debe satisfacer la Política de Consentimiento de Usuarios de la UE. Agregamos un aviso de este requisito en nuestras Condiciones del Servicio de la API de YouTube.
15 de diciembre de 2015
Esta actualización incluye los siguientes cambios, que afectan a la API de YouTube Analytics:
10 de noviembre de 2015
Esta actualización incluye los siguientes cambios:
29 de octubre de 2015
Esta actualización incluye los siguientes cambios:
8 de octubre de 2015
Esta actualización incluye los siguientes cambios:
24 de septiembre de 2015
Esta actualización incluye los siguientes cambios:
20 de agosto de 2015
Esta actualización incluye los siguientes cambios:
22 de julio de 2015
Esta actualización incluye varios cambios, y todos ellos solo se aplican a los propietarios del contenido:
1 de junio de 2015
Esta actualización incluye los siguientes cambios:
31 de marzo de 2015
Esta actualización incluye los siguientes cambios:
16 de marzo de 2015
Esta actualización incluye los siguientes cambios:
25 de febrero de 2015
Esta actualización incluye los siguientes cambios:
13 de febrero de 2015
Esta actualización incluye los siguientes cambios:
28 de agosto de 2014
Esta actualización incluye los siguientes cambios:
16 de julio de 2014
Esta actualización incluye los siguientes cambios:
31 de enero de 2014
Esta actualización incluye los siguientes cambios:
16 de enero de 2014
Esta actualización incluye los siguientes cambios:
6 de enero de 2014
Esta actualización incluye los siguientes cambios:
30 de septiembre de 2013
Esta actualización incluye los siguientes cambios:
16 de julio de 2013
Esta actualización incluye los siguientes cambios:
23 de mayo de 2013
Esta actualización incluye los siguientes cambios:
10 de mayo de 2013
Esta actualización incluye los siguientes cambios:
6 de mayo de 2013
Esta actualización incluye los siguientes cambios:
3 de mayo de 2013
Esta actualización incluye los siguientes cambios:
28 de marzo de 2013
Esta actualización incluye los siguientes cambios:
21 de marzo de 2013
Esta actualización incluye los siguientes cambios:
4 de febrero de 2013
Esta actualización incluye los siguientes cambios:
14 de noviembre de 2012
Esta actualización incluye los siguientes cambios:
2 de octubre de 2012
Esta actualización incluye los siguientes cambios:
12 de septiembre de 2012
Esta actualización incluye los siguientes cambios: