Panoramica dell'API Google Analytics Admin

Riepilogo: questo documento fornisce una panoramica generale della versione 1.0 dell'API Admin di Google Analytics.

Questa API attualmente fornisce le funzionalità disponibili nei canali alpha e beta.

Alfa

Le funzionalità nel canale Alpha sono in fase di anteprima iniziale. Proveremo a informarti delle modifiche imminenti, ma dovresti aspettarti modifiche che provocano errori prima che l'API venga rilasciata pubblicamente.

Beta

Non sono previste modifiche che provocano errori in questo canale. Tieni presente che i prodotti pre-GA potrebbero avere supporto limitato e che le modifiche ai prodotti pre-GA potrebbero non essere compatibili con altre versioni pre-GA.

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

Introduzione

L'API Google Analytics Admin consente l'accesso programmatico ai dati di configurazione di Google Analytics 4 (GA4) ed è compatibile solo con le proprietà GA4. Scopri di più sulle proprietà GA4.

Puoi utilizzare l'API Google Analytics Admin per:

• Esegui il provisioning di nuovi account.
• Gestire gli account.
• Gestire le impostazioni di condivisione dei dati.
• Elencare i riepiloghi degli account.
• Cercare gli eventi della cronologia delle modifiche.
• Gestire le proprietà.
• Accettare la raccolta dei dati utente.
• Gestire l'impostazione di conservazione dei dati per una proprietà.
• Gestire l'impostazione di Google Signals per una proprietà (alpha).
• Gestisci gli stream.
• Gestisci i secret di Measurement Protocol.
• Gestire lo schema dei valori di conversione di SKAdNetwork (alpha).
• Genera uno snippet del tag Google per gli stream di dati web (alpha).
• Gestire gli eventi di conversione.
• Gestire le dimensioni personalizzate.
• Gestire le metriche personalizzate.
• Gestire i collegamenti tra le proprietà GA4 e i progetti Firebase.
• Gestire i collegamenti tra le proprietà GA4 e gli account Google Ads.
• Gestire le proposte di collegamento tra una proprietà GA4 e un inserzionista Display & Video 360 (alpha).
• Gestire i collegamenti tra una proprietà GA4 e un inserzionista Display & Video 360 (alpha).
• Gestire i collegamenti tra una proprietà GA4 e Search Ads 360 (alpha).
• Gestire i collegamenti tra una proprietà GA4 e un progetto BigQuery (alpha).
• Gestire le autorizzazioni degli utenti per una gerarchia di account e per le proprietà GA4 (alpha).
• Generare report sugli accessi ai dati.
• Gestione dei segmenti di pubblico (alpha).
• Gestire i set di dati espansi (alpha).
• Gestisci le impostazioni di disattivazione della procedura di configurazione automatica di GA4 (alpha).

Metodi disponibili

Ecco i metodi disponibili.

Provisioning account

• accounts.provisionAccountTicket

Questo metodo restituisce il campo accountTicketId che deve essere incluso nell'URL dei Termini di servizio (TdS): https://analytics.google.com/analytics/web/?provisioningSignup=false#/termsofservice/ACCOUNT_TICKET_ID. Quando un utente visita l'URL dei TdS e accetta i Termini di servizio, la creazione di un account Google Analytics sarà completata. Vedi l'esempio di provisioning dell'account.

Gestione degli account

• accounts.delete
• accounts.get
• accounts.list
• accounts.patch

Gestione delle impostazioni di condivisione dei dati

• accounts.getDataSharingSettings

Elenca riepiloghi account

• accountSummaries.list

Cerca tra gli eventi della cronologia delle modifiche

• accounts.searchChangeHistoryEvents

Gestione proprietà

• properties.get
• properties.patch
• properties.delete
• properties.list
• properties.create

Autorizzazione alla raccolta dei dati utente

• properties.acknowledgeUserDataCollection

Gestione delle impostazioni di conservazione dei dati

• properties.getDataRetentionSettings
• properties.updateDataRetentionSettings

Gestione delle impostazioni di Google Signals (alpha)

• properties.getGoogleSignalsSettings
• properties.updateGoogleSignalsSettings

Gestione degli stream di dati

• properties.dataStreams.create
• properties.dataStreams.get
• properties.dataStreams.list
• properties.dataStreams.patch
• properties.dataStreams.delete

Gestione dei secret di Measurement Protocol

• properties.dataStreams.measurementProtocolSecrets.create
• properties.dataStreams.measurementProtocolSecrets.get
• properties.dataStreams.measurementProtocolSecrets.patch
• properties.dataStreams.measurementProtocolSecrets.list
• properties.dataStreams.measurementProtocolSecrets.delete

Gestione dello schema dei valori di conversione di SKAdNetwork (alpha)

• properties.dataStreams.sKAdNetworkConversionValueSchema.get
• properties.dataStreams.sKAdNetworkConversionValueSchema.create
• properties.dataStreams.sKAdNetworkConversionValueSchema.delete
• properties.dataStreams.sKAdNetworkConversionValueSchema.update
• properties.dataStreams.sKAdNetworkConversionValueSchema.list

Gestione degli eventi di conversione

• properties.conversionEvents.create
• properties.conversionEvents.get
• properties.conversionEvents.list
• properties.conversionEvents.delete
• properties.conversionEvents.update

Gestione delle dimensioni personalizzate

• properties.customDimensions.create
• properties.customDimensions.get
• properties.customDimensions.list
• properties.customDimensions.patch
• properties.customDimensions.archive

Gestione delle metriche personalizzate

• properties.customMetrics.create
• properties.customMetrics.get
• properties.customMetrics.list
• properties.customMetrics.patch
• properties.customMetrics.archive

Collegamento del progetto Firebase

• properties.firebaseLinks.create
• properties.firebaseLinks.list
• properties.firebaseLinks.delete

Collegamento con account Google Ads

• properties.googleAdsLinks.create
• properties.googleAdsLinks.list
• properties.googleAdsLinks.patch
• properties.googleAdsLinks.delete

Generazione dei tag Google (alpha)

• properties.webDataStreams.getGlobalSiteTag

Proposte per un collegamento tra una proprietà GA4 e un inserzionista Display & Video 360 (alpha)

• properties.displayVideo360AdvertiserLinkProposals.create
• properties.displayVideo360AdvertiserLinkProposals.approve
• properties.displayVideo360AdvertiserLinkProposals.cancel
• properties.displayVideo360AdvertiserLinkProposals.list
• properties.displayVideo360AdvertiserLinkProposals.get
• properties.displayVideo360AdvertiserLinkProposals.delete

Collegamento all'account inserzionista Display & Video 360 (alpha)

• properties.displayVideo360AdvertiserLinks.create
• properties.displayVideo360AdvertiserLinks.get
• properties.displayVideo360AdvertiserLinks.list
• properties.displayVideo360AdvertiserLinks.delete
• properties.displayVideo360AdvertiserLinks.patch

Collegamento degli account Search Ads 360 (alpha)

• properties.searchAds360Links.create
• properties.searchAds360Links.delete
• properties.searchAds360Links.patch
• properties.searchAds360Links.list
• properties.searchAds360Links.get

Scopri di più sulla configurazione dell'integrazione di Analytics Search Ads 360 per una proprietà GA4.

Collegamento dell'account BigQuery (alpha)

• properties.bigQueryLinks.get
• properties.bigQueryLinks.list

Scopri di più sulla configurazione di BigQuery Export per una proprietà GA4.

Gestione delle autorizzazioni degli utenti (alpha)

• 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

Report sugli accessi ai dati

• properties.runAccessReport

Per ulteriori informazioni su questa funzionalità, consulta la guida ai report di accesso ai dati.

Gestione dei segmenti di pubblico (alpha)

• properties.audiences.create
• properties.audiences.archive
• properties.audiences.patch
• properties.audiences.list
• properties.audiences.get

Scopri di più sui segmenti di pubblico in Google Analytics.

Gestione dei set di dati espansi (alpha)

• properties.expandedDataSets.create
• properties.expandedDataSets.delete
• properties.expandedDataSets.patch
• properties.expandedDataSets.list
• properties.expandedDataSets.get

Scopri di più sui set di dati espansi in Google Analytics 360.

Disattivazione della procedura di configurazione automatica GA4 (alpha)

• properties.setAutomatedGa4ConfigurationOptOut
• properties.fetchAutomatedGa4ConfigurationOptOut

Scopri di più sulla gestione dello stato di disattivazione per la procedura di configurazione automatica di GA4 per una proprietà UA.