Historial de revisión

En esta página, se enumeran los cambios en las APIs y las actualizaciones de la documentación de las APIs de YouTube Reporting y YouTube Analytics. Ambas APIs permiten que los desarrolladores accedan a los datos de YouTube Analytics, aunque de diferentes maneras.

30 de octubre de 2026

La API de YouTube Reporting ahora admite los siguientes informes administrados por el sistema para los propietarios de contenido:

Categoría Nombre del informe ID del tipo de informe
Resúmenes financieros Resumen de los ajustes del canal mensuales content_owner_channel_adjustments_summary_a1
Resúmenes financieros Ingresos mensuales por transacciones de funciones pagadas content_owner_transactions_paid_features_revenue_a1
Resúmenes financieros Ingresos mensuales por transacciones de TVOD por título y país tvod_content_owner_country_title_tvod_revenue_a1
Resúmenes financieros Ingresos mensuales por transacciones de TVOD por país tvod_content_owner_country_transactions_tvod_revenue_a1
Shorts Creaciones de activos de Shorts de sellos discográficos mensuales music_content_owner_shorts_asset_creations_a1
Shorts Vistas mensuales de activos de Shorts de sellos discográficos music_content_owner_shorts_asset_views_a1
Shorts Creaciones de activos de Shorts de editoras de música mensuales publisher_content_owner_shorts_asset_creations_a1
Shorts Vistas mensuales de Shorts de editoras de música publisher_content_owner_shorts_asset_views_a1
Impuestos Informe de resumen de reembolsos fiscales mensuales de afiliados de MCN content_owner_affiliate_tax_refund_summary_a1
Recursos Informe semanal de SRMF publisher_content_owner_weekly_srmf
Recursos Informe diario del estado de las solicitudes de OAC content_owner_oac_request_status_a1
Recursos Informe diario de calidad de las solicitudes de OAC content_owner_oac_quality_status_a1

13 de septiembre de 2026

La API de YouTube Reporting ahora admite la versión 1.1 del informe de referencias semanal para los propietarios del contenido (content_owner_active_references_a2).

La versión 1.1 presenta los siguientes cambios:

  • Agrega el campo status_detail, que proporciona detalles o motivos adicionales sobre el estado del archivo de referencia.
  • Actualiza el campo asset_owners para usar los nombres visibles o los IDs externos de los propietarios del contenido en lugar de los códigos de socio.

La versión anterior del informe, la versión 1.0 (content_owner_active_references_a1), sigue estando disponible.

9 de septiembre de 2026

Se actualizó la documentación de las APIs de YouTube Analytics y YouTube Reporting con las siguientes adiciones y aclaraciones:

  • SLA de actualidad de los datos y latencia: Se agregó una sección dedicada al modelo de datos en la que se explica el retraso de 48 a 72 horas en el procesamiento de datos y el truncamiento de la fecha de finalización al último día procesado por completo, y se recomienda el método videos.list de la API de YouTube Data para obtener estadísticas de video en tiempo real.

  • Métricas monetarias en los informes de canales: Se actualizó la documentación de autorización de los informes de canales para aclarar que las métricas de ingresos estimados y rendimiento de los anuncios se admiten en los informes de canales autorizados con el permiso https://www.googleapis.com/auth/yt-analytics-monetary.readonly cuando el canal es miembro del Programa de socios de YouTube (YPP) y que los canales no monetizados devuelven el código HTTP 403 Forbidden.

  • Restricciones de consultas y compatibilidad de parámetros: Se agregó una nota de aviso a Información sobre las tablas de informes para aclarar que las combinaciones de dimensiones, métricas y filtros no válidas o que se excluyen mutuamente devuelven el código HTTP 400 badRequest ("The query is not supported.").

  • Valores de dimensiones vacíos en los informes masivos: Se actualizaron las características de los informes de la API de YouTube Reporting para explicar que las columnas de dimensiones, como video_id o channel_id, contienen cadenas vacías para conservar los recuentos de métricas agregadas de los recursos borrados y representar los eventos a nivel del canal.

27 de agosto de 2026

YouTube alineará el recuento de vistas públicas para todos los formatos de video: videos de formato largo, transmisiones en vivo y Shorts. YouTube registrará las vistas públicas en el momento en que comience a reproducirse un video.

La elegibilidad para la monetización y la mayoría de las métricas de rendimiento principales no se ven afectadas, ya que siguen ancladas en las métricas de participación. Los ingresos de los creadores se seguirán calculando según las vistas interesadas de Shorts y las horas de reproducción de las vistas interesadas, que puedes ver en YouTube Analytics > Modo avanzado.

No hay cambios en los requisitos de elegibilidad del Programa de socios de YouTube. Los requisitos de entrada al Programa de socios de YouTube se llaman ahora "vistas de Shorts aptas" y "horas de reproducción aptas" (antes se conocían como "vistas de Shorts públicas válidas" y "horas de reproducción públicas válidas").

Para obtener más información, consulta Comprende el rendimiento de tu contenido de YouTube.

Métrica Estado Activador Se usa para lo siguiente:
Ver Actualizado El video se reproduce desde el primer fotograma (incluye la reproducción automática, mantener el puntero sobre el video y hacer clic o presionar para reproducir). Recuentos de vistas públicas estándar
Vista interesada No modificado La reproducción continúa después del primer fotograma, o bien el usuario hace clic o presiona para reproducir. Monetización a través del Programa de socios de YouTube, la mayoría de las estadísticas principales (tasa de clics y duración promedio de vistas) y los informes de participación
Impresión de miniatura No modificado La miniatura se muestra sin interacción ni reproducción automática. Mide la exposición y el empaquetado a nivel del feed.

Actualizaciones de la documentación de la API: Se actualizó la definición de la métrica engagedViews en la documentación de las métricas de la API de YouTube Analytics y las métricas de la API de YouTube Reporting.

25 de junio de 2026

Se actualizó la documentación de la API de YouTube Analytics (consultas segmentadas) para quitar el informe Actividad del usuario por ciudad para los propietarios de contenido. Este informe no es compatible con los propietarios del contenido. Las consultas de los propietarios del contenido sobre la actividad del usuario por ciudad devolverán resultados vacíos.

9 de marzo de 2026

Las dimensiones ageGroup (API de YouTube Analytics) y age_group (API de YouTube Reporting) ahora incluyen a los usuarios que YouTube estima que son menores de 18 años.

15 de enero de 2026

La API de YouTube Reporting ahora admite informes de alcance para canales y propietarios del contenido. Los informes de alcance proporcionan estadísticas sobre las impresiones de las miniaturas de video y las tasas de clics.

  • Los informes channel_reach_basic_a1 y channel_reach_combined_a1 están disponibles para los canales.
  • Los informes content_owner_reach_basic_a1 y content_owner_reach_combined_a1 están disponibles para los propietarios del contenido.

Estos informes admiten las siguientes métricas nuevas:

  • video_thumbnail_impressions
  • video_thumbnail_impressions_ctr

22 de septiembre de 2025

La baja de los informes anunciada anteriormente se retrasó del 30 de septiembre de 2025 al 31 de octubre de 2025. Las versiones anteriores de los informes actualizados para los cambios en el recuento de vistas de Shorts seguirán estando disponibles hasta entonces, con la excepción del informe de reclamos v1.0 (content_owner_active_claims_a1) y el informe de reclamos v1.1 (content_owner_active_claims_a2), que dejarán de estar disponibles el 30 de septiembre.

24 de junio de 2025

Como se anunció el 26 de marzo de 2025, la API de informes masivos se actualizará como parte del nuevo cambio en el recuento de vistas de Shorts. Se realizaron los siguientes cambios:

  • Se crearon versiones nuevas para cada informe que incluye vistas, que es la mayoría de los informes. La versión de cada informe afectado se incrementó en uno, por ejemplo, de la versión a2 a la versión a3.
  • En el caso de los Shorts, las vistas ahora registrarán las veces que un Short comienza o vuelve a reproducirse. En el caso de los videos, no hay cambios.
  • Los informes actualizados incluirán una columna nueva, engaged_views, que reflejará la metodología de recuento de vistas anterior.

Estos cambios entrarán en vigencia el 30 de junio de 2025 para la API de informes masivos. Asegúrate de ajustar el procesamiento de tus informes según corresponda.

Las versiones anteriores de los informes estarán disponibles hasta el 30 de septiembre de 2025. Después del 30 de septiembre de 2025, las versiones anteriores dejarán de estar disponibles. Asegúrate de migrar a las versiones más recientes.

Por último, asegúrate de seguir las prácticas recomendadas cuando proceses los informes para evitar que los cambios futuros en los informes interrumpan tus canalizaciones de procesamiento.

En las siguientes tablas, se muestran las nuevas versiones de informes para cada tipo de informe:

Informes de datos masivos para YouTube Analytics

Informes de canales: Informes de videos
Nombre del informe Versión anterior Versión más reciente
Actividad del usuario channel_basic_a2 channel_basic_a3
Actividad de los usuarios por provincia channel_province_a2 channel_province_a3
Sitios de reproducción channel_playback_location_a2 channel_playback_location_a3
Fuentes de tráfico channel_traffic_source_a2 channel_traffic_source_a3
Tipo de dispositivo y sistema operativo channel_device_os_a2 channel_device_os_a3
Subtítulos channel_subtitles_a2 channel_subtitles_a3
Combinado channel_combined_a2 channel_combined_a3
Informes de canales: Informes de listas de reproducción
Nombre del informe Versión anterior Versión más reciente
Actividad del usuario playlist_basic_a1 playlist_basic_a2
Actividad de los usuarios por provincia playlist_province_a1 playlist_province_a2
Sitios de reproducción playlist_playback_location_a1 playlist_playback_location_a2
Fuentes de tráfico playlist_traffic_source_a1 playlist_traffic_source_a2
Tipo de dispositivo y sistema operativo playlist_device_os_a1 playlist_device_os_a2
Combinado playlist_combined_a1 playlist_combined_a2
Informes del propietario del contenido: Informes de video
Nombre del informe Versión anterior Versión más reciente
Actividad del usuario content_owner_basic_a3 content_owner_basic_a4
Actividad de los usuarios por provincia content_owner_province_a2 content_owner_province_a3
Sitios de reproducción content_owner_playback_location_a2 content_owner_playback_location_a3
Fuentes de tráfico content_owner_traffic_source_a2 content_owner_traffic_source_a3
Tipo de dispositivo y sistema operativo content_owner_device_os_a2 content_owner_device_os_a3
Subtítulos content_owner_subtitles_a2 content_owner_subtitles_a3
Combinado content_owner_combined_a2 content_owner_combined_a3
Informes del propietario del contenido: Informes de playlists
Nombre del informe Versión anterior Versión más reciente
Actividad del usuario content_owner_playlist_basic_a1 content_owner_playlist_basic_a2
Actividad de los usuarios por provincia content_owner_playlist_province_a1 content_owner_playlist_province_a2
Sitios de reproducción content_owner_playlist_playback_location_a1 content_owner_playlist_playback_location_a2
Fuentes de tráfico content_owner_playlist_traffic_source_a1 content_owner_playlist_traffic_source_a2
Tipo de dispositivo y sistema operativo content_owner_playlist_device_os_a1 content_owner_playlist_device_os_a2
Combinado content_owner_playlist_combined_a1 content_owner_playlist_combined_a2
Informes del propietario del contenido: Informes de activos
Nombre del informe Versión anterior Versión más reciente
Actividad del usuario content_owner_asset_basic_a2 content_owner_asset_basic_a3
Actividad de los usuarios por provincia content_owner_asset_province_a2 content_owner_asset_province_a3
Ubicaciones de reproducción de video content_owner_asset_playback_location_a2 content_owner_asset_playback_location_a3
Fuentes de tráfico content_owner_asset_traffic_source_a2 content_owner_asset_traffic_source_a3
Tipo de dispositivo y sistema operativo content_owner_asset_device_os_a2 content_owner_asset_device_os_a3
Combinado content_owner_asset_combined_a2 content_owner_asset_combined_a3

Informes administrados por el sistema: Financieros (no musicales)

Informes del propietario del contenido: Informes de Shorts (contenido que no es musical)
Nombre del informe Versión anterior Versión más reciente
Resumen de ingresos publicitarios globales content_owner_shorts_global_ad_revenue_summary_a1 content_owner_shorts_global_ad_revenue_summary_a2
Resumen de ingresos publicitarios diarios content_owner_shorts_day_ad_revenue_summary_a1 content_owner_shorts_day_ad_revenue_summary_a2
Resumen de ingresos publicitarios por país content_owner_shorts_country_ad_revenue_summary_a1 content_owner_shorts_country_ad_revenue_summary_a2
Resumen de ingresos publicitarios content_owner_shorts_ad_revenue_summary_a1 content_owner_shorts_ad_revenue_summary_a2

Informes administrados por el sistema: No financieros

Informes del propietario del contenido: Informes de reclamos
Nombre del informe Versión anterior Versión más reciente
Reclamos activos content_owner_active_claims_a2 content_owner_active_claims_a3
Informes del propietario del contenido: Informes de metadatos de video
Nombre del informe Versión anterior Versión más reciente
Metadatos del video content_owner_video_metadata_a3 content_owner_video_metadata_a4
Informes del propietario del contenido: Informes de activos
Nombre del informe Versión anterior Versión más reciente
Recursos content_owner_asset_a2 content_owner_asset_a3
Conflictos de activos content_owner_asset_conflict_a2 content_owner_asset_conflict_a3

24 de abril de 2025

Como se anunció el 26 de marzo de 2025, la API de Targeted Queries se actualizará como parte del nuevo cambio en el recuento de vistas de Shorts:

  • En el caso de los Shorts, views ahora contará la cantidad de veces que un Short comienza a reproducirse o vuelve a hacerlo.
  • La nueva métrica, engagedViews, reflejará la metodología de recuento de vistas anterior. engagedViews estará disponible en todos los informes junto con views.

Estos cambios entrarán en vigencia el 30 de abril de 2025 para la API de consultas segmentadas. Asegúrate de ajustar tus consultas según corresponda.

Consulta este historial de revisiones para conocer qué cambios se realizarán en la API de informes masivos y cuándo.

22 de abril de 2025

Como se anunció el 7 de abril de 2024, la dimensión isCurated dejó de estar disponible para los informes de canales y de playlists de propietarios del contenido. A partir del 31 de diciembre de 2024, la dimensión dejará de ser compatible. La dimensión se quitó de los informes y de la documentación.

26 de marzo de 2025

Esta actualización contiene el siguiente cambio relacionado con las APIs de YouTube Analytics y YouTube Reporting:

A partir del 31 de marzo de 2025, YouTube cambiará la forma en que se registran las vistas de Shorts. Antes, en YouTube, se registraba una vista después de que un Short se reproducía durante una cantidad determinada de segundos. Ahora, las vistas contarán la cantidad de veces que un Short comienza o vuelve a reproducirse, sin un requisito de tiempo de reproducción mínimo. Más información

Las APIs de YouTube Analytics (consultas segmentadas) y Reporting (informes masivos) se actualizarán con los siguientes cambios:

  • En el caso de los Shorts, las views registran la cantidad de veces que un Short comienza o vuelve a reproducirse.
  • Se habilitará una nueva métrica, engagedViews, que reflejará la metodología de recuento de vistas anterior.
  • Si tienes la propiedad de un canal o tienes autorización para acceder a los datos de un canal, podrás consultar las vistas actualizadas y las vistas interesadas.

Las consultas segmentadas se actualizarán antes del 30 de abril, y los informes masivos, antes del 30 de junio. Hasta entonces, las vistas se basarán en la metodología anterior. Las vistas de Shorts y del canal no coincidirán con las de Analytics en Studio.

Además, se retrasó la baja anunciada anteriormente del informe de reclamos diarios (versión 1.0).

Consulta este historial de revisión para saber cuándo se realizan cambios en las APIs.

3 de marzo de 2025

Esta actualización contiene el siguiente cambio relacionado con la API de YouTube Reporting:

Nota: Este es un anuncio de baja.

El informe Reclamos diarios (versión 1.0) ya no está disponible para los socios. Dejará de ser compatible a partir del 30 de abril de 2025. La definición de ese informe se actualizó en consecuencia. En su lugar, usa el informe de reclamos diarios más reciente.

15 de noviembre de 2024

Nota: El siguiente cambio entrará en vigencia el 18 de noviembre de 2024.

Se actualizó la documentación de la API de YouTube Analytics (consultas segmentadas) para indicar que, en los informes de fuentes de tráfico, el método reports.query de la API ahora devuelve un error si el producto de la cantidad de videos consultados por la cantidad de días en el período supera los 50,000. Por ejemplo, una consulta que recupera datos de 500 IDs de video puede solicitar datos de un máximo de 100 días.

Este cambio afecta los informes de los canales y los propietarios del contenido.

Para reducir la cantidad de filas que devuelve una solicitud, divide tu consulta en varias consultas que especifiquen menos videos o establezcan períodos más cortos. Como regla, se recomiendan los informes masivos para los conjuntos de datos grandes.

6 de mayo de 2024

La API de YouTube Analytics (consultas segmentadas) admite tres informes nuevos para los canales:

Además, se mejoró el informe de retención de público para que admita tres métricas nuevas:

7 de abril de 2024

La API de YouTube Analytics (consultas segmentadas) tiene varias actualizaciones relacionadas con los informes de playlists de los propietarios del contenido. Las actualizaciones son las mismas que las relacionadas con los informes de playlists de canales, que se anunciaron el 19 de enero de 2024.

La siguiente entrada del historial de revisiones 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 los 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 playlists de los 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 de contenido. Dejará de ser compatible a partir del 31 de diciembre de 2024. La definición de esa dimensión se actualizó en consecuencia.

    Para preservar la retrocompatibilidad cuando quites la dimensión isCurated, también debes actualizar tu código para recuperar la métrica playlistViews en lugar de la métrica views solo para los informes de playlists. Dado que la métrica views se sigue admitiendo en los informes de playlists, aunque con un significado diferente, la API seguirá devolviendo datos si no actualizas el nombre de la métrica. Por supuesto, puedes modificar tu aplicación para recuperar y mostrar views y playlistViews.

    Además de la dimensión isCurated, las siguientes funciones de la API ya no se admiten en los informes nuevos:

    • Los filtros de ubicación, como continent y subcontinent, no son compatibles con los nuevos informes de playlists de canales.
    • Las métricas redViews y estimatedRedMinutesWatched ya no se admiten en los nuevos informes de playlists de canales. Estas métricas no están disponibles en YouTube Studio, por lo que este cambio alinea la funcionalidad de la API con la funcionalidad disponible en la aplicación de Studio.
    • Las dimensiones subscribedStatus y youtubeProduct ya no se admiten como filtros para los informes de listas de reproducción de canales. Estos filtros no están disponibles en YouTube Studio, por lo que este cambio alinea la funcionalidad de la API con la funcionalidad disponible en la aplicación de Studio.

  • Se actualizó la sección Informes de playlists de la documentación de informes de propietarios del contenido para explicar con más detalle los tipos de métricas que se admiten en los informes de playlists:

    • Métricas de video agregadas Proporcionan métricas de impresiones y actividad del usuario que se agregan para todos los videos de las playlists del propietario del contenido que también son de su propiedad. 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 de 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 de otros propietarios en la playlist, pero solo cuando esas vistas se produjeron en el contexto de la playlist.
    • En la sección Métricas de playlists admitidas, se identifican las métricas de videos agregadas y las métricas de playlists que se admiten en los informes de playlists.

  • Las siguientes métricas nuevas en la playlist se admiten en los informes de playlists para los propietarios del 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 de las métricas para obtener definiciones de cada una:

  • 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ón isCurated:

    • Cuando una solicitud incluye la dimensión isCurated, la métrica views es una métrica de lista de reproducción que indica la cantidad de veces que se vieron los videos en el contexto de las listas de reproducción del propietario del contenido.
    • Cuando una solicitud no incluye la dimensión isCurated, la métrica views 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 realizaron en el contexto de la playlist. El total agregado solo incluye las vistas de los videos que pertenecen al propietario del contenido asociado con el canal que es dueño de la playlist.

      En estos informes, que no usan la dimensión isCurated, la métrica playlistViews indica la cantidad de veces que se miraron los videos en el contexto de la playlist. Esa métrica cuenta las vistas de todos los videos de la playlist, sin importar a qué canal pertenezcan.

  • Para cada informe de playlist, la documentación de los informes del propietario del contenido ahora incluye tablas que muestran las métricas admitidas para ese informe, según si la solicitud a la API incluye la dimensión isCurated. Consulta la sección en la que se definen los informes de playlists basados en el tiempo para ver un ejemplo.

19 de enero de 2024

La API de YouTube Analytics (consultas 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. Dejará de ser compatible a partir del 30 de junio de 2024. La definición de esa dimensión se actualizó según corresponda.

    Para preservar la retrocompatibilidad cuando quites la dimensión isCurated, también debes actualizar tu código para recuperar la métrica playlistViews en lugar de la métrica views solo para los informes de playlists. Dado que la métrica views se sigue admitiendo en los informes de playlists, aunque con un significado diferente, la API seguirá devolviendo datos si no actualizas el nombre de la métrica. Por supuesto, puedes modificar tu aplicación para recuperar y mostrar views y playlistViews.

    Además de la dimensión isCurated, las siguientes funciones de la API ya no se admiten en los informes nuevos:

    • Los filtros de ubicación, como continent y subcontinent, no son compatibles con los nuevos informes de playlists de canales.
    • Las métricas redViews y estimatedRedMinutesWatched ya no se admiten en los nuevos informes de playlists de canales. Estas métricas no están disponibles en YouTube Studio, por lo que este cambio alinea la funcionalidad de la API con la funcionalidad disponible en la aplicación de Studio.
    • Las dimensiones subscribedStatus y youtubeProduct ya no se admiten como filtros para los informes de listas de reproducción de canales. Estos filtros no están disponibles en YouTube Studio, por lo que este cambio alinea la funcionalidad de la API con la funcionalidad disponible en la aplicación de Studio.

  • Se actualizó la sección Informes de playlists de la documentación de informes de canales para explicar con más detalle los tipos de métricas que se admiten en los informes de playlists:

    • Métricas de video agregadas proporcionan métricas de actividad del usuario y de impresiones 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 de 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 de otros propietarios en la playlist, pero solo cuando esas vistas se produjeron en el contexto de la playlist.
    • En la sección Métricas de playlists admitidas, se identifican las métricas de videos agregadas y las métricas de playlists que se admiten en los informes de playlists.

  • Las siguientes métricas nuevas en la playlist son compatibles con los informes de playlists de los canales. Estas métricas aún no se admiten en los informes de propietarios del 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 de las métricas para obtener definiciones de cada una:

  • 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ón isCurated:

    • Cuando una solicitud incluye la dimensión isCurated, la métrica views es una métrica de playlist que indica la cantidad de veces que se vieron los videos en el contexto de las playlists del canal.
    • Cuando una solicitud no incluye la dimensión isCurated, la métrica views es una métrica de video agregada que especifica la cantidad total de veces que se miró ese video en las playlists del canal, independientemente de si esas vistas se realizaron 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ón isCurated, la métrica playlistViews indica la cantidad de veces que se miraron los videos en el contexto de la playlist. Esa métrica cuenta las vistas de todos los videos de la playlist, sin importar a qué canal pertenezcan.

  • Para cada informe de playlist, la documentación de los informes de canal ahora incluye tablas que muestran las métricas admitidas para ese informe, según si la solicitud a la API incluye la dimensión isCurated. Consulta la sección en la que se definen los informes de playlists basados en el tiempo para ver un ejemplo.

4 de diciembre de 2023

Se actualizó la API de YouTube Analytics (consultas segmentadas) para combinar dos valores de la dimensión insightTrafficSourceType. Anteriormente, la dimensión diferenciaba entre los videos que se reproducían como parte de una playlist (PLAYLIST) y las vistas que se originaban en una página que incluía todos los videos de una playlist (YT_PLAYLIST_PAGE). En el futuro, ambos tipos de vistas se asociarán con el valor de dimensión PLAYLIST.

15 de diciembre de 2022

La API de YouTube Analytics (consultas segmentadas) admite dos dimensiones nuevas y un informe nuevo:

  • Un informe nuevo proporciona 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 de la ciudad en la que se produjo la actividad del usuario.

  • La nueva dimensión creatorContentType identifica el tipo de contenido de YouTube que se asocia con las métricas de actividad del usuario en la fila de datos. Los valores admitidos son LIVE_STREAM, SHORTS, STORY y VIDEO_ON_DEMAND.

    La dimensión creatorContentType se admite como una dimensión opcional para todos los informes de video de canales y propietarios del contenido.

  • La guía de solicitudes de muestra de la API de YouTube Analytics ahora incluye ejemplos de ambas dimensiones nuevas.

  • Se quitaron de la documentación las referencias a las dimensiones 7DayTotals y 30DayTotals. La baja de estas dimensiones se anunció en octubre de 2019.

26 de agosto de 2022

Las APIs de YouTube Analytics (consultas segmentadas) y de YouTube Reporting (informes masivos) admiten un nuevo valor de detalle de la fuente de tráfico:

  • En la API de YouTube Analytics (consultas segmentadas), si el valor de la dimensión insightTrafficSourceType es SUBSCRIBER, el valor de insightTrafficSourceDetail se puede establecer en podcasts, lo que indica que el tráfico se refirió desde la página de destino de Podcasts.
  • En la API de YouTube Reporting (informes masivos), si el valor de la dimensión traffic_source_type es 3, el valor de traffic_source_detail se puede establecer en podcasts, lo que indica que el tráfico se derivó 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. Este podría ser un cambio incompatible con versiones anteriores en la implementación de tu API. De acuerdo con la sección Cambios incompatibles con versiones anteriores de las Condiciones del Servicio de los Servicios de APIs de YouTube, este cambio se anuncia seis meses antes de que entre en vigencia. Actualiza tu implementación de la API antes del 11 de agosto de 2022 para garantizar una transición fluida al nuevo conjunto de valores.

Los cambios específicos que se realizarán son los siguientes:

  • En la API de YouTube Analytics (consultas segmentadas), la dimensión gender actualmente admite dos valores: female y male. A partir del 11 de agosto de 2022, esa dimensión admitirá tres valores: female, male y user_specified.
  • En la API de informes de YouTube (informes masivos), la dimensión gender actualmente admite tres valores: FEMALE, MALE y GENDER_OTHER. A partir del 11 de agosto de 2022, el conjunto de valores admitidos cambiará a FEMALE, MALE y USER_SPECIFIED.

9 de febrero de 2022

Se actualizaron dos métricas para excluir el tráfico de los clips en bucle a partir del 13 de diciembre de 2021. Este cambio afecta tanto a la API de YouTube Analytics (consultas segmentadas) como a la API de YouTube Reporting (informes masivos).

2 de febrero de 2022

La API de YouTube Reporting (informes masivos) admite un nuevo valor de dimensión de fuente de tráfico que indica que las vistas se originaron a partir de Live Redirects:

  • En la API de YouTube Reporting (informes masivos), la dimensión traffic_source_type admite el valor 28.

Para este tipo de fuente de tráfico, la dimensión traffic_source_detail especifica el ID del canal desde el que se derivó al usuario.

23 de septiembre de 2020

Tanto la API de YouTube Analytics (consultas segmentadas) como la API de YouTube Reporting (informes masivos) admiten un nuevo valor de dimensión de fuente de tráfico que indica que el usuario llegó al contenido deslizando el dedo verticalmente en la experiencia de visualización de YouTube Shorts:

  • En la API de YouTube Analytics (consultas segmentadas), la dimensión insightTrafficSourceType admite el valor SHORTS.
  • En la API de YouTube Reporting (informes masivos), la dimensión traffic_source_type admite el valor 24.

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 YouTube Reporting) no se propaga para este nuevo tipo de fuente de tráfico.

20 de julio de 2020

Esta actualización incluye 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étodo reports.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 filtros video, playlist y channel, 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 contiene los siguientes cambios relacionados con la API de YouTube Analytics (consultas segmentadas) y la API de YouTube Reporting (informes masivos). Para obtener más información sobre estos cambios, consulta el Centro de ayuda de YouTube.

En ambas APIs, cambiará el conjunto de valores posibles de los detalles de la fuente 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 valores nuevos dividen las notificaciones relacionadas con los videos subidos y las transmisiones en vivo, que antes se informaban como uploaded, en dos categorías:

  • uploaded_push: Son las vistas que se originaron a partir de las notificaciones push que se enviaron a los suscriptores cuando se subió un video.
  • uploaded_other: Son las vistas que se originaron a partir de notificaciones que no son push, como las de correo electrónico o de la bandeja de entrada, que se enviaron a los suscriptores cuando se subió un video.

Estos valores se devuelven para el período que comienza el 13 de enero de 2020.

Además, recuerda que estos valores no representan las notificaciones en sí, sino las fuentes de tráfico que generaron ciertas vistas de YouTube. Por ejemplo, si una fila del informe indica views=3, traffic_source_type=17 (NOTIFICATION) y traffic_source_detail=uploaded_push, significa que se generaron tres vistas cuando los usuarios hicieron clic en las notificaciones push que se enviaron cuando se subió el video.

15 de octubre de 2019

Esta actualización contiene los siguientes cambios relacionados con la API de YouTube Analytics (consultas segmentadas):

  • Nota: Este es un anuncio de baja.

    YouTube quitará la compatibilidad con las dimensiones 7DayTotals y 30DayTotals. Podrás seguir recuperando datos con esas dimensiones hasta el 15 de abril de 2020. A partir de esa fecha, los intentos de recuperar informes con la dimensión 7DayTotals o 30DayTotals 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 treinta días. Por ejemplo:

    • La cantidad de vistas de un período de siete días se puede calcular agregando la cantidad de vistas de cada día de ese período.
    • El valor de viewerPercentage 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 de viewerPercentage de ese día para obtener la cantidad de usuarios que estaban conectados cuando miraron el video ese día. Luego, se puede sumar la cantidad de usuarios que accedieron a su cuenta durante todo el período y dividirla por la cantidad total de vistas de ese período para obtener el valor de viewerPercentage de todo el período.
    • No se puede calcular la cantidad de usuarios únicos para un período de siete días, ya que el mismo usuario podría calcularse como un usuario único en diferentes días. Sin embargo, es posible que puedas usar la dimensión month en lugar de la dimensión 30DayTotals para extrapolar datos sobre la cantidad de usuarios únicos durante un período de 30 días. Ten en cuenta que la dimensión month hace referencia a los meses calendario, mientras que la dimensión 30DayTotals 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 contiene los siguientes cambios relacionados con la API de YouTube Analytics (consultas segmentadas):

  • Dado que la versión 1 de la API ya está completamente obsoleta, 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 que explica cómo actualizar a la versión 2.

1 de noviembre de 2018

Esta actualización contiene los siguientes cambios relacionados con la API de YouTube Analytics (consultas segmentadas):

  • La versión 1 de la API ya no está disponible. Si aún no lo hiciste, 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 cronograma para esta baja se anunció originalmente el 26 de abril de 2018.

17 de septiembre de 2018

Esta actualización contiene los siguientes cambios relacionados con la API de YouTube Analytics (consultas segmentadas):

  • En la nueva sección Anonimización de datos del documento de descripción general del modelo de datos, se explica que algunos datos de YouTube Analytics se limitan cuando las métricas no alcanzan un umbral específico. Esto puede suceder en varios casos. En la práctica, esto significa que es posible que un informe no contenga todos tus datos (o ninguno) en los siguientes casos:

    1. un video o canal tiene tráfico limitado durante un período específico

      o

    2. Seleccionaste un filtro o una dimensión, como la fuente de tráfico o el país, para los que los valores no alcanzan un umbral específico.

    La nueva sección también incluye un análisis de los tipos de datos que podrían estar limitados en los informes de YouTube Analytics.

  • Se actualizaron los documentos de los informes de canales y los informes de propietarios del contenido para reflejar que las métricas redViews y estimatedRedMinutesWatched ya no se admiten en los informes de ubicación de reproducción, fuente de tráfico y tipo de dispositivo o sistema operativo.

18 de junio de 2018

Esta actualización contiene los siguientes cambios en la API de YouTube Analytics (consultas segmentadas):

  • Cambiaron los requisitos de permisos para los siguientes métodos:
    • Las solicitudes al método reports.query deben tener acceso al permiso https://www.googleapis.com/auth/youtube.readonly.
    • Las solicitudes al método groupItems.list deben tener acceso a una de las siguientes opciones:
      • el permiso https://www.googleapis.com/auth/youtube
        o
      • el permiso https://www.googleapis.com/auth/youtube.readonly
        y
        el permiso https://www.googleapis.com/auth/yt-analytics.readonly

      La primera opción usa un permiso, que resulta ser de lectura y escritura, mientras que la segunda opción usa dos permisos de solo lectura.

23 de mayo de 2018

Esta actualización contiene los siguientes cambios en la API de YouTube Analytics (consultas segmentadas):

  • La descripción general de la API contiene una sección nueva, métricas agregadas y elementos borrados, en la que se explica cómo las respuestas de la API manejan los datos asociados con los recursos borrados, como videos, playlists o canales.
  • Se actualizó la sección de prácticas recomendadas de la descripción general de la API para recordarte que puedes usar la API de YouTube Data para recuperar metadatos adicionales de 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 APIs de YouTube (secciones III.E.4.b a III.E.4.d), los clientes de API deben borrar o actualizar los metadatos de recursos almacenados de esa API después de 30 días.

22 de mayo de 2018

Esta actualización contiene los siguientes cambios relacionados con la API de YouTube Reporting (informes masivos):

  • Actualmente, está previsto que los siguientes cambios entren en vigencia en julio de 2018, y las nuevas políticas se aplicarán a nivel global para todos los informes y trabajos de informes.

    • Después del cambio, la mayoría de los informes de la API, incluidos los de reabastecimiento, estarán disponibles durante 60 días a partir del momento en que se generen. Sin embargo, los informes que contienen datos históricos estarán disponibles durante 30 días desde el momento en que se generen.

      Antes de este anuncio, todos los informes de la API estaban disponibles durante 180 días desde el momento en que se generaban. Para que quede claro, cuando este cambio de política entre en vigencia, 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ás acceder a los demás informes que tengan más de 60 días. Por lo tanto, la documentación ahora indica que los informes creados antes del cambio de política estarán disponibles durante un máximo de 180 días.

    • Después del cambio, cuando programes un trabajo de informe, YouTube generará informes a partir de ese día y abarcará el período de 30 días anterior al momento en que se programó el trabajo. Antes del cambio, cuando programes un trabajo de informe, YouTube generará informes que abarcarán el período de 180 días anterior al momento en que se programó el trabajo.

  • Se actualizó la sección de prácticas recomendadas para recordarte que puedes usar la API de YouTube Data para recuperar metadatos adicionales de los recursos identificados en los informes. Como se indica en las Políticas para Desarrolladores de los Servicios de APIs de YouTube (secciones III.E.4.b a III.E.4.d), los clientes de API deben borrar o actualizar los metadatos de recursos almacenados de esa API después de 30 días.

  • Se actualizó la sección Características de los informes para indicar que, aunque no se filtran los datos de los informes, aquellos que contengan datos de un período posterior al 1 de junio de 2018 no incluirán referencias a recursos de YouTube que se hayan borrado al menos 30 días antes de la fecha de generación del informe.

  • Se actualizó la sección de datos históricos de la descripción general de la API para indicar que, cuando programas un nuevo trabajo de informes, los informes históricos suelen publicarse en un par de días. Anteriormente, en la documentación se indicaba que estos informes podían tardar hasta 30 días en estar disponibles.

  • Se actualizó la sección 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 a un conjunto entregado anteriormente.

26 de abril de 2018

La versión 2 de la API de YouTube Analytics (consultas segmentadas) ya está disponible para el público. En la siguiente lista, se identifican los cambios en el producto y la documentación relacionados con la nueva versión de la API:

  • La API de la versión 2 es casi idéntica a la de la versión 1. 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 a v2.
    • La URL base para las solicitudes a la API cambió de https://www.googleapis.com/youtube/analytics/v1 a https://youtubeanalytics.googleapis.com/v2.
    • Se actualizaron los nombres de varios parámetros del método reports.query. Específicamente, los nombres de parámetros que contienen guiones, como end-date en la API de v1, usan mayúsculas mediales (endDate) en lugar de guiones en la API de v2. Este cambio hace que los nombres de los parámetros sean coherentes en toda la API, ya que los métodos de la API para crear y administrar grupos ya usaban mayúsculas mediales para los nombres de los parámetros.
    • La API v2 no admite solicitudes por lotes enviadas al extremo por lotes HTTP global de Google (www.googleapis.com/batch). Si envías solicitudes por lotes en la API v2, debes usar el extremo https://youtubeanalytics.googleapis.com/v2 en su lugar.

    Además, algunas funciones de la versión 1 no se admiten en la API de la versión 2:

    • El método reports.query ya no admite los parámetros de solicitud alt, quotaUser ni userIp.
    • La API v2 no proporciona un extremo por lotes que admita lotes compuestos por solicitudes a diferentes APIs. (Sin embargo, un lote puede incluir 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 lotes global en todas sus APIs.
    • La API v2 no admite el protocolo JSON-RPC, que sí se admitía en la API v1. Reiteramos que esta baja no es específica de la API de YouTube Analytics.

  • Nota: Este es un anuncio de baja.

    La versión 1 de la API (v1) ya no se usa y se admitirá hasta el 31 de octubre de 2018. Todas las solicitudes a la API de la versión 1 dejarán de funcionar después de esa fecha. Por lo tanto, asegúrate de actualizar a la versión 2 de la API antes del 31 de octubre de 2018 para evitar interrupciones en tu capacidad de acceder a los datos de YouTube Analytics a través de la API.

21 de febrero de 2018

Esta actualización contiene los siguientes cambios en la API de YouTube Analytics (consultas segmentadas):

  • Los informes demográficos de los usuarios, que agregan estadísticas de visualización según el grupo etario y el género de los usuarios, 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

  • API de YouTube Analytics (consultas segmentadas)

20 de diciembre de 2017

Esta actualización contiene dos cambios relacionados con la API de YouTube Reporting:

  • 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 se admite para otros tipos de solicitudes a la API. Habilitar la compresión gzip reduce el ancho de banda necesario para cada respuesta de la API. Y, 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 como gzip, 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 recurso report.

  • Se corrigió la documentación de las dimensiones age group y gender para mostrar los valores reales que devuelve la API para esas dimensiones. Ten en cuenta que esta es una corrección de la 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 palabra AGE y los números del grupo de edad, y usan guiones bajos en lugar de guiones. Por lo tanto, los valores como age13-17 y age18-24 se corrigieron a AGE_13_17 y AGE_18_24, respectivamente.
    • Los valores de la dimensión gender usan letras mayúsculas. Por lo tanto, los valores female, male y gender_other se corrigieron a FEMALE, MALE y GENDER_OTHER.

10 de agosto de 2017

El 10 de agosto de 2016, en 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 nueva métrica, llamada estimatedRevenue, que proporciona los mismos datos).

Como 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 finalizó ese período de un año, la métrica earnings ya no es compatible. Como resultado, las solicitudes a la API que especifican la métrica earnings ahora devuelven un código de respuesta HTTP 400. Si aún no actualizaste tu app para usar 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 (consultas segmentadas)

    • Se actualizó la documentación de la API para reflejar el hecho de que las respuestas de la API contienen datos hasta el último día del período solicitado para el que están disponibles todas las métricas que se consultan.

      Por ejemplo, si una solicitud especifica una fecha de finalización del 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).

    • La dimensión adType ahora admite el valor reservedBumperInstream, que hace referencia a un anuncio de video que no se puede omitir, de hasta 6 segundos, que se reproduce antes de que se pueda ver un video. El formato del anuncio es idéntico al del anuncio de auctionBumperInstream, pero este tipo se refiere a los anuncios que se venden con reservación en lugar de subasta.

  • API de YouTube Reporting (informes masivos)

    • La dimensión ad_type ahora admite el valor 20, que se refiere a los anuncios bumper vendidos de forma reservada. Los anuncios bumper son anuncios de video que no se pueden omitir, de un máximo de 6 segundos, que deben mirarse antes de que se inicie el video. Ten en cuenta que el valor 19 de esta dimensión también hace referencia a los anuncios bumper que se venden en 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 anunciaron como obsoletos el 15 de septiembre de 2016 y ya no se generaron informes para esos tipos de informes después del 15 de diciembre de 2016. Los informes generados anteriormente siguieron estando disponibles durante 180 días desde el momento en que se generaron. Por lo tanto, algunos informes estuvieron disponibles hasta el 15 de junio de 2017. Sin embargo, como los informes ya no están disponibles, tampoco se necesitan los trabajos asociados a ellos.

24 de mayo de 2017

Se borraron todos los trabajos de informes de los siguientes informes de la API de YouTube Reporting:

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

Estos tipos de informes se anunciaron como obsoletos el 22 de junio de 2016 y, después del 22 de septiembre de 2016, ya no se generaron informes para esos tipos. Los informes generados anteriormente siguieron estando disponibles durante 180 días desde el momento en que se generaron. Por lo tanto, se pudo acceder a algunos informes hasta el 22 de marzo de 2017. Sin embargo, como los informes ya no están disponibles, tampoco se necesitan los trabajos asociados a 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 Music
      • 86: YouTube Gaming
      • 87: YouTube Kids
      • 88: YouTube TV

      Además, el nombre que se usa para identificar el valor 52 se actualizó en la documentación a Kakao (Kakao Talk) para diferenciarlo con mayor claridad del valor 73 (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.

  • API de YouTube Analytics (consultas segmentadas)

    • La dimensión sharingService ahora admite los siguientes valores:
      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

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 esos datos de ingresos a través de la API de YouTube Analytics:

17 de marzo de 2017

Esta actualización incluye los siguientes cambios:

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 indicar que el valor de la dimensión se refiere al período que comienza a las 12:00 a.m. 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 es UTC-7 o UTC-8.

      Aunque las fechas suelen representar un período de 24 horas, las fechas en las que se adelantan los relojes representan un período de 23 horas, y las fechas en las que se retrasan los relojes representan un período de 25 horas. (Anteriormente, en la documentación se 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: Tizen
      • 23: Firefox
      • 24: RealMedia

    • Se borraron todos los trabajos de informes para el tipo de informe content_owner_basic_a1. Ese tipo de informe se dejó de usar por completo el 19 de agosto de 2016, pero los informes content_owner_basic_a1 generados anteriormente siguieron disponibles durante 180 días a partir de la fecha en que se generaron. Por lo tanto, se pudo acceder a algunos informes hasta el 19 de febrero de 2017. Sin embargo, como los informes ya no están disponibles, tampoco se necesitan los trabajos asociados a ellos.

  • API de YouTube Analytics (consultas segmentadas)

    • Se corrigió la descripción de las dimensiones relacionadas con time periods para indicar que el valor de la dimensión se refiere al período que comienza a las 12:00 a.m. 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 es UTC-7 o UTC-8.

      Aunque las fechas suelen representar un período de 24 horas, las fechas en las que se adelantan los relojes representan un período de 23 horas, y las fechas en las que se retrasan 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 representara un período de 24 horas).

      Ten en cuenta que esta corrección no representa un cambio en el comportamiento real de la API.

    • Se actualizó la documentación de los informes de canales para indicar que, actualmente, estos informes no contienen métricas de ingresos ni de rendimiento de los anuncios. Por lo tanto, el permiso 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 valores de dimensión nuevos:
      • 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 del propietario del contenido.

Este parámetro permite que un propietario del contenido indique que una respuesta de la API debe incluir los datos de vistas y tiempo de reproducción de los canales del período anterior a la vinculación de los canales con el propietario del contenido. El valor predeterminado del parámetro es false, lo que significa que, de forma predeterminada, la respuesta de la API solo incluye los datos de tiempo de reproducción y vistas desde el momento en que los canales se vincularon al 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 devuelven para cualquier canal determinado se basan en la fecha en que ese canal se vinculó al propietario del contenido.

    Es importante recordar que es posible que se hayan vinculado diferentes canales a un propietario del contenido en fechas distintas. Si la solicitud a la API recupera datos de varios canales y el valor del parámetro es false, la respuesta de la API contendrá datos de vistas y tiempo de reproducción según la fecha de vinculación de cada canal.
  • Si el valor del parámetro es true, la respuesta devuelve los datos de vistas y tiempo de reproducció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).

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:

La API de informes de YouTube admite tres informes nuevos de pantallas finales, así como nuevas dimensiones y métricas para esos informes. Los informes proporcionan estadísticas de impresiones y clics para las pantallas finales que se muestran después de que se detiene la reproducción de un video.

  • Informes de pantallas finales

    • El informe de pantallas finales de los videos del canal contiene estadísticas de todos los videos de un canal.
    • El informe de pantallas finales de los videos del propietario del contenido incluye estadísticas de los videos de cualquiera de sus canales.
    • El informe de pantallas finales de los activos del propietario del contenido incluye estadísticas de los activos asociados con los videos después de los cuales se muestran las pantallas finales.

  • Dimensiones de las pantallas finales

  • Métricas de pantallas finales

    Nota: Los datos de las métricas de las pantallas finales están disponibles a partir del 1 de mayo de 2016.

    • En el Centro de ayuda de YouTube, encontrarás información más detallada para agregar pantallas finales a tus videos.

  • Los siguientes informes ya no se admiten 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).

8 de noviembre de 2016

Esta actualización contiene los siguientes cambios en la API de YouTube Analytics:

  • Las métricas de la siguiente lista están completamente obsoletas y ya no se admiten. Como se anunció el 10 de agosto de 2016, ya se admiten las nuevas métricas que hacen 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

27 de octubre de 2016

Ahora, YouTube genera automáticamente un conjunto de informes de ingresos publicitarios 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 administrados por el sistema están diseñados para proporcionar acceso programático a los datos que también están disponibles en los informes de Creator Studio que se pueden descargar de forma manual.

En la descripción general de los informes administrados por el sistema, se proporciona un breve resumen de los informes nuevos y se explica el proceso para recuperarlos a través de la API. Este proceso es un poco diferente del que se usa para 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:

  • Ingresos publicitarios mensuales por video en todo el mundo
  • Ingresos publicitarios diarios por video y por país
  • Ingresos publicitarios mensuales de todo el mundo por activo
  • Ingresos publicitarios diarios por país y por activo
  • Reclamos (este informe no contiene datos de ingresos)

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 contiene el siguiente cambio en la API de YouTube Reporting:

  • El informe content_owner_basic_a1 dejó de estar disponible por completo y se quitó de la documentación. YouTube ya no generará informes nuevos de ese tipo, aunque los que ya se generaron seguirán estando disponibles durante 180 días a partir de la fecha en que se crearon.

    El informe content_owner_basic_a1 se reemplaza por el informe content_owner_basic_a2, como se explica en la entrada del historial de revisiones del 19 de mayo de 2016.

11 de agosto de 2016

Esta actualización incluye los siguientes cambios:

  • Las Condiciones del Servicio de las APIs de YouTube publicadas recientemente ("las Condiciones Actualizadas"), que se analizan en detalle en el Blog de Ingeniería y Desarrolladores de YouTube, proporcionan un amplio conjunto 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 explicar las políticas que deben seguir los desarrolladores.

    El conjunto completo de documentos nuevos se describe en el historial de revisiones de las Condiciones Actualizadas. Además, los cambios futuros en las Condiciones Actualizadas o en esos documentos de respaldo también se explicarán en ese historial de revisiones.

10 de agosto de 2016

Esta actualización incluye los siguientes cambios:

  • API de YouTube Analytics (consultas segmentadas)

    • Nota: Este es un anuncio de baja.

      Las métricas de la siguiente tabla dejarán de estar disponibles. Al mismo tiempo, se están introduciendo nuevas métricas que hacen referencia a los mismos datos. En efecto, esto significa que se cambiarán los nombres de las métricas antiguas, aunque la API de YouTube Analytics admitirá ambos nombres de métricas 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 asistencia
      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 otras métricas, que no eran principales, se admitirán 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étrica cpm o ambas. Sin embargo, después de esa fecha, solo se admitirá la métrica cpm.

    • La dimensión insightTrafficSourceType admite dos valores de dimensión nuevos:
      • CAMPAIGN_CARD: Esta fuente de tráfico solo se admite en los informes del propietario del contenido. Indica que las vistas se originaron en videos reclamados que subieron los usuarios y que el propietario del contenido usó para promocionar el contenido visto.
      • END_SCREEN: Los datos pertenecen 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ón insightTrafficSourceDetail identifica el video desde el que se derivó al usuario.

    • La dimensión adType ahora admite el valor auctionBumperInstream, que hace referencia a un anuncio de video que no se puede omitir, de hasta 6 segundos, que se reproduce antes de que se pueda ver un 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 del propietario del contenido. Indica que las vistas se originaron en videos reclamados que subieron los usuarios y que el propietario del contenido usó para promocionar el contenido visto.
      • 20: Los datos pertenecen a las vistas que se originaron en la pantalla final de otro video.

      En ambas fuentes de tráfico nuevas, la dimensión traffic_source_detail identifica el video desde el que se derivó al usuario.

    • Se corrigió la lista de métricas principales de la API para incluir estimated_partner_revenue como métrica principal y quitar earnings de esa lista. (La métrica earnings nunca se admitió en la API de informes de YouTube).

    • La dimensión ad_type ahora admite el valor 19, que hace referencia a los anuncios bumper, que son anuncios de video que no se pueden omitir, de hasta 6 segundos, que se reproducen antes de que se pueda ver un video.

18 de julio de 2016

Esta actualización incluye los siguientes cambios:

  • API de YouTube Analytics (consultas segmentadas)

    • Se actualizaron las listas de métricas admitidas para 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, y la entrada del historial de revisiones de esa fecha explica el cambio con más detalle. Los informes son los siguientes:
      • Actividad básica del usuario para los estados 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 del usuario según el estado de suscripción
      • Actividad del usuario por estado de suscripción para las provincias
      • Videos más populares por estado
      • Videos más populares entre los usuarios suscritos o no suscritos

    • Se corrigieron las listas de filtros de los informes de retención del público de los canales y de los informes de retención del público de los propietarios del contenido para reflejar que el filtro video es obligatorio y que el filtro group no es compatible.

      Anteriormente, en la documentación de ambos informes, se indicaba de forma incorrecta que el informe se podía recuperar con uno de esos dos filtros o sin ninguno de ellos.

  • 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 genera informes descargables para los días en los que no había datos disponibles. Esos informes contienen una fila de encabezado, pero no datos adicionales. Esta información ya se había actualizado en la sección Características del informe 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 usa la dimensión card_id. Anteriormente, en la documentación, se indicaba de forma incorrecta que el nombre de la dimensión era card_title.

28 de junio de 2016

Se actualizó la documentación de la API de YouTube Analytics para reflejar la compatibilidad con las métricas de tarjetas en numerosos informes de canales y propietarios del contenido. Las métricas que se admiten recientemente son las siguientes:

Las métricas se admiten en los siguientes tipos de informes:

22 de junio de 2016

Esta actualización contiene los siguientes cambios en la API de YouTube Reporting. El primer cambio se relaciona con la API en general, y los cambios restantes solo afectan los informes del propietario del contenido:

  • Se actualizó la sección Características de los informes de la descripción general de la API para aclarar que los informes están disponibles a través de la API durante 180 días a partir del momento en que se generan.

    Anteriormente, en la documentación se indicaba que los informes están disponibles por un período de hasta 180 días antes de la fecha en que se envía la solicitud a la API. Si bien también es técnicamente cierto, el texto original era, en el mejor de los casos, bastante confuso.

  • La API admite versiones nuevas de tres informes. Dos de esos informes también contienen métricas nuevas y con nombres modificados:

    • El informe content_owner_ad_rates_a1 es la versión nueva del informe content_owner_ad_performance_a1. El informe con el nuevo nombre es idéntico a la versión anterior.

    • Se cambiaron los nombres de dos informes que tienen versiones nuevas:

      • La nueva versión del informe content_owner_estimated_earnings_a1 se llama content_owner_estimated_revenue_a1.
      • La nueva versión del informe content_owner_asset_estimated_earnings_a1 se llama content_owner_asset_estimated_revenue_a1.

      Ambos informes con nombres nuevos difieren de sus predecesores de las siguientes maneras:

    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 con nombres nuevos. Junto con el lanzamiento de las nuevas versiones de informes, se dieron de baja los informes content_owner_ad_performance_a1, content_owner_estimated_earnings_a1 y content_owner_asset_estimated_earnings_a1.

    Si tienes trabajos para cualquiera de esos informes, no esperes que YouTube genere informes nuevos para esos trabajos después del 22 de septiembre de 2016. Los informes generados seguirán estando disponibles durante 180 días a partir de la fecha de generación.

  • Se actualizó la definición de la propiedad id del recurso reportType para reflejar el conjunto actual de informes disponibles.

  • Se corrigieron los nombres de dos métricas en la documentación para que coincidan con los que aparecen en los informes. Esta es solo una corrección de la 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 a estimated_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 a estimated_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 a estimated_partner_double_click_revenue. Como mencionamos anteriormente, 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 a estimated_partner_ad_reserved_revenue en las versiones más recientes de esos informes.

  • Se actualizó la documentación de las dimensiones de la API de Reporting para que ya no se incluyan las propiedades elapsed_video_time_percentage y audience_retention_type. Por el momento, estas dimensiones no son compatibles con ningún informe disponible a través de la API.

19 de mayo de 2016

Esta actualización incluye los siguientes cambios en la API de informes de YouTube:

  • La API admite una nueva versión del informe de actividad del usuario para los propietarios del 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étricas likes y dislikes.

    Si ya tienes un trabajo para crear el informe content_owner_basic_a1, de todos modos debes crear un trabajo nuevo para el informe content_owner_basic_a2. YouTube no migrará automáticamente a los propietarios del contenido a la nueva versión del informe ni creará automáticamente un trabajo para generarla. En algunas implementaciones, la aparición de un trabajo nuevo e inesperado podría ser un cambio rotundo.

    Junto con el lanzamiento del nuevo informe, se dejó de estar disponible el informe content_owner_basic_a1. Si tienes un trabajo para ese informe, no esperes que YouTube genere informes nuevos para ese trabajo después del 19 de agosto de 2016. Los informes generados seguirán estando disponibles durante 180 días a partir de la fecha de generación.

  • Los recursos reportType, job y report admiten una propiedad nueva que identifica si el recurso asociado representa un tipo de informe obsoleto:

    • La propiedad deprecateTime del recurso reportType 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 que YouTube dejará de generar informes de ese tipo.

      Después de que se anuncia que un tipo de informe dejará de estar disponible, YouTube genera informes de ese tipo durante otros tres meses. Por ejemplo, en esta actualización del 19 de mayo de 2016, se anuncia la baja del informe content_owner_basic_a1. Por lo tanto, el deprecateTime para ese tipo de informe especifica una hora del 19 de agosto de 2016, después de la cual YouTube dejará de generar informes de ese tipo.

    • La propiedad expireTime del recurso job especifica la fecha y hora en que venció o vencerá el trabajo. 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 marca el momento después del cual YouTube ya no genera informes nuevos para el trabajo.

    • La propiedad jobExpireTime del recurso report especifica la fecha y hora en que venció o vencerá el trabajo asociado con el informe. Esta propiedad contiene el mismo valor que la propiedad expireTime en el recurso job, como se describe en el elemento anterior de esta lista.

  • El método jobs.create ahora devuelve un código de respuesta HTTP 400 (Bad Request) si intentas crear un trabajo para un informe obsoleto. Además, en la documentación del método, ahora se enumeran varios motivos más por los que puede fallar una solicitud a la API.

12 de abril de 2016

Esta actualización contiene los siguientes cambios, que solo afectan a la API de YouTube Reporting:

  • Ahora YouTube genera datos que abarcan el período de 180 días anterior a la primera vez que se programó un trabajo de informe. Anteriormente, la API de informes 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 en cuanto están disponibles, aunque se tarda aproximadamente un mes en publicar todos los datos históricos de un trabajo. Por lo tanto, un mes después de programar un trabajo de informes, tendrás acceso a alrededor de siete meses de datos. (Todos los datos históricos de los trabajos creados antes de este anuncio deben publicarse en el plazo de un mes a partir del anuncio).

    Ten en cuenta que los datos históricos solo están disponibles a partir del 1 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 Características de los informes de la descripción general de la API de YouTube Reporting se actualizó con los siguientes cambios:

    • En la documentación, ahora se indica que los informes están disponibles durante un período de 180 días después de su generación y, por lo tanto, están disponibles para que los clientes de la API los descarguen. Anteriormente, en la documentación se indicaba que los informes estaban disponibles por un período de hasta seis meses antes de la fecha en que se enviaba la solicitud a la API.

    • Se actualizó la documentación para reflejar el hecho de que la API ahora genera informes descargables para los días en los que no había datos disponibles. Esos informes contendrán filas de encabezado, pero no datos adicionales.

  • Pronto, la API de informes de YouTube admitirá un conjunto de informes generados automáticamente y administrados por el sistema que contienen datos de ingresos publicitarios o de ingresos por 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 Creator Studio de YouTube. Por lo tanto, la nueva funcionalidad de la API proporcionará acceso programático a esos datos.

    Los siguientes cambios en la API se anuncian ahora como preparación para el lanzamiento de los informes administrados por el sistema:

    • La nueva propiedad systemManaged del recurso job 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 no pueden modificar ni borrar los trabajos que crean esos informes.

    • El nuevo parámetro includeSystemManaged del método jobs.list indica si la respuesta de la API debe incluir trabajos para los informes administrados por el sistema. El valor predeterminado del parámetro es false.

    • El nuevo parámetro startTimeAtOrAfter del método jobs.reports.list indica que la respuesta de la API solo debe contener informes si los datos más antiguos del informe corresponden a la fecha especificada o a una posterior. Del mismo modo, el parámetro startTimeBefore indica que la respuesta de la API solo debe contener informes si los datos más antiguos del informe son anteriores a la fecha especificada.

      A diferencia del parámetro createdAfter del método, que se relaciona con la hora en que se creó el informe, los parámetros nuevos se relacionan con los datos del informe.

    • La nueva propiedad systemManaged del recurso reportType indica si el recurso describe un informe administrado por el sistema.

    • El nuevo parámetro includeSystemManaged del método reportTypes.list indica si la respuesta de la API debe incluir informes administrados por el sistema. El valor predeterminado del parámetro es false.

28 de marzo de 2016

Las APIs de YouTube Reporting y YouTube Analytics ahora devuelven estadísticas de vistas para varios servicios de uso compartido adicionales.

  • En la API de informes de YouTube, la dimensión sharing_service admite estos valores nuevos:
    • 82: Diálogo de actividad del sistema de iOS
    • 83: Google Inbox
    • 84: Android Messenger
  • En la API de YouTube Analytics, la dimensión sharingService admite estos valores nuevos:
    • ANDROID_MESSENGER: Android Messenger
    • INBOX: Google Inbox
    • IOS_SYSTEM_ACTIVITY_DIALOG: Diálogo de actividad del sistema de iOS

16 de marzo de 2016

Esta actualización contiene los siguientes cambios, que afectan tanto a la API de YouTube Reporting como a la API de YouTube Analytics:

API de YouTube Reporting

  • La dimensión playback_location_type admite dos valores de dimensión nuevos:
    • 7: Los datos pertenecen a las vistas que se produjeron en la página principal o la pantalla principal de YouTube, en el feed de suscripciones del usuario o en otra función de exploración de YouTube.
    • 8: Los datos pertenecen 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 admite 18 como valor de dimensión. Este valor indica que las vistas del video se originaron en una página que enumera todos los videos de una playlist. Esta fuente difiere del tipo de fuente 14, que indica que las vistas se produjeron mientras el video se reproducía como parte de una playlist.

API de YouTube Analytics

  • La dimensión insightPlaybackLocationType admite dos valores de dimensión nuevos:
    • BROWSE: Los datos pertenecen a las vistas que se produjeron en la página principal o la pantalla principal de YouTube, en el feed de suscripciones del usuario o en otra función de exploración de YouTube.
    • SEARCH: Los datos pertenecen a las vistas que se produjeron directamente en la página de resultados de búsqueda de YouTube.
  • La dimensión insightTrafficSourceType ahora admite YT_PLAYLIST_PAGE como valor de dimensión. Este valor indica que las vistas del video se originaron en una página que enumera todos los videos de una playlist. Esta fuente difiere del tipo de fuente PLAYLIST, que indica que las vistas se produjeron mientras el video se reproducía como parte de una playlist.

8 de febrero de 2016

Se actualizó la lista de métricas compatibles con la API de YouTube Analytics para que las métricas de tarjetas ya no aparezcan como métricas compatibles con esa API. (Ninguno de los informes de esa API se había documentado como compatible con ninguna de las métricas de la tarjeta).

Ten en cuenta que puedes seguir recuperando las métricas de tarjetas con la API de YouTube Reporting, que admite esas métricas para numerosos informes de canales y propietarios del contenido.

6 de enero de 2016

Las APIs de YouTube Reporting y YouTube Analytics ahora identifican específicamente las vistas que se producen a través de un dispositivo Chromecast.

  • En la API de YouTube Reporting, la dimensión operating_system usa el valor 21 para identificar las vistas que se producen a través de Chromecast.
  • En la API de YouTube Analytics, la dimensión operatingSystem usa el valor CHROMECAST para identificar las vistas que se producen a través de 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 devuelven 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 realicen ciertas divulgaciones y se obtengan los consentimientos de los usuarios finales de la UE. Por lo tanto, para los usuarios finales de la Unión Europea, debes satisfacer la política de consentimiento de los 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 contiene los siguientes cambios, que afectan a la API de YouTube Analytics:

  • La API de YouTube Analytics ahora admite tres nuevas dimensiones de detalles de reproducción, que se pueden usar en una variedad de informes de canales y propietarios de contenido:

    • liveOrOnDemand: Esta dimensión indica si los datos del informe describen la actividad del usuario que se produjo durante una transmisión en vivo.
    • subscribedStatus: Esta dimensión indica si las métricas de actividad del usuario en los datos están asociadas con los usuarios que se suscribieron al canal del video o de 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.

    Se actualizó la documentación para identificar los nuevos informes de detalles de reproducción que están disponibles para los canales y los propietarios del contenido. Además, se actualizaron muchos otros informes para indicar que una o más de estas dimensiones se pueden usar de forma opcional como dimensiones o filtros en esos informes.

  • Se modificó el formato de las tablas que explican los informes para que te resulte más fácil identificar las combinaciones válidas de dimensiones, métricas y filtros que se pueden usar para recuperar cada informe. En la siguiente tabla, se explica el informe "Tipo de dispositivo" para los canales y se muestra el formato nuevo:

    Propiedad Valor
    Dimensiones:
    Obligatorio deviceType
    Usa 0 o más day, liveOrOnDemand, subscribedStatus, youtubeProduct
    Métricas:
    Usa 1 o más views, estimatedMinutesWatched
    Filtros:
    Usa 0 o 1 country, province, continent, subContinent
    Usa 0 o 1 video, group
    Usa 0 o más operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

    La terminología que describe los campos obligatorios y opcionales se explica en la documentación de los informes de canal y propietario del contenido.

  • La API de YouTube Analytics ahora descarta automáticamente las entidades para las que el usuario de la API no puede recuperar datos de los filtros que admiten varios valores (video, playlist y channel). Anteriormente, el servidor de la API solo habría devuelto 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 incluye 20 IDs de video. El usuario es propietario de 18 de los videos. Sin embargo, uno de los IDs de video identifica un video que pertenece a otro canal, y otro ID identifica un video que se borró y, por lo tanto, ya no existe. En este caso, en lugar de devolver 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 pertenecen al usuario de la API.

  • Si solicitas datos para un group de YouTube Analytics vacío, la API ahora devuelve un conjunto de datos vacío en lugar de un error.

  • El método groupItems.insert de la API de YouTube Analytics ahora devuelve un error no autorizado (código de respuesta HTTP 403) si intentas agregar una entidad a un grupo, pero no tienes acceso a ella. Anteriormente, la API te permitía agregar la entidad al grupo, pero luego devolvía un error de falta de autorización cuando intentabas 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ámetro nextPageToken de la respuesta especifica un token que se puede usar para recuperar la siguiente página de resultados. Establece el parámetro pageToken del método en ese valor para recuperar resultados adicionales.

10 de noviembre de 2015

Esta actualización incluye los siguientes cambios:

29 de octubre de 2015

Esta actualización incluye los siguientes cambios:

  • 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 que comienza a 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 fechas (day, 7DayTotals, 30DayTotals y month) se refieren a 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 YouTube Reporting ahora admite el parámetro de consulta createdAfter. 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 se refiere al momento en que se crea el informe y no a las fechas asociadas con los datos devueltos.

    El valor del parámetro es una marca de tiempo en 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 YouTube Reporting para explicar cómo puedes usar el parámetro createdAfter para evitar procesar el mismo informe de forma repetida.

  • Se corrigieron las definiciones de la propiedad createTime del recurso job y las propiedades startTime, endTime y createTime del recurso report para indicar que los valores de la propiedad son precisos en microsegundos, no en nanosegundos. Además, todas las definiciones ahora reflejan con precisión que el valor de la propiedad es una marca de tiempo.

8 de octubre de 2015

Esta actualización incluye los siguientes cambios:

  • Se actualizó la documentación de la dimensión sharingService de la API de YouTube Analytics para incluir una lista de los valores posibles de la dimensión. La lista incluye varios servicios nuevos compatibles.

    También se actualizó la definición de la dimensión sharing_service de la API de YouTube Reporting para incluir los valores admitidos recientemente. Los valores de enumeración que son mayores que 59 son los nuevos de la lista.

24 de septiembre de 2015

Esta actualización incluye los siguientes cambios:

  • La nueva API de YouTube Reporting recupera informes de datos masivos que contienen datos de YouTube Analytics de un canal o propietario del contenido. Está diseñado 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 YouTube Reporting contiene un conjunto predefinido de dimensiones y métricas. (Los informes de la API de YouTube Analytics también usan métricas y dimensiones). En un informe, cada fila de datos tiene una combinación única de valores de dimensión. Puedes agregar datos en las filas según los valores de las dimensiones para calcular las 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 configures un trabajo, YouTube generará un informe diario que se puede descargar de forma asíncrona. Cada informe contiene datos de un período único de 24 horas.

  • Aunque son APIs diferentes, tanto la API de YouTube Analytics como la API de YouTube Reporting permiten que los desarrolladores recuperen datos de YouTube Analytics. Dado que ambas APIs proporcionan acceso a conjuntos de datos similares, la documentación de las dos APIs se publica como un único conjunto de documentación.

    • La pestaña Guías del conjunto de documentación contiene información común para ambas APIs, incluidas las instrucciones para autorizar las solicitudes a la API.
    • La pestaña Informes masivos contiene documentación de referencia y otro contenido específico de la API de YouTube Reporting.
    • La pestaña Consultas segmentadas contiene documentación de referencia y otro contenido específico para la API de YouTube Analytics.
    • En la pestaña Muestras, se enumeran las muestras de código disponibles para cualquiera de las dos APIs.
    • En la pestaña Herramientas, se enumeran los recursos adicionales disponibles para ayudar a los desarrolladores a implementar cualquiera de las dos APIs.

20 de agosto de 2015

Esta actualización incluye los siguientes cambios:

  • Se reestructuró la documentación de la API para que sea más fácil de entender. Por lo tanto, estos cambios no describen funciones nuevas:

    • La documentación ahora contiene una página en la que se enumeran todos los informes de canales disponibles y otra en la que se enumeran todos los informes de propietarios del contenido disponibles. Anteriormente, la documentación tenía páginas separadas para los informes de videos de canales, los informes de playlists de canales, etcétera.

    • La nueva descripción general del modelo de datos busca proporcionar una introducción más clara sobre el funcionamiento de la API. En particular, en este documento se intenta explicar mejor cómo YouTube usa las métricas, las dimensiones y los filtros para calcular los valores de los informes.

    • El método reports.query de la API, que usas para recuperar informes, ahora se documenta por separado. La información de esa página antes estaba en otras páginas. La nueva página está diseñada para ayudarte a identificar con mayor facilidad la información que necesitas enviar para recuperar un informe.

22 de julio de 2015

Esta actualización incluye varios cambios que solo se aplican a los propietarios del contenido:

  • 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étrica adEarnings para cualquier informe que ya admita la métrica earnings.

    Además, se corrigió la definición de la métrica earnings para reflejar el hecho de que su valor incluye los ingresos estimados totales de todas las fuentes de publicidad vendidas por Google, así como de las fuentes que no son de publicidad. Anteriormente, la definición indicaba de forma incorrecta que la métrica solo incluía los ingresos de las fuentes de publicidad.

  • La métrica primaryAdGrossRevenue dejó de estar disponible. En su lugar, usa la métrica grossRevenue para recuperar los datos de ingresos.

  • Además de la métrica primaryAdGrossRevenue obsoleta, los informes de rendimiento de anuncios ya no admiten las métricas monetizedPlaybacks ni playbackBasedCpm. Sin embargo, varios informes de video aún admiten esas métricas.

1 de junio de 2015

Esta actualización incluye los siguientes cambios:

  • La API ahora admite dos métricas nuevas para los informes de video: videosAddedToPlaylists y videosRemovedFromPlaylists. Se actualizaron las listas de informes de video para canales y propietarios del contenido para identificar los informes que admiten las nuevas métricas.

    • videosAddedToPlaylists: Es la cantidad de veces que se agregaron los videos incluidos en el alcance de la consulta a cualquier playlist de YouTube. Es posible que los videos se hayan agregado a la playlist del propietario del video o a las playlists de otros canales.
    • videosRemovedFromPlaylists: Es la cantidad de veces que se quitaron los videos incluidos en el alcance de la consulta de cualquier playlist de YouTube. Es posible que se hayan quitado de la playlist del propietario del video o de las playlists de otros canales.

    Ambas métricas incluyen playlists predeterminadas, como "Ver más tarde". Sin embargo, no se incluyen las playlists a las que se agrega un video automáticamente, como la playlist de cargas de un canal o el historial de reproducciones de un usuario. Ten en cuenta también que estas métricas reflejan la cantidad absoluta de incorporaciones y eliminaciones. Por lo tanto, si un usuario agrega un video a una playlist, lo quita y lo vuelve a agregar, las métricas indicarán que el video se agregó a dos playlists y se quitó de una.

    Los datos de estas métricas están disponibles a partir del 1 de octubre de 2014.

31 de marzo de 2015

Esta actualización incluye los siguientes cambios:

16 de marzo de 2015

Esta actualización incluye los siguientes cambios:

  • El nuevo parámetro currency te permite recuperar las métricas de ingresos en una moneda que no sea dólares estadounidenses (USD). Si se establece el parámetro, la API convierte los valores de las métricas earnings, grossRevenue, playbackBasedCpm y impressionBasedCpm a la moneda especificada. Los valores que se devuelven son estimaciones calculadas con tipos de cambio que varían a diario.

    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.

25 de febrero de 2015

Esta actualización incluye los siguientes cambios:

  • Ahora, la API admite la creación y administración de grupos de YouTube Analytics, así como la recuperación de datos de informes para esos grupos.

    • Crea y administra grupos

      En esta actualización, se presentan los recursos group y groupItem 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étodos list, insert, update y delete para este recurso.
      • El recurso groupItem representa un elemento de un grupo de Analytics. La API admite los métodos list, insert y delete 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étodo groupItems.insert.

    • Recupera datos de informes de un grupo

      Se actualizó la documentación de las dimensiones para incluir la dimensión group, que se puede usar como filtro para muchos informes de canales y de propietarios del contenido. Cuando usas el filtro group, la API devuelve datos de todos los elementos de ese grupo. Ten en cuenta que, por el momento, la API no admite la creación de informes para los grupos de recursos.

    Consulta el Centro de ayuda de YouTube para obtener más información sobre los grupos de YouTube Analytics.

13 de febrero de 2015

Esta actualización incluye los siguientes cambios:

  • La API ya no admite la dimensión show.

28 de agosto de 2014

Esta actualización incluye los siguientes cambios:

  • La API ahora admite la capacidad de especificar varios valores para las dimensiones video, playlist, channel y show cuando esas dimensiones se usan como filtros. Para especificar varios valores, establece el valor del parámetro filters en una lista separada por comas de los IDs de videos, playlists, canales o programas por los que se debe filtrar la respuesta de la API. El valor del parámetro puede especificar hasta 200 IDs.

    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 usará los valores del filtro para agrupar los resultados.

    Consulta la definición del parámetro filters para obtener detalles completos sobre esta funcionalidad.

16 de julio de 2014

Esta actualización incluye los siguientes cambios:

  • Cuando recuperas un informe de canal, ahora puedes recuperar datos del canal del usuario autenticado estableciendo el valor del parámetro ids en channel==MINE. (También puedes establecer el parámetro ids en channel==CHANNEL_ID para recuperar datos del canal especificado).

  • La API ahora admite informes de playlists, que contienen estadísticas relacionadas con las vistas de videos que se producen en el contexto de una playlist. Los informes de playlists están disponibles para los canales y los propietarios del contenido.

    Todos los informes de playlists admiten las métricas views y estimatedMinutesWatched, y algunos también admiten la métrica averageViewDuration.

    Además, todos los informes de playlists admiten las siguientes métricas nuevas. Ten en cuenta que cada una de estas métricas solo refleja las vistas de playlists que se produjeron en la Web.

    • playlistStarts: Es la cantidad de veces que los usuarios iniciaron la reproducción de una playlist.
    • viewsPerPlaylistStart: Es la cantidad promedio de vistas de video que se produjeron cada vez que se inició una lista de reproducción.
    • averageTimeInPlaylist: Es el tiempo promedio estimado, en minutos, que un usuario miró videos de una playlist después de que se inició.

    Cualquier solicitud para recuperar un informe de playlist debe usar el filtro isCurated, que debe establecerse en 1 (isCurated==1).

  • La API ahora admite un informe de retención del público. En este informe, se mide la capacidad de un video para retener a su público. La nueva dimensión elapsedVideoTimeRatio del informe mide la cantidad de video que transcurrió para los valores de métricas correspondientes:

    • La métrica audienceWatchRatio identifica la proporción absoluta de usuarios que miran el video en un momento determinado. La proporción se calcula comparando 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 puede mirar más de una vez (o no mirarse en absoluto) en una vista de video determinada. Por ejemplo, si los usuarios retroceden y miran la misma parte de un video varias veces, el porcentaje absoluto de esa parte del video podría ser superior al 1.

    • La métrica relativeRetentionPerformance muestra qué tan bien un video retiene a los 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 de mediana de 0.5 indica que la mitad de los videos de duración similar retienen mejor a los usuarios, mientras que la otra mitad los retiene peor.

    También puedes usar el filtro audienceType para que el informe solo devuelva datos asociados con vistas orgánicas, vistas de anuncios TrueView in-stream o vistas de anuncios TrueView in-display. (Las vistas orgánicas son el resultado directo de la acción del usuario, como la búsqueda de un video o el 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 antes admitiera las métricas annotationClickThroughRate y annotationCloseRate.

    Todas las métricas nuevas son 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 a partir del 16 de julio de 2013. (Los datos de las métricas annotationClickThroughRate y annotationCloseRate están disponibles a partir del 10 de junio de 2012).

  • GOOGLE_SEARCH ya no se registra como un valor independiente para la dimensión insightTrafficSourceType. En cambio, las referencias de los resultados de la Búsqueda de Google ahora se atribuyen al tipo de fuente de tráfico EXT_URL. Como resultado, tampoco es posible recuperar un informe de insightTrafficSourceDetail que establezca el filtro insightTrafficSourceType en GOOGLE_SEARCH.

31 de enero de 2014

Esta actualización incluye los siguientes cambios:

16 de enero de 2014

Esta actualización incluye los siguientes cambios:

  • Se rediseñó el documento de solicitudes de ejemplo para agrupar los ejemplos en categorías con un formato de pestañas similar al que se lanzó recientemente para los informes de canales y propietarios del contenido. 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
    • Social
    • Ingresos/anuncios (solo para los informes de propietarios del contenido)

  • El documento de solicitudes de muestra ahora incluye ejemplos nuevos para recuperar datos específicos de provincias en los informes de canales o de propietarios del contenido.

    • Métricas específicas de las provincias 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 de 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ámetro filters para restringir la respuesta de modo que solo incluya resultados de Estados Unidos.

    • Datos demográficos de los usuarios en California (grupo etario y género): Este informe recupera estadísticas sobre el grupo etario y el género de los usuarios de California que miraron los videos de un canal o, en el caso de los informes de propietarios del 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, cuando se incluye province en el valor del parámetro dimensions, la solicitud también debe restringir los datos a Estados Unidos incluyendo country==US en el valor del parámetro filters.

6 de enero de 2014

Esta actualización incluye los siguientes cambios:

  • Se rediseñaron los documentos que enumeran los informes de canales y propietarios del 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
    • Social
    • Videos más exitosos

    Cada documento muestra estas categorías como una lista de pestañas, y puedes hacer clic en cualquiera de ellas para ver los informes admitidos en esa categoría.

  • La API ahora admite tres nuevas dimensiones geográficas: province, continent y subContinent.

    • La dimensión province te permite recuperar estadísticas de los estados de EE.UU. y del Distrito de Columbia. La API admite dos usos para esta dimensión:

      • La API admite dos informes que desglosan las estadísticas por estado. Ambos informes están disponibles para canales y propietarios del contenido.

        • El informe de estadísticas principales proporciona varias estadísticas, como los recuentos de vistas y los minutos de reproducción estimados.
        • El informe basado en el tiempo proporciona las mismas estadísticas, pero agrega datos de forma diaria, mensual o de 7 o 30 días.

      • Puedes usar el parámetro de consulta filters para restringir un informe de modo que solo contenga estadísticas de 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ística 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ística de las Naciones Unidas (ONU) que identifica una subregión de un continente. Esta dimensión también solo se puede usar como filtro.

      Como cada subregión solo está asociada con un continente, no es necesario usar también el filtro continent cuando usas el filtro subContinent. (De hecho, la API devolverá un error si una solicitud usa ambas dimensiones).

  • Se corrigió la documentación para que la dimensión insightTrafficSourceDetail no incluya el valor insightTrafficSourceType PROMOTED como un valor de filtro válido.

30 de septiembre de 2013

Esta actualización incluye los siguientes cambios:

  • La API de YouTube Analytics ahora 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 métricas para incluir las dimensiones y métricas principales. Además, se actualizaron las definiciones de esas páginas para identificar explícitamente las dimensiones y métricas principales.

  • La API ahora admite EXTERNAL_APP como valor para la dimensión insightPlaybackLocationType. Junto con esta actualización, a partir del 10 de septiembre de 2013, las reproducciones ya no se clasifican como reproducciones de MOBILE, aunque las reproducciones en dispositivos móviles que se hayan producido antes de esa fecha se seguirán clasificando con ese valor.

    Con esta actualización, las reproducciones en dispositivos móviles ahora se clasifican como reproducciones de WATCH, EMBEDDED o EXTERNAL_APP, según el tipo de aplicación en la que se producen.

  • La API ahora admite PLAYLIST como valor para la dimensión insightTrafficSourceType. El valor indica que las vistas de video se derivaron de una playlist. Anteriormente, estas vistas se habrían clasificado con la categoría YT_OTHER_PAGE de la dimensión.

16 de julio de 2013

Esta actualización incluye los siguientes cambios:

  • 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 la fuente de tráfico y tiene un valor de parámetro sort de day,-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 y operatingSystem, 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 los recuentos de vistas y el tiempo de reproducción estimado para diferentes tipos de dispositivos, como computadoras de escritorio, dispositivos móviles y tablets. También puedes usar el filtro operatingSystem para restringir el informe de tipo de dispositivo de modo que solo contenga estadísticas de los dispositivos que ejecutan un sistema operativo específico, como Android o iOS.

    • El informe operatingSystem te permite recuperar los recuentos de vistas y el tiempo de reproducción estimado para diferentes sistemas operativos, como Android, iOS, Linux y muchos más. También puedes usar el filtro deviceType para restringir el informe de sistemas operativos de modo que solo contenga 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 devolver el valor YT_OTHER, que identifica las vistas que no se clasifican con uno de los otros valores de la dimensión.

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:

  • La API ahora admite la capacidad de recuperar métricas de tiempo de reproducción (estimatedMinutesWatched, averageViewDuration y averageViewPercentage) junto con otras métricas, incluidas las de vistas, participación, ingresos y rendimiento de los 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 usan las dimensiones insightPlaybackLocationDetail y insightTrafficSourceDetail se mejoraron de las siguientes maneras:

    • Ahora admiten un filtro country opcional.

    • Ahora, los propietarios del contenido pueden recuperar estos informes con cualquiera de las siguientes combinaciones nuevas de filter. Ten en cuenta que todas estas combinaciones también admiten el filtro opcional country.

      • 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

3 de mayo de 2013

Esta actualización incluye los siguientes cambios:

  • El nuevo documento Sample API requests proporciona ejemplos que demuestran cómo recuperar muchos tipos diferentes de informes con la YouTube Analytics API. Cada ejemplo incluye una breve descripción del informe que recupera la solicitud y, luego, muestra las dimensiones, las métricas, los filtros y los parámetros de ordenamiento de la solicitud.

  • La dimensión insightTrafficSourceType ahora admite SUBSCRIBER como un 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 filtras según esta fuente de tráfico, el campo insightTrafficSourceDetail especificará el feed de la página principal o cualquier otra página desde la que se derivaron las vistas.

28 de marzo de 2013

Esta actualización incluye los siguientes cambios:

  • La API ahora admite dos métricas nuevas, annotationClickThroughRate y annotationCloseRate, que se relacionan con las interacciones de los usuarios con las anotaciones que se muestran durante tus videos. Se actualizaron las listas de informes de canales y de propietarios del contenido para identificar los informes que admiten las nuevas métricas.

    • annotationClickThroughRate: Es la proporción entre las anotaciones en las que los usuarios hicieron clic y la cantidad total de impresiones de anotaciones en las que se puede hacer clic.
    • annotationCloseRate: Es la proporción de anotaciones que cerraron los usuarios en relación con la cantidad total de impresiones de anotaciones.

21 de marzo de 2013

Esta actualización incluye los siguientes cambios:

  • La API ahora admite métricas de ingresos y 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: Son los ingresos estimados totales de todas las fuentes de publicidad vendidas por Google.
      • grossRevenue: Son los ingresos brutos estimados de los socios de Google o DoubleClick.
      • primaryAdGrossRevenue: Son los ingresos brutos estimados, sumados y clasificados según el tipo de anuncio principal para las reproducciones de video que abarca el informe, de los socios de Google o DoubleClick.
      • monetizedPlaybacks: Es la cantidad de reproducciones en las que se mostró, al menos, una impresión de anuncio.
      • playbackBasedCpm: Son los ingresos brutos estimados por cada mil reproducciones.
      • impressions: Es la cantidad de impresiones de anuncios verificadas que se publicaron.
      • impressionBasedCpm: Son los ingresos brutos estimados por cada mil impresiones de anuncios.

      Nota: Consulta las definiciones de las métricas para obtener más información.

    • Cualquier solicitud que recupere métricas de ingresos o de rendimiento de los 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.

4 de febrero de 2013

Esta actualización incluye los siguientes cambios:

  • La guía de referencia de la API ahora tiene una sección de ejemplos, que incluye muestras de código que demuestran cómo llamar a la API con las bibliotecas cliente de Java, JavaScript, Python y Ruby. La muestra de código de JavaScript es la misma que se analiza en detalle en la documentación de la aplicación de ejemplo.

14 de noviembre de 2012

Esta actualización incluye los siguientes cambios:

  • La guía de referencia de la API ahora incluye el APIs Explorer, que te permite llamar a la API, ver la solicitud a 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 métricas también se actualizaron según corresponda.

    • 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 agregar datos de un período específico (un día, los últimos siete días, los últimos 30 días, etcétera) o de un país. Si un informe agrega datos por día o país, también puede especificar la duración promedio de cada vista de video, así como el porcentaje promedio de cada video que miraron los usuarios.

2 de octubre de 2012

Esta actualización incluye los siguientes cambios:

  • La YouTube Analytics API ya está disponible para todos los desarrolladores. Puedes activar la API para tu proyecto, sin tener que solicitar acceso primero, desde el panel Servicios en APIs console.

  • En la nueva sección Cómo comenzar, se describen los requisitos previos y los pasos básicos para compilar una aplicación que use la YouTube Analytics API.

12 de septiembre de 2012

Esta actualización incluye los siguientes cambios:

  • 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 la API calcula un costo de consulta para cada solicitud, y ese 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.

  • Se actualizó la sección Dimensiones temporales para explicar que esas dimensiones indican que un informe de Analytics debe agregar datos según un período. La API ahora admite las siguientes dimensiones temporales adicionales:

    • 7DayTotals: Los datos del informe se agregarán de modo que cada fila contenga datos de un período de siete días.
    • 30DayTotals: Los datos del informe se agregarán de modo que cada fila contenga datos de un período de 30 días.
    • month: Los datos del informe se agregará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.

  • Se actualizó la sección Dimensiones de la entidad de informes para indicar que las solicitudes a la API para recuperar informes de propietarios de contenido deben filtrar los datos con una de estas dimensiones (video, channel o show) o una combinación admitida de las dimensiones claimedStatus y uploaderType.

  • 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 métricas subscribersGained y subscribersLost para explicar que un canal puede ganar o perder suscriptores en varios lugares, como la página de reproducción de videos, la página del canal 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.