Se usó la API de Cloud Translation para traducir esta página.

Registro de cambios

Para ver los anuncios oficiales de la API de Google Analytics, suscríbete al grupo de notificaciones de la API de Google Analytics.

2025-01-20 Se agregó la retención de datos del usuario a `DataRetentionSettings`.

Se agregó el campo userDataRetention a DataRetentionSettings en las versiones v1alpha y v1beta de la API de Admin. Usa este campo para recuperar o modificar la configuración de retención de los datos del usuario.

2024-09-09 Formulario de la encuesta sobre los informes de acceso

Se actualizó la documentación del método runAccessReport para incluir un vínculo al formulario de comentarios sobre los informes de acceso de Google Analytics. Valoramos tus comentarios y te recomendamos que compartas tu opinión sobre esta API para ayudarnos a mejorarla.

2024-08-01 Se agregó la administración de vínculos de BigQuery.

Se agregaron los métodos CreateBigQueryLink, UpdateBigQueryLink y DeleteBigQueryLink para administrar recursos de BigQueryLink con la API de Admin v1alpha.

Se agregó el campo dataset_location al recurso BigQueryLink.

Se agregaron cambios de vinculación de BigQuery al historial de cambios en el nuevo valor BIGQUERY_LINK de ChangeHistoryResourceType.

2024-08-01 Cambio rotundo en el método `createSubproperty`

Se cambió el nombre del método personalizado createSubproperty a provisionSubproperty en la API de Admin v1alpha para alinearse con los lineamientos del método personalizado.

2024-08-01 Se agregó la administración de reglas de edición de eventos.

Se agregaron los métodos GetEventEditRule, CreateEventEditRule, DeleteEventEditRule, ListEventEditRules, UpdateEventEditRules y ReorderEventEditRules a la API de Admin v1alpha.

Un EventEditRule define las condiciones que activarán la creación de un evento completamente nuevo según los criterios coincidentes de un evento fuente. Además, un EventEditRule puede definir modificaciones de los parámetros del evento de origen.

2024-08-01 Cambios varios

Se agregó create_time al recurso Audience.

Se agregó primary al recurso ChannelGroup para indicar si el grupo de canales es el predeterminado para los informes. Solo un grupo de canales puede tener primary configurado como true en un momento determinado. Si configuras primary como true para un grupo de canales, se establece automáticamente primary como false para el grupo de canales principal anterior.

Se agregó gmp_organization al recurso Account, que contiene el URI de un recurso de organización de Google Marketing Platform si la cuenta está conectada a una organización de GMP.

2024-05-06 Se agregaron métodos de administración de eventos de teclas.

Los recursos y métodos para los eventos clave ya están disponibles.

Modifica tu integración de API para usar KeyEvent en lugar de ConversionEvent. ConversionEvent dejó de estar disponible.

15/12/2023 Los informes de acceso a los datos ya están disponibles para todas las propiedades de Google Analytics.

Ciertos campos de la función Informes de acceso a los datos ahora están disponibles para todas las propiedades de Google Analytics, tanto para los clientes estándar como para los de Google Analytics 360.

Consulta la documentación del esquema para obtener más información.

15/12/2023: Se agregó la dimensión `accessDateHour` al esquema del informe de acceso a los datos.

La dimensión accessDateHour se agregó al esquema del informe de acceso a los datos. Contiene la fecha y la hora del usuario de GA que accedió a los datos de informes de GA.

2023-10-05 Las propiedades con modelos de atribución lineal, de primer clic, de decaimiento temporal y según la posición tendrán la DDA de varios canales de forma predeterminada.

A partir de mediados de octubre de 2023, los modelos de atribución de primer clic, lineal, decaimiento temporal y según la posición dejarán de estar disponibles para usarse con el método UpdateAttributionSettings en todas las propiedades.

Si tu propiedad está configurada para usar uno de estos modelos, se cambiará a la atribución basada en datos de varios canales. Seguirás teniendo la opción de usar el último clic en múltiples canales o la preferencia por último clic de Google Ads.

01/09/2023 Se agregaron métodos de configuración del esquema de valor de conversión de SKAdNetwork.

Se agregaron los métodos GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema y ListSKAdNetworkConversionValueSchemas a la API de Admin v1alpha.

Esta funcionalidad permite administrar la configuración del esquema de valor de conversión de SKAdNetwork para un flujo de iOS.

2023-09-01 Se agregó el método `UpdateConversionEvent`.

Se agregó el método UpdateConversionEvent a la API de Admin v1beta.

01-09-2023 Se cambió el nombre del campo `BigQueryLink.enterprise_export_enabled` a `fresh_daily_export_enabled`.

Se cambió el nombre del campo enterprise_export_enabled del recurso BigQueryLink a fresh_daily_export_enabled.

2023-07-14 Cambios rotundos en los métodos `properties.updateAttributionSettings` y `properties.getAttributionSettings`.

A partir del 24 de julio de 2023, se realizarán cambios drásticos en la API de Admin v1alpha que afectarán la funcionalidad de los métodos properties.getAttributionSettings y properties.updateAttributionSettings.

Se cambiará el nombre de los miembros de la enumeración ReportingAttributionModel a los siguientes:

Nombre anterior	Nombre nuevo
`CROSS_CHANNEL_DATA_DRIVEN`	`PAID_AND_ORGANIC_CHANNELS_DATA_DRIVEN`
`CROSS_CHANNEL_LAST_CLICK`	`PAID_AND_ORGANIC_CHANNELS_LAST_CLICK`
`CROSS_CHANNEL_FIRST_CLICK`	`PAID_AND_ORGANIC_CHANNELS_FIRST_CLICK`
`CROSS_CHANNEL_LINEAR`	`PAID_AND_ORGANIC_CHANNELS_LINEAR`
`CROSS_CHANNEL_POSITION_BASED`	`PAID_AND_ORGANIC_CHANNELS_POSITION_BASED`
`CROSS_CHANNEL_TIME_DECAY`	`PAID_AND_ORGANIC_CHANNELS_TIME_DECAY`
`ADS_PREFERRED_LAST_CLICK`	`GOOGLE_PAID_CHANNELS_LAST_CLICK`

Se cambiará el nombre de los miembros de la enumeración AdsWebConversionDataExportScope a los siguientes:

Nombre anterior	Nombre nuevo
`CROSS_CHANNEL`	`PAID_AND_ORGANIC_CHANNELS`
`ADS_PREFERRED`	`GOOGLE_PAID_CHANNELS`

2023-07-10 Se agregó el campo `ads_web_conversion_data_export_scope` al tipo `AttributionSettings`.

Se agregó el campo ads_web_conversion_data_export_scope al tipo AttributionSettings, que se puede modificar con el método UpdateAttributionSettings.

05/06/2023 Baja de los modelos de atribución lineal, de primer clic, de decaimiento temporal y según la posición.

A partir de junio de 2023, no se podrá usar el método UpdateAttributionSettings para configurar propiedades GA4 con modelos de atribución de primer clic, lineal, de decaimiento temporal y según la posición. A partir de septiembre de 2023, estos modelos dejarán de estar disponibles para todas las propiedades.

Consulta el anuncio del producto Google Analytics para obtener más información.

31/05/2023 Se agregaron métodos de administración de vínculos de AdSense.

Se agregaron los métodos GetAdSenseLink, CreateAdSenseLink, DeleteAdSenseLink y ListAdSenseLinks a la API de Admin v1alpha.

Esta función permite administrar las vinculaciones de AdSense a Analytics para una propiedad GA4.

31/05/2023 Se agregó un método para buscar una propiedad GA4 conectada.

Se agregó el método FetchConnectedGa4Property a la API de Admin v1alpha.

Esta función permite obtener información sobre una propiedad GA4 vinculada a tu propiedad Universal Analytics durante el proceso de migración a GA4.

31/05/2023 Se agregó un método para administrar las reglas de creación de eventos.

Se agregaron los métodos CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules y GetEventCreateRule a la API de Admin v1alpha.

Esta funcionalidad permite administrar reglas de creación de eventos que pueden activar la creación de un evento completamente nuevo según los criterios coincidentes de un evento de origen.

31/05/2023 Se agregaron métodos para administrar grupos de canales personalizados.

Se agregaron los métodos GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup y DeleteChannelGroup a la API de Admin v1alpha.

Esta función permite administrar grupos de canales personalizados para las fuentes de tráfico de tu sitio web.

Una vez creados, los grupos de canales personalizados se pueden consultar con la versión 1 de la API de Google Analytics Data.

31/03/2023 Se agregaron métodos de administración de la configuración de medición optimizada.

Se agregaron los métodos properties.dataStreams.updateEnhancedMeasurementSettings y properties.dataStreams.getEnhancedMeasurementSettings a la API de Admin v1alpha.

Esta función permite administrar la configuración de la medición optimizada para un flujo de datos web de una propiedad GA4.

31/03/2023 Se agregaron métodos de administración de etiquetas conectadas del sitio.

Se agregaron los métodos properties.createConnectedSiteTag, properties.deleteConnectedSiteTag y properties.listConnectedSiteTags a la API de Admin v1alpha.

Esta función permite administrar las etiquetas conectadas del sitio y es útil para reenviar tráfico de una propiedad Universal Analytics a una propiedad Google Analytics 4.

31/3/2023 Se agregaron métodos `runAccessReport` a nivel de la cuenta y de la propiedad a la versión 1beta de la API de Admin.

Se agregaron los métodos properties.runAccessReport y accounts.runAccessReport a la versión v1beta de la API de Admin. Los métodos muestran un informe personalizado de registros de acceso a los datos.

2023-02-24 Se agregaron métodos de administración de conjuntos de datos expandidos.

Se agregó el recurso ExpandedDataSet a la versión v1alpha de la API, junto con las operaciones correspondientes de properties.expandedDataSets.create, properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list y properties.expandedDataSets.get. Esta funcionalidad se puede usar para administrar los conjuntos de datos expandidos en Google Analytics 360.

2023-02-24 Las vinculaciones de acceso reemplazarán a los vínculos de usuario para la administración de permisos de los usuarios.

Se agregó el recurso AccessBinding a la versión v1alpha de la API, junto con las siguientes operaciones:

Esta función permite administrar los permisos de los usuarios de una cuenta o una propiedad de GA4 y se debe usar en lugar de las Vinculaciones de usuarios.

La funcionalidad de Vínculos de usuario se quitará de la versión alfa de la API de Admin v1 el 1/6/23

2023-02-24 Baja de los métodos de auditoría de permisos de los usuarios.

Los siguientes métodos dejaron de estar disponibles y se quitarán de la API de Admin v1alpha el 1/6/23:

2023-02-24 Se agregaron métodos de administración de públicos.

Se agregó el recurso Audience a la versión v1alpha de la API, junto con las operaciones correspondientes de properties.audience.create, properties.audience.archive, properties.audience.patch, properties.audience.list y properties.audience.get.

Esta función permite administrar los públicos de una propiedad GA4.

15/02/2023 Se agregaron métodos para inhabilitar el proceso de configuración automática de GA4.

Se agregaron las operaciones properties.setAutomatedGa4ConfigurationOptOut y properties.fetchAutomatedGa4ConfigurationOptOut a la versión v1alpha de la API.

Esta función permite administrar el estado de inhabilitación del proceso de configuración automática de GA4 para una propiedad UA.

2023-02-15 Se agregaron métodos de administración de vínculos de BigQuery.

Se agregó el recurso BigQueryLink a la versión v1alpha de la API, junto con las operaciones properties.bigQueryLinks.get y properties.bigQueryLinks.list correspondientes.

Esta función permite recuperar información sobre los vínculos entre una propiedad GA4 y un proyecto de BigQuery.

15/02/2023 Se agregaron métodos de administración de vínculos de Search Ads 360.

Se agregó el recurso SearchAds360Link a la versión v1alpha de la API, junto con las operaciones correspondientes de properties.searchAds360Links.create, properties.searchAds360Links.delete, properties.searchAds360Links.patch, properties.searchAds360Links.list y properties.searchAds360Links.get.

Esta función permite administrar las vinculaciones entre una propiedad GA4 y una entidad de Search Ads 360.

2023-02-15 Cambios rotundos.

Se quitaron los valores LESS_THAN_OR_EQUAL y GREATER_THAN_OR_EQUAL de la enumeración NumericFilter.Operation.
Se quitó el valor PARTIAL_REGEXP de la enumeración StringFilter.MatchType.

2023-02-15 Se realizaron cambios varios.

Se agregó el campo tokensPerProjectPerHour al tipo AccessQuota.
Se agregaron los valores EXPANDED_DATA_SET y CHANNEL_GROUP a la enumeración ChangeHistoryResourceType.
Se agregaron valores searchAds360Link, expandedDataSet y bigqueryLink a ChangeHistoryResource.

11/08/2022 Se agregó el método `runAccessReport` a la API de Admin v1alpha.

Se agregó el método properties.runAccessReport a la versión v1alpha de la API de Admin. Muestra un informe personalizado de los registros de acceso a los datos. El informe proporciona registros de cada vez que un usuario lee los datos de informes de Google Analytics. Los informes de acceso a los datos están disponibles para los administradores de las propiedades de Google Analytics 360.

2022-07-11 Se lanzó la versión v1beta de la API de Admin.

Se lanzó la versión v1beta de la API de Google Analytics Admin.

Los canales alfa y beta de la API siguen siendo compatibles con la API de Admin. El canal beta contiene un subconjunto de las funciones disponibles en Alfa, que se consideran estables y no se espera que experimenten un cambio significativo en el futuro. Las funciones nuevas se agregarán a la versión beta una vez que estén más desarrolladas.

12/10/2021 Se quitaron los métodos EnhancedMeasurementSettings de la API.

Los métodos properties.webDataStreams.getEnhancedMeasurementSettings y properties.webDataStreams.updateEnhancedMeasurementSettings se quitaron de la API, pero la configuración de Measurements Enhanced volverá a poder modificarse a través de la API pronto.
El campo directRoles del recurso UserLink ya no admite el rol predefinedRoles/manage-users. En su lugar, se debe usar el nuevo rol predefinedRoles/admin, que equivale a la combinación de los roles predefinedRoles/edit y predefinedRoles/manage-users anteriores. Este cambio afecta el comportamiento de los métodos accounts.userLinks y properties.userLinks, y está alineado con los cambios en la administración de accesos y restricciones de datos que se introdujeron en Google Analytics.

2021-06-05 Se agregaron funciones.

Se agregaron las siguientes funciones a la API:

Se agregó el método accounts.searchChangeHistoryEvents a la API. Este método busca todos los cambios en una cuenta o sus elementos secundarios según el conjunto de filtros especificado. Las causas comunes son las actualizaciones realizadas en la IU de Google Analytics, los cambios realizados por el equipo de asistencia al cliente o los cambios automáticos del sistema de Google Analytics.
Se agregaron métodos de administración de secretos del Protocolo de medición en properties.webDataStreams.measurementProtocolSecrets:
- create Crea un secreto de protocolo de medición.
- delete Borra el secreto del Protocolo de medición de destino.
- get Busca un solo secreto del Protocolo de medición.
- list Devuelve los secretos del Protocolo de medición secundarios en la propiedad superior especificada.
- patch Actualiza un secreto del Protocolo de medición.
Se agregaron métodos de administración de eventos de conversión en properties.conversionEvents:
- create Crea un evento de conversión con los atributos especificados.
- delete Borra un evento de conversión en una propiedad.
- get Recupera un solo evento de conversión.
- list Muestra una lista de eventos de conversión en la propiedad superior especificada.
Se agregaron métodos de administración de dimensiones personalizadas en properties.customDimensions:
- archive Archiva una dimensión personalizada en una propiedad.
- create Crea una dimensión personalizada.
- get Busca una sola dimensión personalizada.
- list Enumera las dimensiones personalizadas de una propiedad.
- patch Actualiza una dimensión personalizada en una propiedad.
Se agregaron métodos de administración de métricas personalizadas en properties.customMetrics:
- archive Archiva una métrica personalizada en una propiedad.
- create crea una métrica personalizada.
- get Busca una sola métrica personalizada.
- list Enumera las métricas personalizadas de una propiedad.
- patch Actualiza una métrica personalizada en una propiedad.
Se agregaron los métodos properties.getGoogleSignalsSettings y properties.updateGoogleSignalsSettings, que permiten controlar la configuración de los indicadores de Google para una propiedad Google Analytics 4.
delete_time y expire_time solo muestran los campos agregados al tipo Property.

2021-06-05 Cambios rotundos.

Se introdujeron los siguientes cambios rotundos:

Se quitaron los métodos properties.iosAppDataStreams.create y properties.androidAppDataStreams.create de la API. Utiliza Firebase para crear flujos de aplicaciones en una propiedad Google Analytics 4.
El método properties.delete ahora muestra los datos de la propiedad borrada como tipo Property en lugar de mostrar una respuesta vacía.
Ahora se requiere el campo time_zone del tipo Property.
Se quitó el campo deleted del tipo Property.
El campo email_address del tipo UserLink ahora es inmutable.
El campo name del tipo UserLink ahora es solo de salida.

2021-01-28 Se agregó compatibilidad con la paginación para la operación `ListFirebaseLinks`.

2021-01-28 Cambios rotundos.

Cambios rotundos: - El campo update_mask es obligatorio para todas las operaciones de actualización.

Se cambió el nombre del campo country_code a region_code en Account.
Se cambió el nombre del campo url_query_parameter a uri_query_parameter en EnhancedMeasurementSettings.
Se quitó el campo parent de GoogleAdsLink.

2020-10-20 Se agregó compatibilidad con los resúmenes de cuentas.

Se agregó compatibilidad con el método account summaries.

13/10/2020: Se cambió el nombre de las propiedades App + Web a Google Analytics 4 (GA4).

15/08/2020 Se cambió el nombre de la app de administración y la API web a API de administrador.

Se cambió el nombre de la API de App + Web de Google Analytics Management a API de Google Analytics Admin. Como resultado, el extremo de la API cambió a analticsadmin.googleapis.com. El código existente escrito para la versión anterior de la URL del extremo de la API y las bibliotecas cliente debe actualizarse según corresponda.