Log delle modifiche

Per gli annunci ufficiali dell'API Google Analytics, iscriviti a Google Analytics API Notify Group.

2026-06-18 Aggiunto il metodo UpdateReportingIdentitySettings

2026-06-18 Aggiunto il campo can_edit a PropertySummary

  • È stato aggiunto il can_edit campo alla PropertySummary risorsa nell'API Admin v1alpha e v1beta. Questo campo indica se l'utente ha un ruolo Google Analytics che gli consente di modificare le impostazioni della proprietà.

2026-04-14 Aggiunto il metodo GetUserProvidedDataSettings

2025-08-20 Aggiunto il metodo GetReportingIdentitySettings

È stato aggiunto il GetReportingIdentitySettings metodo all'API Admin v1alpha, che consente di recuperare ReportingIdentitySettings per una proprietà.

2025-08-20 Metodi Universal Analytics precedenti rimossi

I seguenti metodi Universal Analytics (UA) precedenti sono stati rimossi dall'API Admin v1alpha: SetAutomatedGa4ConfigurationOptOut, FetchAutomatedGa4ConfigurationOptOut, CreateConnectedSiteTag, DeleteConnectedSiteTag, ListConnectedSiteTags e FetchConnectedGa4Property.

2025-06-12 Aggiunti metodi di gestione della configurazione della sincronizzazione delle sottoproprietà

Sono stati aggiunti i metodi GetSubpropertySyncConfig, ListSubpropertySyncConfige UpdateSubpropertySyncConfig per la gestione delle risorse SubpropertySyncConfig con l'API Admin v1alpha.

2025-04-16 Aggiunti metodi di gestione delle annotazioni dei dati dei report

Sono stati aggiunti i metodi CreateReportingDataAnnotation, GetReportingDataAnnotation, ListReportingDataAnnotations, UpdateReportingDataAnnotation e DeleteReportingDataAnnotation per la gestione delle risorse ReportingDataAnnotation con l'API Admin v1alpha.

Le annotazioni consentono agli utenti di aggiungere note direttamente ai report di Google Analytics, semplificando la registrazione degli eventi, l'interpretazione delle variazioni dei dati o l'evidenziazione di informazioni chiave per te e il tuo team.

2025-03-07 Il parametro sharingWithGoogleAnySalesEnabled verrà ritirato

Il parametro sharingWithGoogleAnySalesEnabled del metodo getDataSharingSettings è ora ritirato e restituirà sempre false. Il campo verrà rimosso dall'API Google Analytics Admin v1beta a giugno 2025.

2025-01-20 Aggiunta la conservazione dei dati utente a DataRetentionSettings

È stato aggiunto il userDataRetention campo a DataRetentionSettings nell' API Admin v1alpha e v1beta. Utilizza questo campo per recuperare o modificare le impostazioni di conservazione dei dati utente.

2024-09-09 Modulo del sondaggio sui report di accesso

La documentazione del runAccessReport metodo è stata aggiornata per includere un link al modulo di feedback sui report di accesso di Google Analytics. Il tuo contributo è molto importante per noi e ti invitiamo a condividere le tue opinioni su questa API per aiutarci a migliorarla ulteriormente.

Sono stati aggiunti i metodi CreateBigQueryLink, UpdateBigQueryLink, e DeleteBigQueryLink per la gestione delle risorse BigQueryLink con l'API Admin v1alpha.

È stato aggiunto il campo dataset_location alla risorsa BigQueryLink.

Sono state aggiunte le modifiche dei collegamenti BigQuery alla cronologia delle modifiche con il nuovo BIGQUERY_LINK valore in ChangeHistoryResourceType.

2024-08-01 Modifica che provoca un errore al metodo createSubproperty

Il metodo personalizzato createSubproperty è stato rinominato in provisionSubproperty nell'API Admin v1alpha per essere in linea con le linee guida dei metodi personalizzati.

2024-08-01 Aggiunta la gestione delle regole di modifica degli eventi

GetEventEditRule, CreateEventEditRule, DeleteEventEditRule, ListEventEditRules, UpdateEventEditRules, ReorderEventEditRules, metodi aggiunti all'API Admin v1alpha.

Una EventEditRule definisce le condizioni che attiveranno la creazione di un evento completamente nuovo in base ai criteri corrispondenti di un evento di origine. Inoltre, una EventEditRule può definire le modifiche dei parametri dell'evento di origine.

2024-08-01 Modifiche varie

È stato aggiunto create_time alla risorsa Audience.

È stato aggiunto primary alla ChannelGroup risorsa per indicare se il gruppo di canali è il gruppo di canali predefinito per i report. In un determinato momento, solo un gruppo di canali può avere primary impostato su true. Se imposti primary su true per un gruppo di canali, primary viene impostato automaticamente su false per il gruppo di canali principale precedente.

È stato aggiunto gmp_organization alla risorsa Account, che contiene l'URI per una risorsa organizzazione Google Marketing Platform se l'account è collegato a un'organizzazione GMP.

2024-05-06 Aggiunti metodi di gestione degli eventi chiave

Le risorse e i metodi per gli eventi chiave sono ora disponibili.

Modifica l'integrazione API per utilizzare KeyEvent anziché ConversionEvent. ConversionEvent è ritirato.

2023-12-15 I report di accesso ai dati sono ora disponibili per tutte le proprietà Google Analytics.

Alcuni campi della funzionalità Report di accesso ai dati sono ora disponibili per tutte le proprietà Google Analytics, sia per i clienti Standard sia per quelli Google Analytics 360.

Per saperne di più, consulta la documentazione dello schema.

2023-12-15 La dimensione accessDateHour è stata aggiunta allo schema dei report di accesso ai dati.

La dimensione accessDateHour è stata aggiunta allo schema dei report di accesso ai dati. Contiene la data e l'ora dell'utente GA che ha eseguito l'accesso ai dati dei report GA.

2023-10-05 Per le proprietà con modelli di attribuzione Primo clic, Lineare, Decadimento temporale e In base alla posizione, per impostazione predefinita viene utilizzata l'attribuzione basata sui dati cross-channel.

A partire da metà ottobre 2023, i modelli di attribuzione Primo clic, Lineare, Decadimento temporale e In base alla posizione non saranno più disponibili per l'utilizzo con il metodo UpdateAttributionSettings per tutte le proprietà.

Se la tua proprietà è attualmente configurata per utilizzare uno di questi modelli, verrà modificata in modo da utilizzare l'attribuzione basata sui dati cross-channel. Potrai comunque utilizzare l'ultimo clic cross-channel o l'ultimo clic Google Ads preferito.

2023-09-01 Aggiunti metodi di configurazione dello schema del valore di conversione di SKAdNetwork.

GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas metodi aggiunti all'API Admin v1alpha.

Questa funzionalità consente di gestire la configurazione dello schema del valore di conversione di SKAdNetwork per uno stream iOS.

2023-09-01 Aggiunto il metodo UpdateConversionEvent.

UpdateConversionEvent metodo aggiunto all'API Admin v1beta.

2023-09-01 Il campo BigQueryLink.enterprise_export_enabled è stato rinominato in fresh_daily_export_enabled.

Il campo enterprise_export_enabled della risorsa BigQueryLink è stato rinominato in fresh_daily_export_enabled.

2023-07-14 Modifiche che provocano un errore ai metodi properties.updateAttributionSettings e properties.getAttributionSettings.

A partire dal 24 luglio 2023, verranno apportate modifiche che provocano un errore all'API Admin v1 alpha, che influiranno sulla funzionalità dei properties.getAttributionSettings e properties.updateAttributionSettings.

I membri dell'ReportingAttributionModel enum verranno rinominati come segue:

Nome precedente Nuovo nome
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

I membri dell'AdsWebConversionDataExportScope enum verranno rinominati come segue:

Nome precedente Nuovo nome
CROSS_CHANNEL PAID_AND_ORGANIC_CHANNELS
ADS_PREFERRED GOOGLE_PAID_CHANNELS

2023-07-10 Aggiunto il campo ads_web_conversion_data_export_scope al tipo AttributionSettings

È stato aggiunto il campo ads_web_conversion_data_export_scope al tipo AttributionSettings che può essere modificato utilizzando il metodo UpdateAttributionSettings.

2023-06-05 Ritiro dei modelli di attribuzione Primo clic, Lineare, Decadimento temporale e In base alla posizione.

A partire da giugno 2023, il metodo UpdateAttributionSettings non potrà essere utilizzato per configurare le proprietà GA4 con i modelli di attribuzione Primo clic, Lineare, Decadimento temporale e In base alla posizione. A partire da settembre 2023, questi modelli non saranno più disponibili per tutte le proprietà.

Per saperne di più, consulta l'annuncio del prodotto Google Analytics.

GetAdSenseLink, CreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinks metodi aggiunti all'API Admin v1alpha.

Questa funzionalità consente di gestire i collegamenti da AdSense ad Analytics per una proprietà GA4.

2023-05-31 Aggiunto un metodo per cercare una proprietà GA4 collegata.

È stato aggiunto il FetchConnectedGa4Property metodo all'API Admin v1alpha.

Questa funzionalità consente di ottenere informazioni su una proprietà GA4 collegata alla tua proprietà Universal Analytics durante la procedura di migrazione a GA4.

2023-05-31 Aggiunto un metodo per gestire le regole di creazione degli eventi.

Sono stati aggiunti i metodi CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules, GetEventCreateRule all'API Admin v1alpha.

Questa funzionalità consente di gestire le regole di creazione degli eventi che possono attivare la creazione di un evento completamente nuovo in base ai criteri corrispondenti di un evento di origine.

2023-05-31 Aggiunti metodi per gestire i gruppi di canali personalizzati.

Sono stati aggiunti i metodi GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup, DeleteChannelGroup all'API Admin v1alpha.

Questa funzionalità consente di gestire i gruppi di canali personalizzati per le sorgenti di traffico del tuo sito web.

Una volta creati, i gruppi di canali personalizzati possono essere sottoposti a query utilizzando l' API di dati di Google Analytics v1.

2023-03-31 Aggiunti metodi di gestione delle impostazioni di misurazione avanzata.

Sono stati aggiunti i metodi properties.dataStreams.updateEnhancedMeasurementSettings, properties.dataStreams.getEnhancedMeasurementSettings all'API Admin v1alpha.

Questa funzionalità consente di gestire le impostazioni di misurazione avanzata per uno stream di dati web di una proprietà GA4.

2023-03-31 Aggiunti metodi di gestione dei tag del sito collegati.

Sono stati aggiunti i metodi properties.createConnectedSiteTag, properties.deleteConnectedSiteTag, properties.listConnectedSiteTags all'API Admin v1alpha.

Questa funzionalità consente di gestire i tag del sito collegati ed è utile per inoltrare il traffico da una proprietà Universal Analytics a una proprietà Google Analytics 4.

2023-03-31 Aggiunti metodi runAccessReport a livello di account e proprietà all'API Admin v1beta.

Sono stati aggiunti i metodi properties.runAccessReport e accounts.runAccessReport alla versione v1beta dell'API Admin. I metodi restituiscono un report personalizzato dei record di accesso ai dati.

2023-02-24 Aggiunti metodi di gestione dei set di dati espansi.

La risorsa ExpandedDataSet è stata aggiunta alla versione v1alpha dell'API, insieme alle operazioni properties.expandedDataSets.create, properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list, properties.expandedDataSets.get corrispondenti. Questa funzionalità può essere utilizzata per la gestione dei set di dati espansi in Google Analytics 360.

La AccessBinding risorsa è stata aggiunta alla versione v1alpha dell'API, insieme alle seguenti operazioni:

Questa funzionalità consente di gestire le autorizzazioni utente per un account o una proprietà GA4 e deve essere utilizzata al posto dei link utente.

La funzionalità Link utente verrà rimossa dall'API Admin v1 alpha il 1° giugno 2023

2023-02-24 Ritiro dei metodi di audit delle autorizzazioni utente.

I seguenti metodi sono ritirati e verranno rimossi dall'API Admin v1 alpha il 1° giugno 2023:

2023-02-24 Aggiunti metodi di gestione dei segmenti di pubblico.

La Audience risorsa è stata aggiunta alla versione v1alpha dell'API, insieme alle operazioni properties.audience.create, properties.audience.archive, properties.audience.patch, properties.audience.list, properties.audience.get corrispondenti.

Questa funzionalità consente di gestire i segmenti di pubblico per una proprietà GA4.

2023-02-15 Aggiunti metodi di disattivazione della procedura di configurazione automatica di GA4.

Le operazioni properties.setAutomatedGa4ConfigurationOptOut, properties.fetchAutomatedGa4ConfigurationOptOut sono state aggiunte alla versione v1alpha dell'API.

Questa funzionalità consente di gestire lo stato di disattivazione della procedura di configurazione automatica di GA4 per una proprietà UA.

La BigQueryLink risorsa è stata aggiunta alla versione v1alpha dell'API, insieme alle operazioni properties.bigQueryLinks.get, properties.bigQueryLinks.list corrispondenti.

Questa funzionalità consente di recuperare informazioni sui collegamenti tra una proprietà GA4 e un progetto BigQuery.

La risorsa SearchAds360Link è stata aggiunta alla versione v1alpha dell'API, insieme alle operazioni properties.searchAds360Links.create, properties.searchAds360Links.delete, properties.searchAds360Links.patch, properties.searchAds360Links.list, properties.searchAds360Links.get corrispondenti.

Questa funzionalità consente di gestire i collegamenti tra una proprietà GA4 e un'entità Search Ads 360.

2023-02-15 Modifiche che provocano un errore.

2023-02-15 Modifiche varie.

2022-08-11 Il metodo runAccessReport è stato aggiunto all'API Admin v1alpha.

Il properties.runAccessReport metodo è stato aggiunto alla versione v1alpha dell'API Admin. Restituisce un report personalizzato dei record di accesso ai dati. Il report fornisce record di ogni volta che un utente legge i dati dei report di Google Analytics. I report di accesso ai dati sono disponibili per gli amministratori delle proprietà Google Analytics 360.

2022-07-11 Rilasciata la versione v1beta dell'API Admin.

È stata rilasciata la versione v1beta dell'API Google Analytics Admin.

Entrambi i canali Alpha e Beta dell'API continuano a essere supportati per l'API Admin. Il canale Beta contiene un sottoinsieme delle funzionalità disponibili in Alpha, considerate stabili e che non dovrebbero subire modifiche significative in futuro. Le nuove funzionalità verranno aggiunte alla versione beta una volta che saranno mature.

2021-10-12 I metodi EnhancedMeasurementSettings sono stati rimossi dall'API.

  • properties.webDataStreams.getEnhancedMeasurementSettings, properties.webDataStreams.updateEnhancedMeasurementSettings metodi sono rimossi dall'API, ma le impostazioni di misurazione avanzata saranno nuovamente modificabili tramite API a breve.
  • Il campo directRoles della risorsa UserLink non supporta più il ruolo predefinedRoles/manage-users. Al suo posto, deve essere utilizzato il nuovo ruolo predefinedRoles/admin, che è equivalente alla combinazione dei vecchi ruoli predefinedRoles/edit e predefinedRoles/manage-users. Questa modifica influisce sul comportamento dei accounts.userLinks, properties.userLinks metodi ed è in linea con le modifiche alla gestione delle restrizioni relative a dati e accessi introdotte in Google Analytics.

2021-06-05 Funzionalità aggiunte.

Le seguenti funzionalità sono state aggiunte all'API:

  • accounts.searchChangeHistoryEvents È stato aggiunto il metodo all'API. Questo metodo esegue una ricerca in tutte le modifiche apportate a un account o ai relativi elementi secondari in base al set di filtri specificato. Le cause comuni sono gli aggiornamenti apportati nell'interfaccia utente di Google Analytics, le modifiche apportate dall'assistenza clienti o le modifiche automatiche del sistema Google Analytics.
  • Sono stati aggiunti metodi di gestione dei secret di Measurement Protocol in properties.dataStreams.measurementProtocolSecrets:
    • create Crea un secret di Measurement Protocol.
    • delete Elimina il secret di Measurement Protocol di destinazione.
    • get Cerca un singolo secret di Measurement Protocol.
    • list Restituisce i secret di Measurement Protocol secondari nella proprietà principale specificata.
    • patch Aggiorna un secret di Measurement Protocol.
  • Sono stati aggiunti metodi di gestione degli eventi di conversione in properties.conversionEvents:
    • create Crea un evento di conversione con gli attributi specificati.
    • delete Elimina un evento di conversione in una proprietà.
    • get Recupera un singolo evento di conversione.
    • list Restituisce un elenco di eventi di conversione nella proprietà principale specificata.
  • Sono stati aggiunti metodi di gestione delle dimensioni personalizzate in properties.customDimensions:
    • archive Archivia una dimensione personalizzata in una proprietà.
    • create Crea una dimensione personalizzata.
    • get Cerca una singola dimensione personalizzata.
    • list Elenca le dimensioni personalizzate in una proprietà.
    • patch Aggiorna una dimensione personalizzata in una proprietà.
  • Sono stati aggiunti metodi di gestione delle metriche personalizzate in properties.customMetrics:
    • archive Archivia una metrica personalizzata in una proprietà.
    • create Crea una metrica personalizzata.
    • get Cerca una singola metrica personalizzata.
    • list Elenca le metriche personalizzate in una proprietà.
    • patch Aggiorna una metrica personalizzata in una proprietà.
  • Sono stati aggiunti i metodi properties.getGoogleSignalsSettings, properties.updateGoogleSignalsSettings che consentono di controllare l'impostazione Google Signals per una proprietà Google Analytics 4.
  • Sono stati aggiunti i campi di solo output delete_time, expire_time al tipo Property.

2021-06-05 Modifiche che provocano un errore.

Sono state introdotte le seguenti modifiche che provocano un errore:

  • I metodi properties.iosAppDataStreams.create, properties.androidAppDataStreams.create sono stati rimossi dall'API. Utilizza Firebase per creare stream di applicazioni in una proprietà Google Analytics 4.
  • properties.delete metodo ora restituisce i dati della proprietà eliminata come Property tipo anziché una risposta vuota.
  • time_zone campo del tipo Property è ora obbligatorio.
  • Il campo deleted è stato rimosso dal Property tipo.
  • email_address campo del tipo UserLink è ora immutabile.
  • name campo del UserLink tipo è ora di solo output.

2021-01-28 Modifiche che provocano un errore.

Modifiche che provocano un errore: - Il campo update_mask è obbligatorio per tutte le operazioni Update.

  • Il campo country_code è stato rinominato in region_code in Account.

  • Il campo url_query_parameter è stato rinominato in uri_query_parameter in EnhancedMeasurementSettings.

  • Il campo parent è stato rimosso da GoogleAdsLink.

2020-10-20 Aggiunto il supporto per i riepiloghi degli account.

È stato aggiunto il supporto per il metodo dei riepiloghi degli account.

2020-10-13 Le proprietà App + Web sono state rinominate in Google Analytics 4 (GA4).

2020-08-15 L'API App + Web di gestione è stata rinominata in API Admin.

L'API App + Web di gestione di Google Analytics è stata rinominata in API Google Analytics Admin. Di conseguenza, l'endpoint API è stato modificato in analyticsadmin.googleapis.com. Il codice esistente scritto in base alla versione precedente dell'URL dell'endpoint API e delle librerie client deve essere aggiornato di conseguenza.