Log delle modifiche

Per gli annunci ufficiali sull'API di Google Analytics, iscriviti a Gruppo di notifiche dell'API Google Analytics.

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

La documentazione per runAccessReport è stato aggiornato in modo da includere un link Feedback ai report di accesso a Google Analytics in un modulo di testo. Il tuo feedback è molto importante per noi e ti invitiamo a condividere le tue opinioni in merito API per aiutarci a migliorarla ulteriormente.

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

Campo dataset_location aggiunto alla risorsa BigQueryLink.

Sono state aggiunte modifiche al link BigQuery alla cronologia delle modifiche nel nuovo BIGQUERY_LINK valore in ChangeHistoryResourceType

01/08/2024 Interruzione della modifica al metodo createSubproperty

Il metodo personalizzato createSubproperty è stato rinominato in provisionSubproperty nella versione 1alpha dell'API Admin per allinearsi al metodo personalizzato linee guida.

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

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

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

01/08/2024 Modifiche varie

Contatto create_time aggiunto a Risorsa Audience.

Contatto primary aggiunto a ChannelGroup per indica se il gruppo di canali è il gruppo di canali predefinito per i report. Solo uno Il gruppo di canali può avere il valore primary impostato su true in un determinato momento. Impostazione Da primary a true per un gruppo di canali viene impostato automaticamente il valore primary su false per il gruppo di canali principale precedente.

L'elemento gmp_organization è stato aggiunto a Account contenente l'URI di un'organizzazione Google Marketing Platform se l'account è connesso a un'organizzazione di GMP.

6/05/2024 Aggiunta di metodi di gestione degli eventi chiave

Risorse e metodi per le chiavi eventi.

Modifica l'integrazione API da utilizzare KeyEvent anziché ConversionEvent. L'API ConversionEvent è deprecata.

15/12/2023 I report sull'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 Standard e Google Analytics 360.

Per saperne di più, consulta la documentazione relativa agli schemi.

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

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

05/10/2023 Le proprietà con i modelli di attribuzione Primo clic, Lineare, Decadimento temporale e In base alla posizione utilizzano per impostazione predefinita la DDA (attribuzione basata sui dati) cross-channel.

A partire da metà ottobre 2023, le funzionalità first-click, lineare, decadimento temporale e in base alla posizione i modelli di attribuzione non saranno disponibili per l'uso con UpdateAttributionSettings per tutte le proprietà.

Se la tua proprietà è attualmente configurata per usare uno di questi modelli, verrà modificato in l'attribuzione basata sui dati cross-channel. Avrai comunque opzioni per utilizzare Ultimo clic cross-channel o Ultimo clic preferito da Google Ads fai clic.

1/09/2023 Sono stati aggiunti i metodi di configurazione dello schema del valore di conversione di SKAdNetwork.

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

Questa funzionalità consente di gestire lo schema dei valori di conversione di SKAdNetwork configurazione per uno stream iOS.

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

UpdateConversionEvent aggiunto all'API Admin v1beta.

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

Il campo enterprise_export_enabled della risorsa BigQueryLink è stato rinominato in fresh_daily_export_enabled

14/07/2023 Modifiche che interessano i metodi properties.updateAttributionSettings e properties.getAttributionSettings.

A partire dal 24 luglio 2023, verranno apportate modifiche che provocano un errore alla versione 1 dell'API Admin alfa, che inciderà sulla funzionalità properties.getAttributionSettings, properties.updateAttributionSettings di machine learning.

Membri della ReportingAttributionModel enum sarà rinominata 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

Membri della AdsWebConversionDataExportScope enum sarà rinominata come segue:

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

Il campo ads_web_conversion_data_export_scope è stato aggiunto alla sezione AttributionSettings che può essere modificato utilizzando 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 campo UpdateAttributionSettings non può essere utilizzato per configurare le proprietà GA4 con primo clic lineare, decadimento temporale e in base alla posizione modelli di attribuzione. A partire da settembre 2023, questi modelli diventeranno non disponibile per tutte le proprietà.

Fai riferimento all'annuncio di prodotto Google Analytics. per ulteriori informazioni.

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.

La FetchConnectedGa4Property aggiunto all'API Admin v1alpha

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

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

La CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules, GetEventCreateRule metodi aggiunti alla versione 1alpha dell'API Admin.

Questa funzionalità consente di gestire regole per la creazione di eventi che può attivare la creazione di un evento completamente nuovo in base criteri di un evento di origine.

31/05/2023 Aggiunta di metodi per gestire i gruppi di canali personalizzati.

Aggiunti 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, è possibile eseguire query sui gruppi di canali personalizzati utilizzando API di dati di Google Analytics v1.

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

I metodi properties.dataStreams.updateEnhancedMeasurementSettings e properties.dataStreams.getEnhancedMeasurementSettings aggiunti alla versione 1alpha dell'API Admin.

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 connessi.

I metodi properties.createConnectedSiteTag, properties.deleteConnectedSiteTag e properties.listConnectedSiteTags aggiunti alla versione 1alpha dell'API Admin.

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.

31/03/2023 Sono stati aggiunti i metodi runAccessReport a livello di account e proprietà alla versione 1beta dell'API Admin.

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

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

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

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

Questa funzionalità consente di gestire le autorizzazioni degli utenti per un account GA4 o e deve essere utilizzato al posto di Link utente.

La funzionalità Link utente verrà rimossa dalla versione 1 alpha dell'API Admin il 1/06/23

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

I seguenti metodi sono deprecati e verranno rimossi dalla versione 1 dell'API Admin alpha in data 1/6/23:

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

La Audience alla versione v1alpha dell'API è stata aggiunta la risorsa, insieme al corrispondente properties.audience.create, properties.audience.archive, properties.audience.patch, properties.audience.list, properties.audience.get operazioni aziendali.

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

15/02/2023 Sono stati aggiunti i metodi di disattivazione automatica del processo di configurazione di GA4.

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

Questa funzionalità consente di gestire lo stato di disattivazione per i report automatici GA4. procedura di configurazione per una proprietà UA.

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

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

La SearchAds360Link alla versione v1alpha dell'API è stata aggiunta la risorsa, insieme al corrispondente properties.searchAds360Links.create, properties.searchAds360Links.delete, properties.searchAds360Links.patch, properties.searchAds360Links.list, properties.searchAds360Links.get operazioni aziendali.

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 alla versione 1alpha dell'API Admin.

La properties.runAccessReport aggiunto alla versione v1alpha dell'API Admin. Restituisce un valore report personalizzato sui record di accesso ai dati. Il report fornisce record di 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.

11/07/2022 Rilascio della versione v1beta dell'API Admin.

La versione v1beta dell'API Google Analytics Admin.

I canali alpha e beta dell'API continuano a essere supportati per l'amministratore tramite Google Cloud CLI o tramite l'API Compute Engine. Il canale beta contiene un sottoinsieme delle funzionalità disponibili in versione alpha, che sono considerati stabili e non si prevede che subisca una modifica significativa del per il futuro. Le nuove funzionalità verranno aggiunte alla versione beta una volta raggiunta la maturità.

12/10/2021: i metodi di misurazione avanzata sono stati rimossi dall'API.

  • properties.webDataStreams.getEnhancedMeasurementSettings, properties.webDataStreams.updateEnhancedMeasurementSettings metodi sono rimossa dall'API, ma la misurazione avanzata saranno nuovamente modificabili tramite API a breve.
  • Il campo directRoles di UserLink La risorsa non supporta più il ruolo predefinedRoles/manage-users. Usa invece il nuovo ruolo predefinedRoles/admin, che è equivalente alla combinazione dei precedenti predefinedRoles/edit e predefinedRoles/manage-users ruoli. 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à:

  • accounts.searchChangeHistoryEvents è stato aggiunto all'API. Questo metodo cerca tra tutte le modifiche a un l'account principale o i relativi figli secondo l'insieme specificato di filtri. Cause comuni sono gli aggiornamenti apportati nell'interfaccia utente di Google Analytics, le modifiche assistenza o modifiche automatiche di sistema Google Analytics.
  • Metodi di gestione dei secret di Measurement Protocol aggiunti in properties.webDataStreams.measurementProtocolSecrets:
    • create Crea un secret di Measurement Protocol.
    • delete Elimina il secret del protocollo di misurazione della destinazione.
    • get Cerca un singolo API secret Measurement Protocol.
    • list Restituisce i 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 Recupera 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 su una proprietà.
    • create Crea una dimensione personalizzata.
    • get Cerca una singola dimensione personalizzata.
    • list Elenca le dimensioni personalizzate in una proprietà.
    • patch Consente di aggiornare una dimensione personalizzata su una proprietà.
  • Metodi di gestione delle metriche personalizzate aggiunti in properties.customMetrics:
    • archive Archivia una metrica personalizzata su una proprietà.
    • create genera una metrica personalizzata.
    • get Cerca una singola metrica personalizzata.
    • list Elenca le metriche personalizzate in una proprietà.
    • patch Consente di aggiornare una metrica personalizzata su una proprietà.
  • Aggiunti properties.getGoogleSignalsSettings, properties.updateGoogleSignalsSettings che consentono di controllare Google Signals per una proprietà Google Analytics 4.
  • delete_time, expire_time solo i campi di output aggiunti a Property di testo.

05/06/2021 Modifiche che provocano un errore.

Sono state introdotte le seguenti modifiche che provocano un errore:

  • properties.iosAppDataStreams.create e properties.androidAppDataStreams.create sono stati rimossi dall'API. Utilizza Firebase per creare un'applicazione i tuoi stream in una proprietà Google Analytics 4.
  • properties.delete ora restituisce i dati di proprietà eliminati come Property invece di restituire una risposta vuota.
  • time_zone campo di Property è ora obbligatorio.
  • Campo deleted rimosso da Property di testo.
  • email_address campo di UserLink è ora immutabile.
  • name campo di UserLink viene restituito solo come output.

28/01/2021 Modifiche che provocano un errore.

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

  • Campo country_code rinominato in region_code in Account.

  • Campo url_query_parameter rinominato in uri_query_parameter in EnhancedMeasurementSettings.

  • Campo parent rimosso da GoogleAdsLink.

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

È stato aggiunto il supporto per il metodo di riepilogo degli account.

13/10/2020: le proprietà App + web sono state rinominate Google Analytics 4 (GA4).

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

L'API Google Analytics Management App + Web è stata rinominata in l'API Google Analytics Admin. Di conseguenza, l'endpoint API è cambiato analyticsadmin.googleapis.com. Codice esistente scritto sulla base della versione precedente dell'URL dell'endpoint API e delle librerie client devono essere aggiornati di conseguenza.