Registro de cambios

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

2025-08-20 Se agregó el método GetReportingIdentitySettings

Se agregó el método GetReportingIdentitySettings a la API de Admin v1alpha, que te permite recuperar el objeto ReportingIdentitySettings de una propiedad.

2025-08-20 Se quitaron los métodos heredados de Universal Analytics

Se quitaron los siguientes métodos heredados de Universal Analytics (UA) de la API de Admin v1alpha: SetAutomatedGa4ConfigurationOptOut, FetchAutomatedGa4ConfigurationOptOut, CreateConnectedSiteTag, DeleteConnectedSiteTag, ListConnectedSiteTags y FetchConnectedGa4Property.

2025-06-12 Se agregaron métodos de administración de la configuración de sincronización de subpropiedades

Se agregaron los métodos GetSubpropertySyncConfig, ListSubpropertySyncConfig y UpdateSubpropertySyncConfig para administrar los recursos SubpropertySyncConfig con la API de Admin v1alpha.

2025-04-16 Se agregaron métodos de administración de anotaciones de datos de informes

Se agregaron los métodos CreateReportingDataAnnotation, GetReportingDataAnnotation, ListReportingDataAnnotations, UpdateReportingDataAnnotation y DeleteReportingDataAnnotation para administrar los recursos ReportingDataAnnotation con la API de Admin v1alpha.

Las anotaciones permiten que los usuarios agreguen notas directamente a los informes de Google Analytics, lo que facilita el registro de eventos, la explicación de los cambios en los datos o el destaque de las observaciones clave para ti y tu equipo.

2025-03-07 Baja del parámetro sharingWithGoogleAnySalesEnabled

El parámetro sharingWithGoogleAnySalesEnabled del método getDataSharingSettings dejó de estar disponible y siempre devolverá false. El campo se quitará de la versión 1beta de la API de Google Analytics Admin en junio de 2025.

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 encuesta de 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 tus opiniones sobre esta API para ayudarnos a mejorarla aún más.

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

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

Se agregó el campo dataset_location al recurso BigQueryLink.

Se agregaron cambios en la vinculación de BigQuery al historial de cambios en el nuevo valor BIGQUERY_LINK en 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 de métodos personalizados.

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

GetEventEditRule, CreateEventEditRule, DeleteEventEditRule, ListEventEditRules, UpdateEventEditRules, ReorderEventEditRules, métodos agregados a la API de Admin v1alpha.

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

2024-08-01 Modificaciones varias

Se agregó create_time al recurso Audience.

Se agregó primary al recurso ChannelGroup para indicar si el grupo de canales es el grupo de canales predeterminado para los informes. Solo un grupo de canales puede tener primary establecido en true en un momento determinado. Si configuras primary como true para un grupo de canales, automáticamente se establece 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 clave

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

Modifica tu integración de la API para usar KeyEvent en lugar de ConversionEvent. ConversionEvent ya no está disponible.

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

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

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

2023-12-15 Se agregó la dimensión accessDateHour al esquema del informe de Acceso a los datos.

Se agregó la dimensión accessDateHour 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 de primer clic, lineal, de decaimiento temporal y según la posición se establecen de forma predeterminada en la DDA en múltiples canales.

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

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

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

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

Esta función permite administrar la configuración del esquema de valores de conversión de SKAdNetwork para una transmisión de iOS.

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

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

El campo BigQueryLink.enterprise_export_enabled del 1/9/2023 se cambió 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 que generarán interrupciones en la versión alfa de la API de Admin v1, lo que afectará la funcionalidad de los métodos properties.getAttributionSettings y properties.updateAttributionSettings.

Los miembros de la enumeración ReportingAttributionModel se renombrarán de la siguiente manera:

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

Los miembros de la enumeración AdsWebConversionDataExportScope se renombrarán de la siguiente manera:

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.

2023-06-05 Se descontinúan los modelos de atribución de primer clic, lineal, 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 los modelos de atribución de primer clic, lineal, 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 de Google Analytics para obtener más información.

2023-05-31 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.

2023-05-31 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.

2023-05-31 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 función 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 fuente.

31/5/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 API de Google Analytics Data v1.

2023-03-31 Se agregaron métodos de administración de la configuración de la 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.

2023-03-31 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 de sitios conectados 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 beta de la API de Admin v1beta.

Se agregaron los métodos properties.runAccessReport y accounts.runAccessReport a la versión v1beta de la API de Admin. Los métodos devuelven un informe personalizado de los 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 properties.expandedDataSets.create, properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list y properties.expandedDataSets.get correspondientes. Esta funcionalidad se puede usar para administrar los conjuntos de datos expandidos en Google Analytics 360.

2023-02-24 Los Access Bindings reemplazarán a los User Links para la administración de permisos de usuarios.

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

• accounts.accessBindings.create
• accounts.accessBindings.delete
• accounts.accessBindings.patch
• accounts.accessBindings.list
• accounts.accessBindings.get
• accounts.accessBindings.batchCreate
• accounts.accessBindings.batchDelete
• accounts.accessBindings.batchUpdate
• accounts.accessBindings.batchGet
• properties.accessBindings.create
• properties.accessBindings.delete
• properties.accessBindings.patch
• properties.accessBindings.list
• properties.accessBindings.get
• properties.accessBindings.batchCreate
• properties.accessBindings.batchDelete
• properties.accessBindings.batchUpdate
• properties.accessBindings.batchGet

Esta función permite administrar los permisos de usuario para una cuenta o propiedad de GA4, y se debe usar en lugar de User Links.

Se quitará la función User Links de la versión alfa de la API de Admin v1 el 1/6/23

2023-02-24 Se dejaron de usar los métodos de auditoría de permisos del usuario.

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

• accounts.userLinks.audit
• properties.userLinks.audit

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 properties.audience.create, properties.audience.archive, properties.audience.patch, properties.audience.list y properties.audience.get correspondientes.

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

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

Se agregaron 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 las vinculaciones entre una propiedad GA4 y un proyecto de BigQuery.

2023-02-15 Se agregaron métodos de administración de vinculaciones con Search Ads 360.

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

Esta función permite administrar los vínculos entre una propiedad GA4 y una entidad de Search Ads 360.

15/2/2023: Se realizaron 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 varios cambios.

• 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 los valores searchAds360Link, expandedDataSet y bigqueryLink a ChangeHistoryResource.

2022-08-11 Se agregó el método runAccessReport a la versión 1alpha de la API de Admin.

Se agregó el método properties.runAccessReport a la versión v1alpha de la API de Admin. Devuelve 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.

Se sigue admitiendo tanto el canal alfa como el beta de la API de Admin. El canal beta contiene un subconjunto de las funciones disponibles en la versión alfa que se consideran estables y no se espera que sufran cambios significativos en el futuro. Las funciones nuevas se agregarán a la versión beta cuando estén listas.

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

• Se quitaron los métodos properties.webDataStreams.getEnhancedMeasurementSettings y properties.webDataStreams.updateEnhancedMeasurementSettings de la API, pero la configuración de Medición mejorada volverá a ser modificable 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 es equivalente a la combinación de los roles anteriores predefinedRoles/edit y predefinedRoles/manage-users. Este cambio afecta el comportamiento de los métodos accounts.userLinks y properties.userLinks, y se alinea 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 realizados en una cuenta o sus cuentas secundarias según el conjunto de filtros especificado. Las causas comunes serían las actualizaciones realizadas en la IU de Google Analytics, los cambios del 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 del 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 de la propiedad principal 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 Devuelve una lista de eventos de conversión en la propiedad principal 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 Búsqueda de 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 Búsqueda de 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 el parámetro de configuración de los indicadores de Google para una propiedad Google Analytics 4.
• delete_time, campos de solo salida expire_time 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 devuelve los datos de la propiedad borrada como un tipo Property en lugar de devolver 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.

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

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

Se cambió el nombre de la API de Google Analytics Management App + Web a la API de Google Analytics Admin. Como resultado, el extremo de la API cambió a analyticsadmin.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.