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 modifiche in arrivo, potresti aspettarti di incorrere in modifiche che provocano un errore 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 dovrebbero subire modifiche significative in futuro. Le nuove funzionalità verranno aggiunte alla versione beta una volta che diventeranno mature.

Per gli annunci ufficiali dell'API Google Analytics, iscriviti al gruppo di notifica dell'API Google Analytics. Per segnalare un problema con l'API, utilizza il modulo di feedback relativo al tester 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 gli account.
• Gestire le impostazioni di condivisione dei dati.
• Elenca i riepiloghi degli account.
• Cerca eventi della cronologia delle modifiche.
• Gestisci le proprietà.
• Confermare la raccolta dei dati utente.
• Gestisci 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.
• Genera uno snippet del tag Google per gli stream di dati web (alpha).
• Gestisci gli eventi di conversione.
• Gestisci 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 & amp; Video 360 (alpha).
• Gestire i collegamenti tra una proprietà GA4 e un inserzionista Display & amp; Video 360 (alpha).
• Gestire le autorizzazioni utente in una gerarchia di account e nelle proprietà GA4 (alpha).
• Controlla le autorizzazioni degli utenti, incluse quelle implicite provenienti da autorizzazioni effettive concesse da gruppi o da ruoli di amministratore dell'organizzazione (alpha).
• Generare report sull'accesso ai dati (alpha).

Metodi disponibili

Provisioning degli 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. Una volta che un utente visita l'URL dei TdS e accetta i Termini di servizio, la creazione di un account Google Analytics verrà completata (esempio di provisioning dell'account).

Gestione account

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

Gestione delle impostazioni di condivisione dei dati

• accounts.getDataCondivisioneSettings

Elencare i riepiloghi degli account

• accountSummaries.list

Cerca eventi nella cronologia delle modifiche

• accounts.searchChangeHistoryEvents

Gestione di proprietà

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

Accettazione della raccolta dei dati utente

• proprietà.acknowledgeUserDataCollection

Gestione delle impostazioni di conservazione dei dati

• properties.getDataFidelizzazioneSettings
• properties.updateDataFidelizzazioneSettings

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.customSize.create
• properties.customSize.get
• properties.customSize.list
• properties.customSize.patch
• properties.customSize.archive

Gestione delle metriche personalizzate

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

Collegamento a un 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 un collegamento tra una proprietà GA4 e un inserzionista Display & amp; Video 360 (alpha)

• proprietà.displayVideo360InserzionistaLinkPropostas.create
• proprietà.displayVideo360InserzionistaLinkPropostas.approva
• proprietà.displayVideo360InserzionistaLinkProposte.cancel
• proprietà.displayVideo360InserzionistaLinkProposte.list
• proprietà.displayVideo360InserzionistaLinkPropostas.get
• proprietà.displayVideo360InserzionistaLinkPropostas.elimina

Collega una proprietà GA4 a un inserzionista Display & amp; Video 360 (alpha).

• proprietà.displayVideo360InserzionistaLinks.create
• proprietà.displayVideo360InserzionistaLinks.get
• properties.displayVideo360AdvertiserLinks.list
• properties.displayVideo360AdvertiserLinks.delete
• properties.displayVideo360AdvertiserLinks.patch

Gestione delle autorizzazioni degli utenti (alpha)

• accounts.userLinks.create
• accounts.userLinks.get
• accounts.userLinks.list
• accounts.userLinks.patch
• accounts.userLinks.delete
• accounts.userLinks.batchCreate
• accounts.userLinks.batchGet.
• accounts.userLinks.batchUpdate

• accounts.userLinks.batchDelete.

• properties.userLinks.create

• properties.userLinks.get

• properties.userLinks.list

• properties.userLinks.delete

• properties.userLinks.patch

• properties.userLinks.batchCreate

• properties.userLinks.batchGet.

• proprietà.userLinks.batchUpdate

• properties.userLinks.batchDelete.

Controllo autorizzazioni utente (alpha)

• accounts.userLinks.audit
• proprietà.userLinks.audit

Report sull'accesso ai dati (alpha)

• properties.runAccessReport Per ulteriori informazioni su questa funzionalità, consulta la guida ai report sull'accesso ai dati.