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.
Versión 17/07/2018 (17 de julio de 2018)
Se agregó el método hashClientId a la API de Management.
El método hashClientId proporciona el hash del ID de cliente determinado, que se puede encontrar en ciertos formatos de datos exportados, como los datos de Google Analytics exportados a BigQuery.
Versión 11/05/2018 (11 de mayo de 2018)
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.
Lanzamiento del 22 de febrero de 2018 (22 de febrero de 2018)
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.
Lanzamiento de 2017-04-19 (19 de abril de 2017)
Público de remarketing: compatibilidad con Optimize
Esta versión agrega compatibilidad con Google Optimize, OPTIMIZE
como un tipo de cuenta de anuncio vinculado. Consulte la documentación de referencia de Públicos de remarketing y la guía para desarrolladores sobre públicos de remarketing para obtener más información.
Versión 23 de marzo de 2017 (23 de marzo de 2017)
Público de remarketing
Esta versión agrega el verbo DELETE
al recurso Público de remarketing. Para obtener más información, consulte la Guía para desarrolladores sobre el público de remarketing.
- Público de remarketing: eliminar: elimina un público de remarketing.
Versión 9 de febrero de 2017 (9 de febrero de 2017)
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.
Versión 9 de agosto de 2016 (9 de agosto de 2016)
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
Versión 8 de agosto de 2016 (8 de agosto de 2016)
Esta versión agrega públicos de remarketing a la API de administración.
Audiencias del remarketing
La API de administración le permite create
, get
, list
, update
y patch
públicos de remarketing para una propiedad de Google Analytics. Para obtener más información sobre cómo funcionan los públicos de remarketing, consulte el artículo Acerca de los públicos de remarketing en Analytics.
Versión 11 de marzo de 2016 (11 de marzo de 2016)
Protagonizada por
En esta versión, se agrega la propiedad starred
a Resúmenes de cuenta, Cuentas, Propiedades web y Vistas (perfiles).
Versión 25 de febrero de 2016 (25 de febrero de 2016)
Límite de frecuencia de errores
Siempre ha sido nuestra política que los desarrolladores tengan que implementar una retirada exponencial al manejar respuestas 500 o 503. Hoy presentamos un límite de frecuencia sobre los errores 500 y 503 para aplicar esta política.
- 50 solicitudes de escritura fallidas por hora
Versión 1 de febrero de 2016 (1 de febrero de 2016)
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.
Lanzamiento del 26 de enero de 2016 (26 de enero de 2016)
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.
Versión 17/12/2015 (17 de diciembre de 2015)
Vistas (perfiles)
Esta actualización agrega la propiedad botFilteringEnabled
al recurso de vista (perfil). Esta propiedad indica si el filtrado de bots está habilitado para una vista (perfil). Consulta los documentos de referencia de View (Profiles) para obtener más información.
Informes sin muestrear
Esta versión agrega el método delete
a los informes sin muestrear. Consulte los documentos de referencia de eliminación de informes sin muestrear para obtener más información.
Versión 17/11/2015 (17 de noviembre de 2015)
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.
Lanzamiento de 2015-10-06 (6 de octubre de 2015)
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.
Versión 3 de septiembre de 2015 (3 de septiembre de 2015)
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.
Lanzamiento de 2015-08-06 (6 de agosto de 2015)
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
.
-
Si desea obtener información sobre el uso de View (Profiles) en la API de Management, consulte la Guía para desarrolladores (Ver perfiles).
-
Consulta la referencia de vistas (perfiles) para ver la lista completa de parámetros del recurso de vista (perfil).
Lanzamiento 28 de mayo de 2015 (28 de mayo de 2015)
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.
-
Si desea obtener detalles sobre el uso de filtros en la API de Management, consulte la Guía para desarrolladores sobre filtros.
-
Consulta la referencia de Filtros para ver la lista completa de parámetros del recurso de filtro.
Publicación del 5 de mayo de 2015 (5 de mayo de 2015)
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.
-
Si desea obtener detalles sobre el uso de filtros en la API de Management, consulte la Guía para desarrolladores sobre filtros.
-
Consulta la referencia Filtros a fin de obtener una lista completa de los parámetros para el recurso de filtro.
Objetivos
Esta versión también corrige un problema que se producía cuando fallaba la creación de un objetivo con "comparisonValue": "0"
.
-
Consulte la Guía para desarrolladores de objetivos si desea obtener detalles sobre el uso de objetivos en la API de administración.
-
Consulta la referencia de objetivos para obtener una lista completa de los parámetros del recurso de objetivos.
Versión 13/03/2015 (13 de marzo de 2015)
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.
- Consulte la Política de Baja de Datos para obtener más detalles sobre el proceso de baja de la API de Google Analytics.
- Consulta la Guía para desarrolladores sobre la importación de datos a fin de obtener detalles sobre cómo importar datos en Google Analytics.
Lanzamiento 23/01/2015 (23 de enero de 2015)
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.
Versión 8 de enero de 2015 (8 de enero de 2015)
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.
Versión 16/12/2014 (16 de diciembre de 2014)
Correcciones de errores
- Solución para el error 467: La colección de segmentos ahora muestra segmentos que usan la sintaxis
dateOfSession
.
Versión 2014-11-20 (20 de noviembre de 2014)
Esta actualización introduce un nuevo alcance para la API de administración de Google Analytics. - analytics.manage.users.readonly
- Consulte los permisos del usuario de Google Analytics.
Lanzamiento de 2014-11-05 (5 de noviembre de 2014)
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
.
Versión 29 de octubre de 2014 (29 de octubre de 2014)
El recurso Vista (Perfil) ahora incluye una propiedad enhancedECommerceTracking
que indica si el Comercio electrónico mejorado está habilitado (true
) o inhabilitado (false
).
Lanzamiento de 2014-06 (20 de junio de 2014)
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étodomigrateDataImport
para migrar los datos de costos existentescustomDataSources
.
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, cualquiercustomDataSources
restante con la propiedaduploadType
configurada enanalytics#dailyUploads
se migrará automáticamente y solo funcionará con el recursoupload
. - Los usuarios actuales del recurso
dailyUpload
deben actualizar su código y migrar para usar el recurso Subir lo antes posible.
Versión 2014-05 (28 de mayo de 2014)
Esta versión agrega dos nuevas API de configuración.
Vínculos de AdWords
-
Los vínculos de AdWords en la API de administración te permiten crear, enumerar, obtener, actualizar, aplicar parches y eliminar vínculos entre las cuentas de Google AdWords y las propiedades de Google Analytics, y administrar las vistas (perfiles) vinculadas a los datos de AdWords.
Filtros
-
Los filtros de la API de administración le permiten crear, enumerar, obtener, actualizar, aplicar parches y eliminar filtros para su cuenta de Google Analytics. Los Vínculos de filtros de perfiles te permiten crear, enumerar, obtener, actualizar, aplicar parches y borrar vínculos entre Filtros y Vistas (Perfiles).
Lanzamiento 27/05/2014 (27 de mayo de 2014)
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.
- Consulta la Guía para desarrolladores
Lanzamiento 11/04/2014 (11 de abril de 2014)
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 dedefinition: "
a" definition: "sessions::condition::
." - Se agregó una nueva propiedad
type
al recurso Segment para indicar si un segmento esCUSTOM
(es decir, creado por un usuario en la interfaz web) oBUILT_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.
Publicación del 25 de marzo de 2014 (25 de marzo de 2014)
Nueva colección de resúmenes de cuenta
- Se agregó la colección AccountSummaries a la API de Management. Proporciona un resumen de la información de cada cuenta, propiedad y vista (perfil) a la que tiene acceso un usuario autorizado en una única solicitud rápida. Para obtener más información, consulte la Guía para desarrolladores de resúmenes de cuenta.
Versión 12/12/2013 (12 de diciembre de 2013)
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ó dega:isMobile==Yes
aga:deviceCategory==mobile,ga:deviceCategory==tablet
. Ten en cuenta quega: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ó dega:isTablet==Yes
aga: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 esga:deviceCategory==mobile
.
Lanzamiento 28/10/2013 (28 de octubre de 2013)
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.
Publicación del 4 de octubre de 2013 (4 de octubre de 2013)
Subidas (ampliación de dimensiones)
- El nuevo recurso Cargas permite subir datos de ampliación de dimensiones. Consulte la Guía para desarrolladores sobre la importación de datos (cargas).
Versión 3 de octubre de 2013 (3 de octubre de 2013)
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.
Lanzamiento 15/07/2013 (16 de julio de 2013)
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.
Publicación del 5 de junio de 2013 (5 de junio de 2013)
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. Muestratrue
cuando el seguimiento de comercio electrónico está habilitado yfalse
si no está habilitado.
Lanzamiento del 8 de mayo de 2013 (8 de mayo de 2013)
- El recurso de propiedad web ahora incluye una propiedad
level
para indicar si la propiedad web esPREMIUM
oSTANDARD
.
Publicación del 4 de abril de 2013 (4 de abril de 2013)
- Se agregó un extremo nuevo a la API de Management v3 para acceder a los recursos de Experimentos y modificarlos.
Versión 14/01/2013 (14 de enero de 2013)
- 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 sonWEB
oAPP
.
Versión 2012-01 (26 de enero de 2012)
Esta versión agrega respuestas de error útiles a la API de Management.
Versión 2011-12 (5 de diciembre de 2011)
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
ainteger
. -
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.
Versión 2011-08 (29 de agosto de 2011)
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
- 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 con OAuth 2.0 como la nueva forma recomendada de autorizar usuarios
- Nueva URL para realizar solicitudes:
https://www.googleapis.com/analytics/v3/management/…
- Respuesta de API más compacta con JSON
- Nuevas bibliotecas cliente de la API de Google que admiten muchos más lenguajes
- Compatibilidad con la API de Google Discovery
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.
Lanzamiento de 2010-08 (18 de agosto de 2010)
Esta es la versión Beta de la API de administración de Google Analytics.
Feeds nuevos
-
Se crearon cinco feeds nuevos para simplificar el acceso a los datos de configuración de la cuenta de Google Analytics:
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.