Log delle modifiche

Per gli annunci ufficiali relativi all'API Google Analytics, iscriviti al gruppo di notifica dell'API Google Analytics.

20/01/2025 È stata aggiunta la conservazione dei dati utente a DataRetentionSettings

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

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

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

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

È stato aggiunto il campo dataset_location alla risorsa BigQueryLink.

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

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

Il metodo personalizzato createSubproperty è stato rinominato provisionSubproperty nell'API Admin v1alpha per allinearsi alle linee guida per i metodi personalizzati.

01-08-2024 È stata aggiunta la gestione delle regole di modifica degli eventi

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

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

01-08-2024 Modifiche varie

create_time è stato aggiunto alla risorsa Audience.

È stato aggiunto primary alla risorsa ChannelGroup per indicare se il gruppo di canali è quello 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 di una risorsa organizzazione Google Marketing Platform se l'account è collegato a un'organizzazione GMP.

06/05/2024 Sono stati aggiunti metodi di gestione degli eventi chiave

Sono ora disponibili risorse e metodi per gli eventi chiave.

Modifica l'integrazione dell'API in modo da utilizzare KeyEvent anziché ConversionEvent. ConversionEvent è deprecato.

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

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

Per ulteriori informazioni, consulta la documentazione dello schema.

15-12-2023 La dimensione accessDateHour aggiunta allo schema del report Accesso ai dati.

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

05-10-2023 Per le proprietà con modelli di attribuzione Primo clic, Lineare, Decadimento temporale e In base alla posizione, per impostazione predefinita viene utilizzato il modello DDA cross-channel.

A partire da metà ottobre 2023, i modelli di attribuzione Primo clic, Lineare, Decadimento temporale e In base alla posizione non potranno essere utilizzati con il metodo UpdateAttributionSettings per tutte le proprietà.

Se la tua proprietà è attualmente configurata per utilizzare uno di questi modelli, verrà modificata in attribuzione basata sui dati cross-channel. Avrai comunque la possibilità di utilizzare Ultimo clic cross-channel o Ultimo clic Google Ads preferito.

1° settembre 2023 Sono stati aggiunti i 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 per iOS.

01-09-2023 È stato aggiunto il metodo UpdateConversionEvent.

Metodo UpdateConversionEvent aggiunto all'API Admin v1beta.

01-09-2023 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.

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

A partire dal 24 luglio 2023 verranno apportate modifiche non compatibili all'API Admin v1 alpha che influiranno sulla funzionalità dei metodi properties.getAttributionSettings e properties.updateAttributionSettings.

I membri dell'enum ReportingAttributionModel subiranno la seguente ridenominazione:

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'enum AdsWebConversionDataExportScope subiranno la seguente ridenominazione:

Nome precedente Nuovo nome
CROSS_CHANNEL PAID_AND_ORGANIC_CHANNELS
ADS_PREFERRED GOOGLE_PAID_CHANNELS

10/07/2023 È stato 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.

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

A partire da giugno 2023, il metodo UpdateAttributionSettings non può essere utilizzato per configurare le proprietà GA4 con primo-clic, lineare, decadimento-temporale e in base alla posizione i modelli di attribuzione. A partire da settembre 2023, questi modelli non saranno più disponibili per tutte le proprietà.

Per ulteriori informazioni, consulta l'annuncio del prodotto Google Analytics.

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

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

31/05/2023 È stato aggiunto un metodo per cercare una proprietà GA4 collegata.

Metodo FetchConnectedGa4Property aggiunto all'API Admin v1alpha

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

31/05/2023 È stato aggiunto un metodo per gestire le regole di creazione degli eventi.

I metodi CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules, GetEventCreateRule aggiunti all'API Admin v1alpha.

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

31/05/2023 Sono stati 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 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 la versione 1 dell'API di dati di Google Analytics.

31/03/2023 Sono stati aggiunti metodi di gestione delle impostazioni di misurazione avanzata.

I metodi properties.dataStreams.updateEnhancedMeasurementSettings, properties.dataStreams.getEnhancedMeasurementSettings aggiunti all'API Admin v1alpha.

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

31/03/2023 Sono stati aggiunti i metodi di gestione dei tag del sito collegati.

I metodi properties.createConnectedSiteTag, properties.deleteConnectedSiteTag, properties.listConnectedSiteTags aggiunti all'API Admin v1alpha.

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

31/03/2023 Sono stati aggiunti i metodi runAccessReport a livello di account e proprietà all'API Admin v1beta.

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

24/02/2023 Sono stati aggiunti i metodi di gestione dei set di dati espansi.

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

La risorsa AccessBinding è 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

24/02/2023 Ritiro dei metodi di controllo delle autorizzazioni utente.

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

24/02/2023 Sono stati aggiunti i metodi di gestione dei segmenti di pubblico.

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

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

15/02/2023 Sono stati 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 risorsa BigQueryLink è stata aggiunta alla versione v1alpha dell'API, insieme alle operazioni properties.bigQueryLinks.get e 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 corrispondenti properties.searchAds360Links.create, properties.searchAds360Links.delete, properties.searchAds360Links.patch, properties.searchAds360Links.list, properties.searchAds360Links.get.

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

15/02/2023 Modifiche che provocano un errore.

15/02/2023 Modifiche varie.

11/08/2022 Metodo runAccessReport aggiunto all'API Admin v1alpha.

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

11/07/2022 È stata rilasciata la versione beta 1 dell'API Admin.

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

I canali alfa e beta dell'API continueranno a essere supportati per l'API Admin. Il canale beta contiene un sottoinsieme delle funzionalità disponibili in Alpha che sono considerate stabili e che non dovrebbero subire modifiche significative in futuro. Le nuove funzionalità verranno aggiunte alla versione beta quando saranno mature.

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

  • I metodi properties.webDataStreams.getEnhancedMeasurementSettings, properties.webDataStreams.updateEnhancedMeasurementSettings vengono rimossi dall'API, ma le impostazioni della misurazione avanzata saranno di nuovo modificabili tramite API a breve.
  • Il campo directRoles della risorsa UserLink non supporta più il ruolo predefinedRoles/manage-users. È preferibile utilizzare il nuovo ruolo predefinedRoles/admin, che è equivalente alla combinazione dei vecchi ruoli predefinedRoles/edit e predefinedRoles/manage-users. Questa modifica influisce sul comportamento dei metodi accounts.userLinks, properties.userLinks ed è in linea con le modifiche alla Gestione delle restrizioni relative a dati e accessiintrodotte in Google Analytics.

05/06/2021 Funzionalità aggiunte.

All'API vengono aggiunte le seguenti funzionalità:

  • Il metodo accounts.searchChangeHistoryEvents è stato aggiunto all'API. Questo metodo cerca tutte le modifiche apportate a un account o ai relativi account secondari in base all'insieme 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 di Google Analytics.
  • Metodi di gestione degli secret di Measurement Protocol aggiunti in properties.webDataStreams.measurementProtocolSecrets:
    • create Crea un secret Measurement Protocol.
    • delete Elimina il secret Measurement Protocol di destinazione.
    • get Cerca un singolo secret Measurement Protocol.
    • list Restituisce gli secret di Measurement Protocol secondari nella proprietà principale specificata.
    • patch Aggiorna un secret di Measurement Protocol.
  • Metodi di gestione degli eventi di conversione aggiunti in properties.conversionEvents:
    • create Crea un evento di conversione con gli attributi specificati.
    • delete Elimina un evento di conversione in una proprietà.
    • get Recupero di un singolo evento di conversione.
    • list Restituisce un elenco di eventi di conversione nella proprietà principale specificata.
  • Metodi di gestione delle dimensioni personalizzate aggiunti in properties.customDimensions:
    • archive Archivia una dimensione personalizzata in una proprietà.
    • create Consente di creare 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à.
  • Metodi di gestione delle metriche personalizzate aggiunti in properties.customMetrics:
    • archive Archivia una metrica personalizzata in una proprietà.
    • create riede una metrica personalizzata.
    • get Cerca una singola metrica personalizzata.
    • list Elenca le metriche personalizzate di 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.
  • delete_time, expire_time campi di output aggiunti al tipo Property.

05/06/2021 Modifiche che provocano un errore.

Sono state introdotte le seguenti modifiche incompatibili:

  • 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.
  • Il metodo properties.delete ora restituisce i dati della proprietà eliminata come tipo Property invece di restituire una risposta vuota.
  • Il campo time_zone del tipo Property è ora obbligatorio.
  • Campo deleted rimosso dal tipo Property.
  • Il campo email_address del tipo UserLink è ora immutabile.
  • Il campo name del tipo UserLink ora è solo di output.

28/01/2021 Modifiche che provocano un errore.

Modifiche non compatibili: - Il campo update_mask è obbligatorio per tutte le operazioni di aggiornamento.

  • Il campo country_code è stato rinominato region_code in Account.

  • Il campo url_query_parameter è stato rinominato uri_query_parameter in EnhancedMeasurementSettings.

  • Campo parent rimosso da GoogleAdsLink.

20/10/2020 È stato aggiunto il supporto per i riepiloghi dell'account.

È stato aggiunto il supporto per il metodo riepiloghi account.

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

15-08-2020 L'app di gestione e l'API web sono state rinominate in API Admin.

L'API di gestione di Google Analytics per app e web è stata rinominata in API Google Analytics Admin. Di conseguenza, l'endpoint API è diventato analyticsadmin.googleapis.com. Il codice esistente scritto per la versione precedente dell'URL dell'endpoint API e delle librerie client deve essere aggiornato di conseguenza.