Historial de revisión

Esta página enumera los cambios y las actualizaciones de la documentación de la API para la API de informes de YouTube y la API de YouTube Analytics. Ambas API permiten que los desarrolladores accedan a los datos de YouTube Analytics, aunque de diferentes maneras. Suscríbete a este registro de cambios. Suscribirse

15 de diciembre de 2022

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

  • Un nuevo informe proporciona la actividad de los usuarios por ciudad. Este informe está disponible para canales y propietarios de contenido. Este informe contiene la nueva dimensión city, que identifica la estimación de YouTube sobre la ciudad donde ocurrió la actividad del usuario.

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

    Se admite la dimensión creatorContentType como una dimensión opcional para todos los informes de video del propietario del contenido y del canal.

  • Ahora, la guía de solicitudes de muestra de la API de YouTube Analytics 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

La API de YouTube Analytics (consultas de segmentación) y la API de informes de YouTube (informes masivos) admiten un nuevo valor de detalles de la fuente de tráfico:

  • En la API de YouTube Analytics (consultas de segmentación), 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 informes de YouTube (informes masivos), si el valor de la dimensión traffic_source_type es 3, el valor traffic_source_detail se puede establecer en podcasts, lo que indica que el tráfico se refirió desde la página de destino de Podcasts.

11 de febrero de 2022

El conjunto de valores válidos para la dimensión gender cambiará el 11 de agosto de 2022 o después de esa fecha. Este puede ser un cambio incompatible con versiones anteriores en tu implementación de API. De acuerdo con la sección Cambios incompatibles con las versiones anteriores de las Condiciones del Servicio de los servicios de la API de YouTube, este cambio se anunciará seis meses antes de que entre en vigor. Actualiza tu implementación de API antes del 11 de agosto de 2022 para garantizar una transición sin inconvenientes al nuevo conjunto de valores.

Los cambios específicos que se realizan son los siguientes:

  • En la API de YouTube Analytics (consultas objetivo), por el momento, la dimensión gender 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 admite actualmente 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 clips en bucle desde el 13 de diciembre de 2021. Este cambio afecta a la API de YouTube Analytics (consultas de segmentación) y a la API de informes de YouTube (informes masivos).

2 de febrero de 2022

Esta API de informes de YouTube (informes masivos) admite un nuevo valor de dimensión de fuente de tráfico que indica que las vistas se originaron desde Live Redirect:

  • En la API de informes de YouTube (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 hizo referencia al espectador.

23 de septiembre de 2020

Tanto la API de YouTube Analytics (consultas objetivo) como la API de informes masivos de YouTube (informes masivos) admiten un nuevo valor de dimensión de fuente de tráfico que indica que el usuario se refirió de forma vertical en la experiencia de visualización de YouTube Shorts:

  • En la API de YouTube Analytics (consultas de segmentación), la dimensión insightTrafficSourceType admite el valor SHORTS.
  • En la API de informes de YouTube (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 informes de YouTube) no se propaga para este nuevo tipo de fuente de tráfico.

20 de julio de 2020

Esta actualización abarca dos cambios que afectan a la API de YouTube Analytics (consultas objetivo):

  • 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 al recuperar 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 ID que se pueden especificar para esos filtros aumentó de 200 a 500 ID.

13 de febrero de 2020

Esta actualización contiene los siguientes cambios relacionados con la API de YouTube Analytics (consultas de segmentación) y la API de informes de YouTube (informes masivos). Puedes obtener más información sobre estos cambios en el Centro de ayuda de YouTube.

En ambas API, cambiará el conjunto de posibles valores de detalles de la fuente de tráfico para las notificaciones. En las consultas de orientación, 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: Vistas provenientes de notificaciones push enviadas a los suscriptores cuando se subió un video.
  • uploaded_other: Las vistas se originaron a partir de notificaciones que no son de envío, como notificaciones por correo electrónico o de Inbox, que se envían a los suscriptores cuando se sube un video.

Estos valores se muestran para el intervalo de tiempo que comienza el 13/01/2020 (13 de enero de 2020).

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

15 de octubre de 2019

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

  • Nota: Este es un anuncio de baja.

    YouTube quitará la compatibilidad con las dimensiones 7DayTotals y 30DayTotals. Puede recuperar los datos de 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 si hacen una consulta con la dimensión day y agregan o derivan datos durante períodos de siete o 30 días. Por ejemplo:

    • Para calcular la cantidad de vistas de un período de siete días, se suma la cantidad de vistas de cada día de ese período.
    • El porcentaje de espectadores de un período de siete días se puede calcular multiplicando la cantidad de vistas que se produjeron por día por el porcentaje de espectadores de ese día para obtener la cantidad de usuarios que accedieron cuando miraron el video ese día. Luego, se puede agregar la cantidad de usuarios que accedieron a su cuenta por todo el período y dividirla por la cantidad total de vistas de ese período para obtener el porcentaje de espectadores del período completo.
    • El número de espectadores únicos para un período de siete días no se puede calcular, ya que el mismo usuario se puede calcular como un usuario único en días diferentes. 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 en función de la fecha de inicio y de finalización especificada.

27 de junio de 2019

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

  • Debido a que la versión 1 de la API dejó de estar disponible, la documentación se actualizó para quitar las referencias a esa versión, incluidos 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 incluye los siguientes cambios relacionados con la API (consultas de orientación) de YouTube Analytics:

  • La versión 1 de la API dejó de estar disponible. Si aún no lo has hecho, actualiza tus clientes de API para que usen la versión 2 de la API lo antes posible a fin de minimizar las interrupciones del servicio. Consulta la guía de migración para obtener más detalles.

    Tenga en cuenta que el programa para esta baja se anunció originalmente el 26 de abril de 2018.

17 de septiembre de 2018

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

  • En la nueva sección Anonimización de datos del documento de descripción general Modelo de datos, se explica que algunos datos de YouTube Analytics están limitados cuando las métricas no cumplen con un umbral determinado. Esto puede suceder en varios casos. En la práctica, significa que un informe puede no contener todos (o ninguno) de sus datos si:

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

      o

    2. Seleccionó un filtro o una dimensión, como una fuente de tráfico o un país, para los que los valores no cumplen con un límite determinado.

    En la nueva sección también se incluye un análisis de los tipos de datos que se pueden limitar en los informes de YouTube Analytics.

  • Los documentos de informes de canales e informes de propietarios de contenido se actualizaron para reflejar el hecho de que las métricas redViews y estimatedRedMinutesWatched ya no son compatibles con los informes de ubicación de reproducción, fuente de tráfico y tipo de dispositivo/sistema operativo.

18 de junio de 2018

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

  • Cambiaron los requisitos de alcance para los siguientes métodos:
    • Las solicitudes al método reports.query deben tener acceso al alcance https://www.googleapis.com/auth/youtube.readonly.
    • Las solicitudes al método groupItems.list deben tener acceso a las siguientes opciones:
      • El permiso de 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 utiliza un alcance, que es un permiso de lectura y escritura, mientras que la segunda opción utiliza dos alcances de solo lectura.

23 de mayo de 2018

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

22 de mayo de 2018

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

  • Actualmente, se implementaron los siguientes cambios para julio de 2018, y las nuevas políticas se aplican de forma global a todos los informes y trabajos de informes.

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

      Antes de este anuncio, todos los informes de la API estaban disponibles durante 180 días desde el momento en que se generaron. Para que quede claro, cuando entre en vigencia este cambio en la política, tampoco se podrá acceder a los informes de datos históricos que tengan más de 30 días de antigüedad a través de la API. Tampoco podrá acceder a los demás informes que tengan más de sesenta días. Como tal, ahora la documentación indica que los informes creados antes del cambio de política estarán disponibles durante hasta 180 días.

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

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

  • La sección Características del informe se actualizó para tener en cuenta que aunque los datos del informe no se filtran, los informes que contienen datos para un período de tiempo a partir del 1 de junio de 2018 no contendrán ninguna referencia a los recursos de YouTube que se hayan borrado al menos 30 días antes de la fecha en que se generó el informe.

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

  • La sección de datos de reabastecimiento de la descripción general de la API se actualizó para definir los datos de reabastecimiento con mayor claridad como un conjunto de datos que reemplaza un conjunto publicado previamente.

26 de abril de 2018

La versión 2 de la API de YouTube Analytics (consultas objetivo) ahora está disponible de forma pública. 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 v2 es casi idéntica a la API v1. Sin embargo, es probable que deba actualizar su código para reflejar los cambios que se mencionan 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.
    • Varios parámetros para el método reports.query tienen nombres actualizados. Específicamente, los nombres de parámetros que contienen guiones, como end-date en la API v1, usan mayúsculas y minúsculas (endDate) en lugar de guiones en la API v2. Este cambio hace que los nombres de parámetros sean coherentes en toda la API, ya que los métodos de la API a fin de crear y administrar grupos ya usan mayúsculas y minúsculas para los nombres de parámetros.
    • La API v2 no admite solicitudes por lotes enviadas al extremo global de lotes HTTP 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 API no son compatibles con la v2:

    • El método reports.query ya no admite los parámetros de solicitud alt, quotaUser y userIp.
    • La API v2 no proporciona un extremo por lotes que admita lotes compuestos por solicitudes a diferentes API. (Sin embargo, un lote puede estar compuesto por solicitudes a diferentes métodos de la misma API). Esta baja no es específica de la API de YouTube Analytics, ya que Google dará de baja el extremo por lotes global en todas sus API.
    • La API v2 no es compatible con el protocolo JSON-RPC, que es compatible con la API v1. Una vez más, 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) dejó de estar disponible y será compatible hasta el 31 de octubre de 2018. Todas las solicitudes a la API v1 dejarán de funcionar después de esa fecha. Por lo tanto, asegúrate de actualizar a la API v2 antes del 31 de octubre de 2018 para evitar cualquier interrupción 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 incluye los siguientes cambios en la API de YouTube Analytics (consultas de segmentación):

  • Los informes demográficos de usuarios, que recopilan estadísticas de reproducción según la edad y el género de los espectadores, ya no admiten la dimensión youtubeProduct, que identifica el servicio de YouTube en el que se produjo la actividad del usuario.

18 de enero de 2018

Esta actualización incluye los siguientes cambios:

  • API de informes de YouTube (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 de segmentación)

20 de diciembre de 2017

Esta actualización incluye 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 es compatible con otros tipos de solicitudes a la API. Si habilitas la compresión gzip, se reduce el ancho de banda necesario para cada respuesta de la API. Si bien tu aplicación necesitará más tiempo de CPU para descomprimir las respuestas de la API, el beneficio de consumir menos recursos de red generalmente supera ese costo.

    Para recibir una respuesta codificada en gzip, configura el encabezado de 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 a fin de mostrar los valores reales que muestra 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 etario, 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 en FEMALE, MALE y GENDER_OTHER.

10 de agosto de 2017

El 10 de agosto de 2016, esta documentación anunciaba la baja de la métrica earnings de la API de YouTube Analytics. (Al mismo tiempo, la API agregó compatibilidad con una métrica nueva, llamada estimatedRevenue, que proporciona los mismos datos).

Dado que la métrica earnings era una métrica principal, se admitió por un año a partir de la fecha del anuncio. Sin embargo, ahora que finalizó ese período, ya no se admite la métrica earnings. Como resultado, las solicitudes a la API que especifican la métrica earnings ahora muestran un código de respuesta HTTP 400. Si aún no actualizaste tu app para 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 de segmentación)

    • La documentación de la API se actualizó para reflejar el hecho de que las respuestas de la API contienen datos hasta el último día 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 incluyan datos en la respuesta. (Esto se aplica 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 y que se reproduce antes de que se pueda ver un video. El formato del anuncio es idéntico al anuncio auctionBumperInstream, pero este tipo se refiere a los anuncios vendidos según las reservas y no a través de subastas.

  • API de informes de YouTube (informes masivos)

    • La dimensión ad_type ahora admite el valor 20, que hace referencia a los anuncios bumper que se venden mediante reserva. Los bumpers publicitarios son anuncios de video de hasta 6 segundos que no se pueden omitir y se reproducen antes de que se pueda ver un video. Tenga en cuenta que el valor 19 para esta dimensión también se refiere a los bumpers publicitarios que se venden en una subasta en lugar de una reserva.

    • Se borraron los trabajos de informes de 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 generarán informes para esos tipos después del 15 de diciembre de 2016. Los informes generados anteriormente estaban disponibles durante 180 días desde el momento en que se crearon. Por lo tanto, algunos informes estuvieron disponibles a partir del 15 de junio de 2017. Sin embargo, debido a que los informes ya no están disponibles, tampoco se necesitan los trabajos asociados con ellos.

24 de mayo de 2017

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

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

Estos tipos de informes se anunciaron como obsoletos el 22 de junio de 2016, y los informes ya no se generaron para esos tipos de informes después del 22 de septiembre de 2016. Los informes generados anteriormente estaban disponibles durante 180 días desde el momento en que se crearon. Por lo tanto, algunos informes fueron accesibles hasta el 22 de marzo de 2017. Sin embargo, debido a que los informes ya no están disponibles, tampoco se necesitan los trabajos asociados con ellos.

22-mayo-2017

Esta actualización incluye los siguientes cambios:

  • API de informes de YouTube (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 ningún cambio en el comportamiento de la API ni en la clasificación de los videos compartidos con estos servicios.

  • API de YouTube Analytics (consultas de segmentación)

    • 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 los 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 informes de YouTube (informes masivos)

    • Se corrigió la definición de la dimensión date a fin de 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 termina a las 11:59 p.m. (hora del Pacífico) del día, mes y año especificados. Según la época del año, la hora del Pacífico puede ser UTC-7 o UTC-8.

      Si bien las fechas suelen representar un período de 24 horas, las fechas en las que los relojes se ajustan hacia adelante representan un período de 23 horas, y las fechas en las que los relojes se retroceden representan un período de 25 horas. (Antes, la documentación establecía 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 del tipo content_owner_basic_a1. Ese tipo de informe dejó de estar disponible por completo el 19 de agosto de 2016, pero los informes content_owner_basic_a1 generados anteriormente estaban disponibles durante 180 días desde el momento en que se crearon. Por lo tanto, algunos informes estuvieron disponibles hasta el 19 de febrero de 2017. Sin embargo, debido a que los informes ya no están disponibles, tampoco se necesitan los trabajos asociados con ellos.

  • API de YouTube Analytics (consultas de segmentación)

    • La descripción de las dimensiones relacionadas con time periods se corrigió para tener en cuenta 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 que termina a las 11:59 p.m. hora del Pacífico del día, mes y año especificados. Según la época del año, la hora del Pacífico puede ser UTC-7 o UTC-8.

      Si bien las fechas suelen representar un período de 24 horas, las fechas en las que los relojes se ajustan hacia adelante representan un período de 23 horas, y las fechas en las que los relojes se retroceden representan un período de 25 horas. (Antes, la documentación establecía 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 informes de canal a fin de indicar que, actualmente, los informes de canal no contienen métricas de ingresos ni de rendimiento de los anuncios. Como resultado, 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 es compatible con el parámetro opcional include-historical-channel-data. Ten en cuenta que este parámetro solo es relevante cuando se recuperan informes de propietarios de contenido.

El parámetro le permite al propietario del contenido indicar que una respuesta de la API debe incluir el tiempo de reproducción de los canales y los datos de visualización del período anterior a cuando los canales se vincularon al propietario del contenido. El valor del parámetro predeterminado es false, lo que significa que, de forma predeterminada, la respuesta de la API solo incluye el tiempo de reproducción y los datos de visualización desde el momento en que los canales se vincularon al propietario del contenido.

Estas reglas también se aplican si la solicitud a la API recupera datos para varios canales:

  • Si el valor del parámetro es false, los datos del tiempo de reproducción y las vistas que se muestran para cualquier canal se basan en la fecha en la que ese canal se vinculó al propietario del contenido.

    Es importante recordar que diferentes canales pueden haberse vinculado a un propietario del contenido en fechas diferentes. Si la solicitud a la API recupera datos de varios canales y el valor del parámetro es false, la respuesta de la API contendrá datos sobre el tiempo de reproducción y las vistas según la fecha de vinculación de cada canal respectivo.
  • Si el valor del parámetro es true, la respuesta muestra el tiempo de reproducción y los datos de visualización de todos los canales según las fechas de inicio y finalización especificadas en la solicitud a la API.

15 de diciembre de 2016

Los siguientes informes de la API de informes de YouTube ya no son compatibles y se eliminaron de la documentación. Está disponible una versión más reciente de cada informe. (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 nuevos informes de pantalla final, así como nuevas dimensiones y métricas para esos informes. Los informes proporcionan estadísticas de impresiones y clics para las pantallas finales que se muestran después de que se detiene la reproducción de un video.

    • Informes de pantallas finales

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

    • Dimensiones de la pantalla final

    • Métricas de pantalla final

      Nota: Los datos de las métricas de las pantallas finales están disponibles desde el 1 de mayo de 2016.

      • El Centro de ayuda de YouTube contiene más información detallada sobre cómo agregar pantallas finales a tus videos.

    • Los siguientes informes ya no son compatibles y se quitaron de la documentación. Está disponible una versión más reciente de cada informe. (El anuncio de baja de estos informes se realizó el 22 de junio de 2016).

    8 de noviembre de 2016

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

    • Las métricas de la siguiente lista dejaron de estar disponibles por completo y ya no son compatibles. Tal 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 nuevo nombre de la métrica:

      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 por anuncios administrados por el sistema para los propietarios de contenido que tienen acceso a los informes correspondientes en la sección Informes de Creator Studio de YouTube. Los informes nuevos de la API administrada por el sistema están diseñados para proporcionar acceso programático a los datos que también están disponibles en los informes descargables de Creator Studio manualmente.

    La descripción general de informes administrados por el sistema proporciona una breve descripción general de los nuevos informes y explica el proceso para recuperarlos a través de la API. Este proceso es ligeramente diferente a la recuperación de informes masivos para 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 informes administrados por el sistema a los que puedes acceder a través de la API:

    • Ingresos mensuales por anuncios en todo el mundo por video
    • Ingresos publicitarios diarios por video y por país
    • Ingresos publicitarios mensuales por elemento en todo el mundo
    • Ingresos diarios por anuncio y por país
    • 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 contiene 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 informes de YouTube:

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

      El reemplazo del informe content_owner_basic_a1 es el informe content_owner_basic_a2, como se explica en la entrada del historial de revisión del 19 de mayo de 2016.

    11 de agosto de 2016

    Esta actualización incluye los siguientes cambios:

    • Las Condiciones del Servicio de la API de YouTube publicadas recientemente ("Condiciones actualizadas"), que se analizan en detalle en el Blog de ingeniería y desarrolladores de YouTube, proporcionan un amplio conjunto de actualizaciones para las Condiciones del servicio actuales. Además de las Condiciones actualizadas, que entrarán en vigencia el 10 de febrero de 2017 y se incluyen varios documentos de respaldo para explicar las políticas que deben cumplir los desarrolladores.

      El conjunto completo de documentos nuevos se describe en el historial de revisión de las Condiciones actualizadas. Además, los cambios futuros que se realicen en las Condiciones actualizadas o en los documentos de respaldo también se explicarán en ese historial de revisión. Puedes suscribirte a un feed RSS que muestra los cambios de ese historial de revisión mediante un vínculo del documento.

    10 de agosto de 2016

    Esta actualización incluye los siguientes cambios:

    • API de YouTube Analytics (consultas de segmentación)

      • Nota: Este es un anuncio de baja.

        Las métricas de la siguiente tabla dejarán de estar disponibles. Al mismo tiempo, incorporamos nuevas métricas que hacen referencia a los mismos datos. En efecto, esto significa que se cambiará el nombre de las métricas anteriores, aunque la API de YouTube Analytics admitirá ambos nombres de métrica hasta las fechas de baja que aparecen 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 métricas principales, se admitirán por 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 de propietarios de contenido. Indica que las reproducciones se originaron a partir de videos reclamados y subidos por el usuario que el propietario del contenido usó para promocionar el contenido visto.
        • END_SCREEN: Los datos corresponden a las vistas que se originaron en la pantalla final de otro video.

        Para ambas fuentes de tráfico nuevas, también puedes recuperar un informe de traffic source detail. En ambos casos, la dimensión insightTrafficSourceDetail identifica el video del cual se recomendó el 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 y que se reproduce antes de que se pueda ver un video.

    • API de informes de YouTube (informes masivos)

      • La dimensión traffic_source_type ahora admite los siguientes valores:
        • 19: Esta fuente de tráfico solo se admite en los informes de propietarios de contenido. Indica que las reproducciones se originaron a partir de videos reclamados y subidos por el usuario que el propietario del contenido usó para promocionar el contenido visto.
        • 20: Los datos corresponden a las vistas que se originaron en la pantalla final de otro video.

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

      • Se corrigió la lista de métricas principales de la API a fin de que incluya estimated_partner_revenue como una métrica principal y para quitar la earnings de esa lista. (la métrica earnings nunca ha sido compatible con 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 y que duran hasta 6 segundos y 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 de segmentación)

      • Las listas de métricas admitidas de los siguientes informes de canal se actualizaron para incluir las métricas de tarjetas. La compatibilidad con las métricas de tarjetas de los informes se agregó el 28 de junio de 2016, y la entrada del historial de revisión para esa fecha explica el cambio con más detalle. Los informes son los siguientes:
        • Actividad básica de 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 por estado de suscripción
        • Actividad del usuario por estado de suscripción para provincias
        • Videos más populares por estado
        • Videos más populares de usuarios suscritos o no suscritos

      • Las listas de filtros se corrigieron para los informes de retención de público del canal y los informes de retención de público del propietario del contenido para reflejar que el filtro video es obligatorio y que el filtro group no es compatible.

        Anteriormente, en la documentación de los dos informes se establecía incorrectamente que el informe podía recuperarse usando uno de esos dos filtros o ninguno de los dos.

    • API de informes de YouTube (informes masivos)

      • En la descripción general de la API, la sección donde se explica cómo recuperar la URL de descarga de un informe se corrigió para indicar que YouTube genera informes descargables para los días en los que no hay datos disponibles. Esos informes contienen una fila de encabezado, pero no contienen datos adicionales. Esta información ya se había actualizado en la sección Características del informe del mismo documento el 12 de abril de 2016.
      • La lista de dimensiones del informe content_owner_asset_cards_a1 se corrigió para reflejar que el informe usa la dimensión card_id. Anteriormente, en la documentación, el nombre de dimensión era incorrectamente card_title.

    28 de junio de 2016

    La documentación de la API de YouTube Analytics se actualizó para reflejar la compatibilidad con las métricas de tarjetas en numerosos informes de canales y propietarios de contenido. Estas son las métricas admitidas:

    Las métricas son compatibles con los siguientes tipos de informes:

    22 de junio de 2016

    Esta actualización contiene los siguientes cambios en la API de informes de YouTube. El primer cambio afecta a la API en general y los cambios restantes solo afectan a los informes de propietarios de contenido:

    • La sección Características del informe de la descripción general de la API se actualizó para aclarar que los informes están disponibles mediante la API durante 180 días desde el momento en que se generan.

      Anteriormente, la documentación establecía que los informes estaban disponibles por un período de hasta 180 días antes de la fecha en que se enviara la solicitud a la API. Si bien técnicamente es verdadero, 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 a las que se les cambió el nombre:

      • El informe content_owner_ad_rates_a1 es la versión nueva del informe content_owner_ad_performance_a1. El informe que acabas de cambiar de nombre es idéntico a la versión anterior.

      • Se cambió el nombre de dos informes que tienen versiones nuevas:

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

        Ambos informes, cuyo nombre se cambió recientemente, difieren de sus antecesores de las siguientes maneras:

      Ten en cuenta que, si ya tienes trabajos para crear cualquiera de las versiones anteriores de estos informes, debes crear trabajos nuevos para los informes con nombre nuevo. Además de la actualización de las nuevas versiones de informes, content_owner_ad_performance_a1, content_owner_estimated_earnings_a1 y content_owner_asset_estimated_earnings_a1 dejaron de estar disponibles.

      Si tienes trabajos para alguno de esos informes, no esperarás que YouTube genere informes nuevos para ellos después del 22 de septiembre de 2016. Los informes generados seguirán estando disponibles durante 180 días desde el momento en que se generen.

    • 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 nombres que aparecen en los informes. Esto es solo una corrección de la documentación y no refleja un cambio en el contenido real del informe:

      • El nombre de la métrica estimated_partner_adsense_revenue se actualizó 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, el nombre de esta métrica se cambió por estimated_partner_ad_auction_revenue en las versiones más recientes de esos informes.
      • El nombre de la métrica estimated_partner_doubleclick_revenue se actualizó a estimated_partner_double_click_revenue. Nuevamente, tenga 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, el nombre de esta métrica se cambió por estimated_partner_ad_reserved_revenue en las versiones más recientes de esos informes.

    • Se actualizó la documentación sobre dimensiones de la API de informes para que deje de mostrar las propiedades elapsed_video_time_percentage y audience_retention_type. Actualmente, estas dimensiones no son compatibles con los informes disponibles a través de la API.

    19-mayo-2016

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

    • La API admite una nueva versión del informe de actividad del usuario para propietarios de contenido. El ID del tipo de informe nuevo es content_owner_basic_a2. A diferencia de la versión anterior del informe, content_owner_basic_a1, la versión nueva admite las métricas likes y dislikes.

      Si ya tienes un trabajo a fin de crear el informe content_owner_basic_a1, debes crear un trabajo nuevo para el informe content_owner_basic_a2. YouTube no migra automáticamente a los propietarios del contenido a la nueva versión del informe ni crea un trabajo automáticamente para generar la nueva versión del informe. En algunas implementaciones, la apariencia de un nuevo trabajo inesperado puede ser un cambio rotundo.

      Junto con el lanzamiento del informe nuevo, el informe content_owner_basic_a1 quedó obsoleto. Si tienes un trabajo en este informe, no esperarás 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 desde el momento en que se generen.

    • 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 representa la fecha en la que YouTube dejará de generar informes de ese tipo.

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

      • La propiedad expireTime del recurso job especifica la fecha y hora en que el trabajo venció o vencerá. Esta propiedad tiene un valor si el tipo de informe asociado con el trabajo dejó de estar disponible o si los informes que se generaron para el trabajo no se descargaron durante un período prolongado. La fecha indica el momento en que YouTube deja de generar informes nuevos para el trabajo.

      • La propiedad jobExpireTime del recurso report especifica la fecha y hora en que el trabajo asociado con el informe venció o vencerá. 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 muestra un código de respuesta HTTP 400 (Bad Request) si intentas crear un trabajo para un informe obsoleto. Además, la documentación del método ahora enumera varios otros motivos por los que una solicitud a la API falla.

    12 de abril de 2016

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

    • Ahora, YouTube genera datos que abarcan el período de 180 días anterior al momento en que se programó por primera vez un trabajo de informe. Anteriormente, la API de informes no entregaba datos históricos. Este cambio afecta a todos los trabajos, incluidos los que se crearon antes de este anuncio.

      Los informes históricos se publican apenas están disponibles, aunque los datos históricos tardan aproximadamente un mes en publicarse para un trabajo. Por lo tanto, un mes después de programar un trabajo de informes, tendrá 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 de su anuncio).

      Tenga 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 informes.

    • La sección de características del informe de la descripción general de la API de informes de YouTube se actualizó con los siguientes cambios:

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

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

    • La API de informes de YouTube pronto admitirá un conjunto de informes generados automáticamente y administrados por el sistema que contienen datos de ingresos por anuncios o de suscripciones a YouTube Red. Los informes estarán disponibles para los propietarios de contenido que ya puedan acceder a los informes de ingresos descargables manualmente en Creator Studio de YouTube. Por lo tanto, la nueva funcionalidad de la API proporcionará acceso programático a esos datos.

      Se están anunciando los siguientes cambios de API para preparar 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, que no pueden modificar ni eliminar 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 primeros datos del informe son iguales o posteriores a la fecha especificada. De manera similar, el parámetro startTimeBefore indica que la respuesta de la API solo debe contener informes si los primeros datos del informe son anteriores a la fecha especificada.

        A diferencia del parámetro createdAfter del método, que corresponde al momento en que se creó el informe, los nuevos parámetros corresponden a 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

    La API de YouTube Reporting y la API de YouTube Analytics ahora muestran las estadísticas de vistas de varios servicios adicionales de uso compartido.

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

    16 de marzo de 2016

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

    API de informes de YouTube

    • La dimensión playback_location_type admite dos valores de dimensión nuevos:
      • 7: Los datos corresponden a las vistas que se produjeron en la página o pantalla principal de YouTube, en el feed de suscripciones del usuario o en otra función de navegación de YouTube.
      • 8: los datos corresponden a las vistas que se produjeron directamente en la página de resultados de búsqueda de YouTube.
    • La dimensión traffic_source_type ahora admite 18 como valor de dimensión. Este valor indica que las reproducciones del video se originaron desde una página que enumera todos los videos en una lista de reproducción. Esta fuente difiere del tipo de fuente 14, que indica que las vistas ocurrieron mientras se reproducía el video como parte de una lista de reproducción.

    API de YouTube Analytics

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

    8 de febrero de 2016

    La lista de métricas admitidas para la API de YouTube Analytics se actualizó a fin de que las métricas de tarjetas ya no se muestren como métricas admitidas para esa API. (Ninguno de los informes de esa API documentaba que admitiera ninguna de las métricas de las tarjetas).

    Ten en cuenta que aún puedes recuperar las métricas de tarjetas con la API de informes de YouTube, la cual admite esas métricas para numerosos informes de canal y propietarios de contenido.

    6 de enero de 2016

    La API de informes de YouTube y la API de YouTube Analytics ahora identifican específicamente las vistas que se producen a través de un dispositivo Chromecast.

    • En la API de informes de YouTube, la dimensión operating_system usa el valor 21 para identificar las vistas que se producen mediante Chromecast.
    • En la API de YouTube Analytics, la dimensión operatingSystem usa el valor CHROMECAST para identificar las vistas que se realizan mediante Chromecast.

    21 de diciembre de 2015

    En la documentación, se actualizaron los nombres de las métricas annotation_clickable_impressions y annotation_closable_impressions para que coincidan con los nombres que se muestran en los informes. Anteriormente, los nombres se documentaban como clickable_annotation_impressions y closable_annotation_impressions.

    18 de diciembre de 2015

    Las leyes de la Unión Europea (UE) exigen que se divulguen ciertas divulgaciones y que se obtenga el consentimiento de los usuarios finales en la UE. Por lo tanto, para los usuarios finales en la Unión Europea, debe satisfacer la Política de Consentimiento de Usuarios de la UE. Agregamos una notificación de este requisito a nuestras Condiciones del Servicio de la API de YouTube.

    15 de diciembre de 2015

    Esta actualización incluye los siguientes cambios, que afectan a la API de YouTube Analytics:

    • La API de YouTube Analytics ahora admite tres nuevas dimensiones de detalle de reproducción que se pueden utilizar en diferentes informes sobre 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 la actividad del usuario en los datos se asocian con los espectadores que se suscribieron al canal del video o de la lista de reproducción.
      • youtubeProduct: Esta dimensión identifica la propiedad de YouTube en la que se produjo la actividad del usuario. Los valores posibles incluyen el sitio web principal de YouTube (o la app de YouTube), YouTube Gaming y YouTube Kids.

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

    • Cambió el formato de las tablas en las que se explican los informes para facilitar la identificación de combinaciones válidas de dimensiones, métricas y filtros que se pueden utilizar para recuperar cada informe. La siguiente tabla, que explica el informe "Tipo de dispositivo" para los canales, muestra el nuevo formato:

      Contenido
      Dimensiones:
      Obligatoria tipodedispositivo
      Usa 0 o más day, liveOrOnDemand, subscribedStatus, youtubeProduct
      Métricas:
      Usa 1 o más vistas, estimatedMinutesWatched
      Filtros:
      Usa 0 o 1 country, province, continent, subContinent
      Usa 0 o 1 video, group
      Usa 0 o más operatingSystem, liveOrOnDemand, subscribedStatus y youtubeProduct

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

    • La API de YouTube Analytics ahora elimina automáticamente las entidades para las que el usuario de la API no puede obtener datos de los filtros que admiten varios valores (video, playlist y channel). Anteriormente, el servidor de la API habría mostrado un error si el usuario de la API no pudiera 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 cual el filtro video enumera 20 ID de video. El usuario posee 18 de los videos. Sin embargo, un ID de video identifica un video que es propiedad de otro canal y otro ID identifica un video que se eliminó y, por lo tanto, ya no existe. En este caso, en lugar de mostrar un error, el servidor de la API descarta los dos videos a los que el usuario no puede acceder, y la respuesta de la API contiene datos de los 18 videos que posee el usuario de la API.

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

    • Ahora, el método groupItems.insert de la API de YouTube Analytics muestra un error no autorizado (código de respuesta HTTP 403) si intentas agregar una entidad a un grupo, pero no tienes acceso a esa entidad. Anteriormente, la API le habría permitido agregar la entidad al grupo, pero luego mostró un error no autorizado cuando intentó recuperar los datos del informe para ese grupo.

    • Ahora, el método groups.list de la API de YouTube Analytics es compatible con 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, la documentación 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 considerar que todas las dimensiones relacionadas con las fechas (day, 7DayTotals, 30DayTotals y month) se refieren a las fechas que comienzan a las 12:00 a.m. hora del Pacífico (UTC-8).

    • El método jobs.reports.list() de la API de informes de YouTube ahora admite el parámetro de consulta createdAfter. Si se especifica, este parámetro indica que la respuesta de la API solo debe enumerar los informes creados después de la fecha y hora especificadas, incluidos los informes nuevos con datos de reabastecimiento. Tenga en cuenta que el valor del parámetro corresponde al momento en que se crea el informe y no a las fechas asociadas con los datos mostrados.

      El valor del parámetro es una marca de tiempo en formato RFC3339 UTC "Zulu", con precisión de microsegundos. Ejemplo: "2015-10-02T15:01:23.045678Z".

      Las prácticas recomendadas de la API de informes de YouTube también se actualizaron para explicarte cómo puedes usar el parámetro createdAfter a fin de evitar el procesamiento repetido del mismo informe.

    • Las definiciones de la propiedad createTime del recurso job y las propiedades startTime, endTime y createTime del recurso report se corrigieron para tener en cuenta que los valores de la propiedad son precisos para microsegundos, no 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 posibles valores de dimensión. La lista incluye una serie de servicios recientemente admitidos.

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

    24 de septiembre de 2015

    Esta actualización incluye los siguientes cambios:

    • La nueva API de informes de YouTube permite obtener informes de datos masivos que contienen datos de YouTube Analytics sobre un canal o propietario de contenido. Está diseñado para aplicaciones que pueden importar conjuntos grandes de datos y que proporcionan herramientas para filtrar, ordenar y extraer esos datos.

      Cada informe de la API de informes de YouTube contiene un conjunto predefinido de dimensiones y métricas. (Los informes de la API de YouTube Analytics también 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 filas basadas en valores de dimensión a fin de calcular métricas para 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 configuras un trabajo, YouTube genera un informe diario que se puede descargar de manera asíncrona. Cada informe contiene datos para un período único de 24 horas.

    • Aunque son API distintas, la API de YouTube Analytics y la de informes de YouTube permiten que los desarrolladores recuperen datos de YouTube Analytics. Debido a que ambas API proporcionan acceso a conjuntos de datos similares, la documentación para las dos API se publica como un conjunto único de documentación.

      • La pestaña Guías en el conjunto de documentos contiene información común para ambas API, incluidas las instrucciones para autorizar las solicitudes de API.
      • La pestaña Informes masivos incluye documentación de referencia y otro tipo de contenido específicamente para la API de informes de YouTube.
      • La pestaña Consultas segmentadas incluye documentación de referencia y otro contenido específico para la API de YouTube Analytics.
      • La pestaña Muestras muestra las muestras de código disponibles para cualquiera de las dos API.
      • La pestaña Herramientas enumera recursos adicionales disponibles para ayudar a los programadores a implementar cualquiera de las dos API.

    20 de agosto de 2015

    Esta actualización incluye los siguientes cambios:

    • Se reestructuró la documentación de la API para facilitar su comprensión. Por lo tanto, estos cambios no describen funciones nuevas:

      • La documentación ahora contiene una página que enumera todos los informes de canales disponibles y otra que enumera todos los informes de propietarios de contenido disponibles. Anteriormente, la documentación tenía páginas separadas para los informes de videos de canales, los informes de listas de reproducción de canales, etc.

      • La nueva descripción general del modelo de datos busca proporcionar una introducción más clara al funcionamiento de la API. Específicamente, en este documento se explica 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 se usa para recuperar informes, ahora se documenta por separado. La información de esa página ya había estado en otras páginas. La nueva página está diseñada para ayudarlo a identificar más fácilmente la información que necesita 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 los ingresos estimados totales (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 fuentes no publicitarias. Anteriormente, la definición indicaba incorrectamente que la métrica solo incluía ingresos de fuentes publicitarias.

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

    • Además de la métrica obsoleta primaryAdGrossRevenue, los informes de rendimiento de los anuncios ya no son compatibles con las métricas monetizedPlaybacks y 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 nuevas métricas para los informes de video, videosAddedToPlaylists y videosRemovedFromPlaylists. Las listas de los informes de video de los canales y de los propietarios de contenido se actualizaron para identificar los informes que admiten las nuevas métricas.

      • videosAddedToPlaylists: la cantidad de veces que se agregaron videos dentro del alcance de la consulta a cualquier lista de reproducción de YouTube. Es posible que los videos se hayan agregado a la lista de reproducción del propietario del video o a las de otros canales.
      • videosRemovedFromPlaylists: la cantidad de veces que se quitaron videos de las consultas en las listas de reproducción de YouTube. Es posible que los videos se hayan quitado de las listas de reproducción del propietario del video o de otros canales.

      Ambas métricas incluyen listas de reproducción predeterminadas, como la lista de reproducción "Ver más tarde". Sin embargo, no se cuentan las listas de reproducción a las que se agrega un video automáticamente, como las listas de reproducción subidas a un canal o el historial de reproducciones del usuario. Además, ten en cuenta que estas métricas reflejan la cantidad absoluta de adiciones y eliminaciones. Por lo tanto, si un usuario agrega un video a una lista de reproducción, lo quita y vuelve a agregarlo, las métricas indican que el video se agregó a dos listas y se quitó de una.

      Los datos de estas métricas se encuentran disponibles desde el 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 métricas de ingresos en una moneda distinta del dólar estadounidense (USD). Si el parámetro está configurado, la API convierte los valores de las métricas earnings, grossRevenue, playbackBasedCpm y impressionBasedCpm a la moneda especificada. Los valores mostrados son estimaciones calculadas mediante los tipos de cambio que cambian diariamente.

      El valor del parámetro es un código de moneda ISO 4217 de tres letras. El valor predeterminado es USD. La definición del parámetro contiene una lista de códigos de moneda admitidos.

    25 de febrero de 2015

    Esta actualización incluye los siguientes cambios:

    • La API ahora permite crear y administrar grupos de YouTube Analytics, así como recuperar datos de informes para esos grupos.

      • Crea y administra grupos

        Esta actualización introduce 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, listas de reproducción o activos. La API admite los métodos list, insert, update y delete para este recurso.
        • El recurso groupItem representa un elemento en 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.

      • Cómo recuperar los datos de informes de un grupo

        La documentación de dimensiones se actualizó para incluir la dimensión group, que se puede utilizar como un filtro para muchos informes de canal e informes de propietarios de contenido. Cuando usas el filtro group, la API muestra datos de todos los elementos de ese grupo. Tenga en cuenta que, actualmente, la API no admite la capacidad de crear informes para grupos de elementos.

      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 se usan como filtros. Para especificar varios valores, establece el valor del parámetro filters en una lista separada por comas de ID de video, lista de reproducción, canal o programa para los que se debe filtrar la respuesta de la API. El valor del parámetro puede especificar hasta 200 ID.

      Si especifica varios valores para el mismo filtro, también puede agregar ese filtro a la lista de dimensiones que especifique para la solicitud. Esto ocurrirá incluso si el filtro no aparece como una dimensión admitida para un informe en particular. Si agrega 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:

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

    • La API ahora admite los informes de listas de reproducción, que contienen estadísticas relacionadas con las reproducciones de video que se producen en el contexto de una lista de reproducción. Los informes de listas de reproducción están disponibles para los canales y los propietarios de contenido.

      Todos los informes de listas de reproducción son compatibles con las métricas views y estimatedMinutesWatched, y algunos también admiten la métrica averageViewDuration.

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

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

      Cualquier solicitud para recuperar un informe de listas de reproducción debe utilizar el filtro isCurated, que se debe establecer en 1 (isCurated==1).

    • La API ahora admite un informe de retención de público. Este informe mide la capacidad de un video para retener su público. La nueva dimensión elapsedVideoTimeRatio del informe mide la cantidad de video que ha pasado para los valores de métrica correspondientes:

      • La métrica audienceWatchRatio identifica la proporción absoluta de usuarios que miran el video en un punto dado del video. Para calcular la proporción, se compara la cantidad de veces que se vio una parte de un video con la cantidad total de vistas.

        Ten en cuenta que una parte de un video puede verse más de una vez (o directamente no) en una vista de video determinada. Por ejemplo, si los usuarios retroceden y miran la misma parte de un video varias veces, la proporción absoluta de esa parte del video podría ser mayor que 1.

      • La métrica relativeRetentionPerformance muestra la eficacia con la que un video retiene a los espectadores durante las reproducciones en comparación con todos los videos de YouTube que tienen una duración similar. Un valor de 0 indica que el video retiene a los espectadores peor que cualquier otro video de duración similar, mientras que un valor de 1 indica que el video retiene a los espectadores mejor que cualquier otro video de duración similar. Un valor medio de 0.5 indica que la mitad de los videos de duración similar retienen a los espectadores mejor, mientras que la mitad retiene a los espectadores.

      También puede utilizar el filtro audienceType para que el informe solo muestre datos asociados con vistas orgánicas, vistas de anuncios TrueView in-stream o vistas de anuncios TrueView en display. (Las vistas orgánicas son el resultado directo de las acciones de los usuarios, como la búsqueda de un video o un clic en un video sugerido).

    • La API admite varias métricas nuevas relacionadas con las anotaciones. Las métricas que se enumeran a continuación se pueden recuperar con cualquier informe que anteriormente admitía 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, tenga en cuenta que hay datos disponibles para las nuevas métricas desde el 16 de julio de 2013. (Los datos de las métricas annotationClickThroughRate y annotationCloseRate están disponibles desde el 10 de junio de 2012).

    • GOOGLE_SEARCH ya no se informa como un valor separado 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, ya no es posible recuperar un informe 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 muestra para agrupar ejemplos en categorías, con un formato de pestaña similar al que se lanzó recientemente para los informes de canales y propietarios de 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 informes de propietarios de contenido)

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

      • Métricas específicas de la provincia para los estados de EE.UU. y Washington D.C.: Este informe recupera un desglose por provincia de los recuentos de vistas y otras estadísticas de los videos de un canal. Los datos abarcan los estados de EE.UU. y Washington D.C. El ejemplo usa la dimensión province y el parámetro filters para restringir la respuesta, de modo que solo incluya resultados para Estados Unidos.

      • Datos demográficos del espectador en California (edad y género): Este informe recupera estadísticas sobre el grupo etario y el género de los espectadores en California que miraron los videos de un canal o, en los informes de propietarios del contenido, el contenido reclamado por 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.

    • La definición de la dimensión province se actualizó para tener en cuenta que, cuando province se incluye en el valor del parámetro dimensions, la solicitud también debe restringir los datos a Estados Unidos mediante la inclusión de 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 incluyen los informes admitidos de canal y propietario del contenido. En lugar de proporcionar una tabla en la que se enumeren 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 usted puede hacer clic en cualquier pestaña para ver los informes admitidos en esa categoría.

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

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

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

          • En el informe de estadísticas principales, se proporcionan varias estadísticas, incluidos los recuentos de vistas y los minutos de reproducción estimados.
          • El informe basado en el tiempo proporciona las mismas estadísticas, pero recopila datos diariamente, todos los días, los últimos 7 días, los últimos 30 días o cada mes.

        • Puedes usar el parámetro de búsqueda filters a fin de restringir un informe para que solo contenga estadísticas de un estado en particular. Varios informes admiten este tipo de filtrado, entre ellos, informes geográficos, informes de ubicación de reproducción, informes de fuentes de tráfico, informes de dispositivos, informes de sistemas operativos, informes demográficos y de video 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 se puede usar solo como filtro.

        Dado que 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 mostrará un error si una solicitud usa ambas dimensiones).

    • La documentación se corrigió para que la dimensión insightTrafficSourceDetail no incluya el valor insightTrafficSourceType PROMOTED como 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 no principales y las métricas que no son principales de la API no están sujetas a la política de baja. Las páginas de dimensiones y métricas se actualizaron para enumerar las dimensiones y métricas principales. Además, las definiciones de esas páginas se actualizaron 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 categorizarán como reproducciones MOBILE, aunque las reproducciones desde dispositivos móviles que se produjeron antes de esa fecha seguirán categorizándose con ese valor.

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

    • La API ahora admite PLAYLIST como valor para la dimensión insightTrafficSourceType. El valor indica que las reproducciones del video proceden de una lista de reproducción. Anteriormente, estas vistas se clasificaban mediante 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 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 nuevas dimensiones, deviceType y operatingSystem, que se pueden usar para recuperar datos sobre los dispositivos en los que los espectadores 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, incluidos dispositivos móviles, computadoras de escritorio y tablets. También puedes usar el filtro operatingSystem a fin de restringir el informe de tipo de dispositivo para que solo incluya estadísticas de 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 otros. También puedes usar el filtro deviceType a fin de restringir el informe del sistema operativo para que incluya solo estadísticas de un tipo específico de dispositivo, como dispositivos móviles o tablets.

      Los nuevos informes de tipo de dispositivo y sistema operativo están disponibles para los canales y los propietarios de contenido.

    • El documento de solicitudes de ejemplo se actualizó para incluir tres informes de dispositivos para los canales y tres informes de dispositivo para los propietarios de contenido.

    • La dimensión insightPlaybackLocationType puede mostrar el valor YT_OTHER, que identifica vistas que no se clasificaron 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 las métricas del tiempo de reproducción (estimatedMinutesWatched, averageViewDuration y averageViewPercentage) junto con otras métricas, como las de reproducción, de participación y de anuncios.

      Las listas de informes de canales e informes de propietarios de contenido disponibles se actualizaron para reflejar este cambio. (En realidad, las listas son más cortas debido a que las métricas del tiempo de reproducción se pueden recuperar como parte de otros informes de la lista).

      El documento Solicitudes de API de ejemplo también se actualizó.

    • Los informes que utilizan las dimensiones insightPlaybackLocationDetail y insightTrafficSourceDetail se mejoraron de las siguientes maneras:

      • Ahora admiten un filtro country opcional.

      • Los propietarios de contenido ahora pueden recuperar estos informes utilizando cualquiera de las siguientes combinaciones de filter. Ten en cuenta que todas estas combinaciones también admiten el filtro country opcional.

        • Detalles de ubicación de reproducción

          • channel,insightPlaybackLocationType==EMBEDDED
          • show,insightPlaybackLocationType==EMBEDDED
          • claimedStatus,insightPlaybackLocationType==EMBEDDED
          • uploaderType,insightPlaybackLocationType==EMBEDDED
          • uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED

        • Detalle de 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 Solicitudes de API de ejemplo proporciona ejemplos que muestran cómo recuperar muchos tipos diferentes de informes mediante YouTube Analytics API. Cada ejemplo incluye una breve descripción del informe que la solicitud recupera y muestra las dimensiones, las métricas, los filtros y los parámetros de orden para la solicitud.

    • La dimensión insightTrafficSourceType ahora admite SUBSCRIBER como valor válido. Este valor identifica las reproducciones de video que proceden de los feeds en la página principal de YouTube o de los elementos de suscripción de YouTube. Si filtras según esta fuente de tráfico, el campo insightTrafficSourceDetail especificará el feed de la página principal u otra página de la cual provinieron las reproducciones.

    28 de marzo de 2013

    Esta actualización incluye los siguientes cambios:

    21 de marzo de 2013

    Esta actualización incluye los siguientes cambios:

    • La API ahora admite métricas de ingresos y de rendimiento de los anuncios, así como nuevos informes de rendimiento de los anuncios. Las métricas y los informes están disponibles solo para los socios de contenido de YouTube que participan en el Programa para socios de YouTube.

      • Los informes admitidos recientemente admiten métricas de rendimiento de los anuncios basadas en las reproducciones y métricas de rendimiento de los anuncios basadas en las impresiones. Consulta la documentación de informes de propietarios de contenido para obtener más información sobre los informes de rendimiento de los anuncios.

      • A continuación se muestran las métricas recién admitidas. La lista de informes de propietarios de contenido se actualizó para identificar los informes, incluidos los dos nuevos informes, que admiten estas métricas.

        • earnings: ingresos totales estimados de todas las fuentes de publicidad vendidas por Google.
        • grossRevenue: ingreso bruto estimado de socios de Google o DoubleClick.
        • primaryAdGrossRevenue: Los ingresos brutos estimados, resumidos y clasificados en el tipo de anuncio principal para las reproducciones de video que el informe abarca, de los socios de Google o DoubleClick.
        • monetizedPlaybacks: La cantidad de reproducciones que mostraron al menos una impresión de anuncio.
        • playbackBasedCpm: ingreso bruto estimado por cada mil reproducciones.
        • impressions: Es la cantidad de impresiones de anuncios verificadas publicadas.
        • impressionBasedCpm: ingresos brutos estimados por cada mil impresiones de anuncios.

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

      • Cualquier solicitud que recupere métricas de ingresos o de rendimiento de anuncios debe enviar un token de autorización que otorgue acceso con el nuevo alcance 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 ejemplos de códigos que muestran cómo invocar la API mediante las bibliotecas de cliente Java, JavaScript, Python y Ruby. El ejemplo de código JavaScript es el mismo que se analiza en detalle en la documentación de la aplicación de ejemplo.

    14 de noviembre de 2012

    Esta actualización incluye los siguientes cambios:

    • La guía de referencia de la API ahora incluye APIs Explorer, que te permite llamar a la API, ver la solicitud de la API y recuperar datos reales en la respuesta.

    • La API admite una serie de nuevos informes para canales y propietarios de contenido, que se describen a continuación. Cada informe está disponible como un informe de canales o un informe de propietarios de contenido. Las páginas de dimensiones y métricas también se actualizaron en consecuencia.

      • El informe de ubicación de reproducción especifica el número de reproducciones de videos que tuvieron lugar en diferentes tipos de páginas o aplicaciones.

      • El informe detallado de ubicaciones de reproducción identifica los reproductores integrados que generaron la mayor cantidad de reproducciones para un video determinado. Proporciona una perspectiva más precisa que el informe de ubicaciones de reproducción mediante la identificación de las direcciones URL asociadas con los principales reproductores integrados.

      • El informe de fuentes de tráfico identifica la cantidad de reproducciones de videos que se originaron a partir de diferentes tipos de URL de referencia.

      • El informe detallado de fuentes de tráfico identifica las URL de referencia que generaron la mayor cantidad de reproducciones para un video y un tipo de fuente de tráfico especificados. Por ejemplo, este informe podría indicar cuáles son los videos relacionados que enviaron el mayor tráfico a un video específico. Este informe admite varias fuentes de tráfico.

      • Los informes de tiempo de reproducción indican la cantidad de tiempo que los espectadores dedicaron a ver el contenido. Los informes pueden recopilar datos de un período de tiempo específico, un día, los siete días anteriores, los 30 días previos, etc.; o de un país determinado. Si un informe recopila datos, ya sea por día o país, también puede especificar la duración media de cada reproducción de video, así como el porcentaje promedio de cada video que los usuarios reprodujeron.

    2 de octubre de 2012

    Esta actualización incluye los siguientes cambios:

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

    • En la nueva sección Introducción, se describen los requisitos y pasos básicos para crear una aplicación que use 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 API calcula un costo de consulta para cada solicitud y dicho costo se deduce de tu cuota de uso de la API. Dado que los diversos tipos de informes pueden tener costos de consulta muy diferentes, debes planear el uso de tu cuota de manera eficiente, y tu aplicación solo debe solicitar las métricas y los datos realmente necesarios.

    • La sección de dimensiones temporales se actualizó para explicar que esas dimensiones indican que un informe de Analytics debe recopilar datos sobre la base de un período de tiempo. La API ahora admite las siguientes dimensiones temporales adicionales:

      • 7DayTotals: Los datos del informe se recopilarán de manera que cada fila contenga los datos de un período de siete días.
      • 30DayTotals: Los datos del informe se recopilarán de manera que cada fila contenga los datos de un período de 30 días.
      • month: Los datos del informe se recopilarán por mes calendario.

      Del mismo modo, la sección informes disponibles se actualizó para reflejar la compatibilidad de la API con los informes que utilizan estas dimensiones.

    • La sección de dimensiones de entidad de informe se actualizó para indicar que las solicitudes de API para recuperar informes de propietario de contenido deben filtrar los datos mediante 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.

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