L'API di gestione di Google Analytics consente l'accesso programmatico ad account, proprietà e viste. Questo documento descrive come utilizzare varie risorse dell'API per configurare la configurazione dell'account Google Analytics.
Introduzione
Esistono due casi d'uso comuni che l'API di gestione si occupa di configurare la configurazione dell'account Google Analytics. La prima è la necessità di ottenere rapidamente un riepilogo dell'account dell'albero gerarchico completo di account, proprietà e viste. La seconda consiste nell'apportare modifiche specifiche alla configurazione.
Riepiloghi account
L'endpoint Riepiloghi account consente di elencare in modo semplice e pratico informazioni sugli account, le proprietà e le viste di Google Analytics per un utente autorizzato tramite un'unica richiesta rapida.
I riepiloghi degli account possono essere utilizzati per creare un indice della gerarchia degli account. È frequente che le applicazioni che si integrano con Google Analytics forniscono un'interfaccia che consente agli utenti di selezionare un account, una proprietà e una vista. Con una singola richiesta all'API puoi recuperare tutte le informazioni pertinenti per creare un selettore di questo tipo. Per un esempio, consulta Query Explorer e degli esempi di codice su GitHub.
Consulta il riferimento delle risorse e il riferimento sui metodi di elenco dei riepiloghi degli account per dettagli ed esempi di codice.
Configurazione account
A differenza dei riepiloghi degli account, quando utilizzi il metodo elenco di risorse Account, Proprietà e Vista, l'API restituisce dettagli completi per ogni risorsa.
Account
Poiché gli account dell'entità di primo livello sono importanti perché ogni richiesta API di livello inferiore richiede un ID account. L'API di gestione consente l'operazione list solo sugli account. Nella risposta dell'API è importante sottolineare che la proprietà childlink fornisce la richiesta API per tutte le proprietà web secondarie.
Proprietà
Chiamata anche proprietà web, l'entità di secondo livello è importante perché tutta la raccolta dei dati avviene a questo livello. Ad esempio, quando aggiungi un codice di monitoraggio a un sito web o a un'applicazione mobile, devi includere un ID simile a UA-XXXXX-Y. Questo ID è chiamato ID proprietà o ID monitoraggio e consente di distinguere il luogo in cui sono archiviati i dati dell'account Google Analytics. Puoi utilizzare l'API per creare o aggiornare le proprietà. Consulta la risorsa proprietà per dettagli ed esempi di codice.
Visualizzazioni
Le viste (profili), il terzo livello della gerarchia dell'account, sono importanti in quanto è il livello in cui vengono generati i report. L'API di reporting principale utilizza l'ID vista (profilo) come parametro chiave per specificare la vista da cui recuperare i dati. Oltre al livello dei report, molte altre risorse sono collegate o sono secondarie di questa risorsa, ad esempio obiettivi, esperimenti, report non campionati e link di filtro. Puoi utilizzare l'API per creare o aggiornare le viste. Consulta la risorsa vista (profilo) per dettagli ed esempi di codice.
Passaggi successivi
Dopo aver letto questa guida, dovresti avere una buona comprensione di come utilizzare l'API di gestione per attraversare e manipolare le varie entità di configurazione dell'account. Nella guida successiva spiegheremo come utilizzare l'API per eseguire la gestione degli utenti.