Registro de cambios de la API de Google Analytics Management

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Actualizamos periódicamente la API de Management de Google Analytics para ofrecer funciones nuevas y reparar defectos en versiones anteriores. En la mayoría de los casos, estos cambios serán transparentes para los desarrolladores de API. Sin embargo, ocasionalmente necesitamos realizar cambios que requieren que los desarrolladores modifiquen sus aplicaciones existentes.

En esta página, se documentan los cambios realizados en la API de Google Analytics Management que podrían afectar tu aplicación. Recomendamos que los desarrolladores de API revisen esta lista de forma periódica para consultar los nuevos anuncios. También puedes suscribirte a los cambios mediante los feeds que se indican en la sección Suscribirse a continuación.

Suscribirse a registros de cambios relacionados

Incluye todas las API de informes, configuración y colección.

Incluye la API de administración y la API de aprovisionamiento.

Configuración de retención de datos del usuario en la API de Management

Ahora es posible configurar de manera programática la configuración de retención de datos del usuario con los nuevos campos"dataretentionTtl"y"dataretentionResetOnNewActivity"agregados al recurso WebProperty.

Operaciones de escritura en la API de Management

Las operaciones de escritura en la API de administración (p.ej., crear, actualizar, borrar y aplicar parches) para los recursos de propiedad web, vista (perfil) y objetivo ya no requieren listas blancas. El límite diario predeterminado de todas las operaciones de escritura en la API de Management es de 50 operaciones de escritura por día. Consulta la página Límites y cuotas para obtener más información.

Custom Metrics

Esta es una versión de corrección de errores que soluciona el problema por el que fallaba la creación de una métrica personalizada del tipo TIME cuando no se configuraba min_value. Las solicitudes sin un min_value ahora crean una métrica personalizada con un min_value predeterminado de 0.

Monedas

Esta es una versión de corrección de errores que soluciona un problema por el que se admitía un subconjunto de monedas en la interfaz web de Analytics, pero no en la API. Esta versión incluye compatibilidad con las siguientes monedas:

  • UAH, AED, BOB, CLP, COP, EGP, HRK, ILS, MAD, MYR, PEN, PKR, RON, RSD, SAR, SGD, VEF y LVL

Para obtener más información, consulta la referencia de vistas (perfiles). - El artículo del Centro de ayuda sobre referencia de monedas

Informes sin muestrear

La API de informes sin muestrear ya no tiene un límite de 100 informes por día. La API utiliza el mismo sistema de tokens por propiedad y por día que se emplea para crear un informe sin muestrear a través de la interfaz web.

Informes sin muestrear

Los informes sin muestrear a los que no puede acceder el usuario actual ya no tendrán un vínculo de descarga dentro del mensaje de respuesta de la API de administración. Este comportamiento es coherente con la funcionalidad del panel de la IU, en la que solo los propietarios de los informes pueden ver el vínculo de descarga del documento generado.

Segmentos

Esta es una versión de corrección de errores. Esta versión soluciona un problema que causaba que los segmentos con valores de moneda en la definición aparecieran de forma incorrecta al llamar al método de lista de segmentos.

Segmentos

Esta es una versión de corrección de errores. Esta versión soluciona un problema que provocaba que los usuarios con segmentos privados fijados a varias vistas (perfiles) obtuvieran una respuesta de error 500 cuando llamaban al método de lista de segmentos.

Agrupación en lotes

En esta versión, además de la compatibilidad por lotes general, agregamos una compatibilidad especial para la API de permisos del usuario. Las solicitudes de Permisos de usuario en lote experimentarán mejoras de rendimiento significativas y un uso de cuota reducido.

Vistas (perfiles)

Con esta versión, la propiedad currency de View (Perfil) ahora se establecerá de forma predeterminada en USD si no se configura durante una operación de inserción. Además, las operaciones get y list mostrarán USD en vistas (perfiles) que se crearon anteriormente sin una propiedad currency.

Filtros

Esta versión marca la eliminación final de los campos de filtro obsoletos IS_MOBILE y IS_TABLET, que se deben reemplazar por DEVICE_CATEGORY=mobile y DEVICE_CATEGORY=tablet. Las solicitudes de inserción, actualización y aplicación de parches que configuran los campos de filtro para usar IS_MOBILE y IS_TABLET mostrarán un error.

Filtros

Esta actualización agrega compatibilidad a fin de usar una dimensión personalizada para un campo de filtro mediante la adición de una propiedad fieldIndex a todas las secciones de detalles del filtro. Por ejemplo, ahora es posible configurar la expresión de filtro con "field": "CUSTOM_DIMENSION" y "fieldIndex": "1" para que el filtro funcione en la primera dimensión personalizada.

Objetivos

Esta versión también corrige un problema que se producía cuando fallaba la creación de un objetivo con "comparisonValue": "0".

Esta versión marca la desactivación final y la eliminación del recurso dailyUpload. El recurso dailyUpload dejó de estar disponible oficialmente el 20 de junio de 2014. Ahora, toda la importación de datos de costos debe realizarse con el recurso de cargas.

Esta actualización agrega dos colecciones nuevas a la API de Management, las dimensiones personalizadas y las métricas personalizadas.

Dimensiones y métricas personalizadas

Ahora es posible crear, enumerar, obtener, aplicar parches y actualizar las dimensiones y métricas personalizadas con la API de administración.

La respuesta del método list para todas las colecciones ahora incluye una lista vacía para la propiedad items cuando la colección no contiene recursos. Antes, la propiedad items se omitía de la respuesta. Consulta la Referencia de la API para obtener detalles completos sobre las consultas y respuestas a los datos de configuración de Google Analytics.

Se agregó un nuevo campo de filtros DEVICE_CATEGORY, y IS_MOBILE y IS_TABLET dejaron de estar disponibles. Usa DEVICE_CATEGORY=mobile y DEVICE_CATEGORY=tablet.

El recurso Vista (Perfil) ahora incluye una propiedad enhancedECommerceTracking que indica si el Comercio electrónico mejorado está habilitado (true) o inhabilitado (false).

Esta actualización incluye nuevos tipos de importación de datos y la baja del recurso dailyUpload.

Importación de datos

Consulte la Guía para desarrolladores sobre la importación de datos a fin de obtener detalles sobre cómo usar la API de administración para importar datos a su cuenta de Google Analytics.

Cargas

  • El recurso upload ahora admite los siguientes tipos de carga:
    • Datos de la campaña
    • Datos del contenido
    • Datos de costos
    • Datos del producto
    • Datos de reembolso
    • Datos del usuario
  • El recurso upload tiene un nuevo método migrateDataImport para migrar los datos de costos existentes customDataSources.

Baja de cargas diarias

  • El recurso dailyUpload ya no está disponible. Consulta la Guía de migración para obtener detalles sobre la migración y usar la función de importación de datos.
  • El recurso dailyUpload seguirá funcionando durante seis meses más. En ese momento, cualquier customDataSources restante con la propiedad uploadType configurada en analytics#dailyUploads se migrará automáticamente y solo funcionará con el recurso upload.
  • Los usuarios actuales del recurso dailyUpload deben actualizar su código y migrar para usar el recurso Subir lo antes posible.

Esta versión agrega dos nuevas API de configuración.

Filtros

Informes sin muestrear: API de Management

Se está agregando un nuevo recurso a la API de Management llamado Informes sin muestrear. Los informes sin muestrear son informes de Google Analytics (GA) que se generaron con datos sin muestrear.Por el momento, los informes sin muestrear solo están disponibles para los usuarios de GA Premium. 

Segmentos: API de administración v2.4 y v3.0

Se realizaron los siguientes cambios en la colección de segmentos:

  • Ahora, la API admite segmentos de usuarios y secuencias.
  • La colección Segmentos ahora muestra todos los segmentos nivel de sesión y nivel de usuario integrados y personalizados.
  • La propiedad definition para los segmentos ahora usará la nueva sintaxis de segmentos. Esto incluye las definiciones de los segmentos existentes a nivel de sesión que cambiarán de definition: "" a definition: "sessions::condition::".
  • Se agregó una nueva propiedad type al recurso Segment para indicar si un segmento es CUSTOM (es decir, creado por un usuario en la interfaz web) o BUILT_IN (es decir, proporcionado por Google Analytics).

Experimentos

Las siguientes métricas de AdSense ahora se pueden usar como objetivos de optimización:

  • ga:adsenseAdsClicks: Es la cantidad de veces que se hizo clic en los anuncios de AdSense en su sitio.
  • ga:adsenseAdsViewed: Es la cantidad de anuncios de AdSense vistos. Se pueden mostrar varios anuncios en un bloque de anuncios.
  • ga:adsenseRevenue: los ingresos totales provenientes de los anuncios de AdSense.

Nueva colección de resúmenes de cuenta

Se realizaron los siguientes cambios en los segmentos predeterminados debido a la baja de las dimensiones ga:isMobile y ga:isTablet:

  • El nombre del segmento gaid::-11 cambió de Tráfico en dispositivos móviles a Tráfico en tablets y dispositivos móviles. La definición de este segmento se cambió de ga:isMobile==Yes a ga:deviceCategory==mobile,ga:deviceCategory==tablet. Ten en cuenta que ga:isMobile incluyó tráfico en tablets, lo que se refleja en la nueva definición. Si solo desea recibir tráfico en dispositivos móviles, sin incluir tablets, cambie al nuevo segmento de tráfico en dispositivos móviles (gaid::-14).
  • La definición del segmento gaid::-13 cambió de ga:isTablet==Yes a ga:deviceCategory==tablet. Esto sigue representando el tráfico en tablets.
  • Se agregó el segmento gaid::-14. El nombre del segmento es Mobile Traffic y la definición es ga:deviceCategory==mobile.

Corrección de errores:

  • Se corrigió la información de zona horaria de las vistas (perfiles). Detalles: Antes de esta corrección, en ciertos casos, cuando se mostraba la vista (perfiles) en la API de administración, se mostraba información de la zona horaria incorrecta para una vista (perfil). Ahora la información de zona horaria de las vistas (perfiles) es coherente con lo que se establece en la interfaz de administrador de Google Analytics.

En esta versión, se presentan operaciones de escritura para recursos de propiedades web, vistas (perfiles) y objetivos, y un conjunto de 3 recursos nuevos que permiten la administración de permisos de usuario.

API de configuración de la cuenta

  • Las vistas (perfiles) ahora se pueden crear, actualizar, aplicar parches y borrar. Consulta la referencia de vistas (perfiles) para obtener detalles sobre los nuevos métodos.
  • Ahora se pueden crear, actualizar y aplicar parches a las propiedades y objetivos web. Consulte la referencia de propiedades web y la referencia de objetivos para obtener detalles sobre los nuevos métodos.
  • Ahora se puede solicitar una única propiedad web, objetivo (View) o objetivo (con el método get).
  • Actualmente, estas funciones están disponibles como vista previa para desarrolladores en versión beta limitada. Si le interesa registrarse, solicite acceso a la versión Beta.

Permisos de usuario en la API de Management

  • El nuevo recurso accountUserLinks permite que los usuarios administren los permisos de la cuenta.
  • El nuevo recurso webpropertyUserLinks habilita la administración de permisos de propiedad de los usuarios.
  • El nuevo recurso profileUserLinks habilita la administración de permisos de lectura (perfil) para los usuarios.
  • Los permisos para un usuario autorizado ahora están disponibles como parte de los recursos Cuenta, Propiedad web y Ver (perfil).
  • Se introdujo un nuevo alcance que es obligatorio para administrar los permisos de los usuarios. https://www.googleapis.com/auth/analytics.manage.users.
  • Consulta la Guía de desarrollo de permisos del usuario para obtener más información.

Como parte del lanzamiento de nuevos segmentos, lanzaremos los siguientes cambios en la colección de segmentos:

  • Todos los ID de segmento cambiarán de números enteros positivos a strings alfanuméricas. Si guardó los ID de segmento de los usuarios, le recomendamos que los actualice para usar los ID nuevos.
  • La colección Segmentos solo mostrará los segmentos existentes a nivel de visita. Actualmente, la API no admite los nuevos segmentos de visitantes, cohorte y secuencia.
  • La colección Segmentos seguirá mostrando los segmentos predeterminados existentes con los mismos ID numéricos negativos, pero no se admiten los nuevos segmentos predeterminados.

Esta actualización agrega 2 propiedades nuevas al recurso Webproperty:

  • profileCount: Muestra el recuento de perfiles de una propiedad. Esto le permite filtrar propiedades que no tienen ningún perfil (es decir, profileCount = 0).
  • industryVertical: Muestra la vertical o categoría de la industria seleccionada para una propiedad.

Corrección de errores:

  • La propiedad eCommerceTracking del recurso de perfil ahora es coherente con la configuración de comercio electrónico en la sección de administrador de la interfaz web. Muestra true cuando el seguimiento de comercio electrónico está habilitado y false si no está habilitado.
  • Se agregó un extremo nuevo a la API de Management v3 para acceder a los recursos de Experimentos y modificarlos.
  • El recurso de perfil ahora incluye una propiedad type a fin de identificar si un perfil está configurado para un sitio web o una app. Los dos valores posibles son WEB o APP.

Esta versión agrega respuestas de error útiles a la API de Management.

  • Se agregaron nuevos códigos de error, motivos y descripciones al cuerpo de las respuestas de error de la API. Se documentaron todos los códigos para las versiones 2.4 y 3.0 de la API de administración.

Esta versión agrega datos, cambia la funcionalidad existente y corrige un error.

Datos nuevos

  • La colección de segmentos avanzados ahora contiene un campo segmentId que se puede usar en el parámetro segmento de la API de exportación de datos.

Cambios

  • Se cambió el tipo de datos de max-results a integer.

  • Se cambió el valor predeterminado y máximo de max-results a 1,000.

Correcciones de errores

  • Las cuentas, las propiedades web y los perfiles de los experimentos del Optimizador de sitios web de Google ya no se incluyen en las colecciones correspondientes.

Esta versión agrega dos versiones nuevas de la API con muchas funciones nuevas y deja de estar disponible la versión anterior. Los cambios afectan la forma en que solicitas y manejas los datos de la API.

Versión 3.0

  • Esta es la versión principal más reciente de nuestra API y no es compatible con versiones anteriores. Todo el desarrollo futuro de la API se realizará en esta versión.

  • Datos nuevos

    • Representación completa de los objetivos de eventos
    • Un ID de propiedad web interno que se puede usar para establecer un vínculo directo a la interfaz de usuario de Google Analytics
    • Configuraciones de perfil para los parámetros de búsqueda de páginas y sitios predeterminados
  • Cambios

Versión 2.4

  • Esta es una actualización de versión secundaria que es, principalmente, retrocompatible con la versión 2.3 existente.

  • Cambios

    • Una nueva política de cuotas
    • Integración con la Consola de API de Google para administrar el acceso a la API y solicitar más cuota
    • Compatibilidad continua para los mecanismos de autorización existentes y OAuth 2.0
    • Nueva URL para realizar solicitudes: https://www.googleapis.com/analytics/v2.4/management/…
    • Respuestas en XML únicamente
    • No se admite la biblioteca cliente de JavaScript de datos de Google.
    • Salida XML coherente con la versión 2.3, por lo que las otras bibliotecas cliente de datos de Google existentes seguirán funcionando.

Baja

  • Anunciamos la baja de la versión 2.3 heredada de la API de Management. Seguirá funcionando durante dos meses; después de ese período, todas las solicitudes v2.3 mostrarán una respuesta v2.4.

Esta es la versión Beta de la API de administración de Google Analytics.

Feeds nuevos

Bibliotecas cliente actualizadas

  • La API de administración se lanzará en la misma biblioteca que la API de exportación de datos de Google Analytics. Se actualizaron las bibliotecas JavaScript y Java de Google Data. Se puede acceder a cada feed especificando el URI del feed adecuado para el método getManagementFeed() de las bibliotecas.

Documentación nueva

  • Se creó una nueva sección de los documentos para programadores de Google Analytics para describir cómo funciona la nueva API de administración.