Panoramica dell'API Google Analytics Admin

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

Avviso: si tratta di una versione di anteprima dell'API ed è soggetta a modifiche. Anche se cercheremo di informarti delle imminenti modifiche, dovresti aspettarti l'applicazione di modifiche che provocano errori. Prima che le API vengano rilasciate pubblicamente.

I canali Alpha e Beta dell'API continuano a essere supportati. Il canale beta contiene un sottoinsieme delle funzionalità disponibili nella versione alpha che sono considerate stabili e non sono soggette a cambiamenti significativi in futuro. Dopo la maturazione, le nuove funzionalità verranno aggiunte alla versione beta.

Per comunicazioni ufficiali relative all'API di Google Analytics, iscriviti al gruppo di notifica dell'API di Google Analytics. Per segnalare un problema con l'API, utilizza il modulo di feedback relativo al tester dell'API di Google Analytics.

Introduzione

L'API Admin di Google Analytics 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 Admin di Google Analytics per:

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

Metodi disponibili

Provisioning dell'account

• accounts.provisionAccountTicket

  Questo metodo restituisce il campo accountTicketId da includere nell'URL dei Termini di servizio (TdS): https://analytics.google.com/analytics/web/?provisioningSignup=false#/termsofservice/ACCOUNT_TICKET_ID. Nel momento in cui un utente visita l'URL dei TdS e accetta i Termini di servizio, la creazione di un account Google Analytics viene completata (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 i riepiloghi degli account

• accountSummaries.list

Cerca eventi nella cronologia delle modifiche

• accounts.searchChangeHistoryEvents

Gestione di proprietà

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

Accettazione della raccolta dei dati utente

• properties.acknowledgeUserDataCollection

Gestione dell'impostazione 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 eventi di conversione

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

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 al 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 di tag Google (alpha)

• properties.webDataStreams.getGlobalSiteTag

Proposte per il 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 dell'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 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 sull'accesso ai dati (alpha)

• properties.runAccessReport

Per ulteriori informazioni su questa funzionalità, consulta la guida ai report sull'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 espansa dei set di dati (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 di 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.