Questo documento offre una panoramica generale dell'API di metadati di Google Analytics. Per un riferimento dettagliato dell'API, consulta la sezione Riferimento API.
Introduzione
L'API Metadata restituisce l'elenco e gli attributi delle colonne (ovvero dimensioni e metriche) esposti nelle API dei report di Google Analytics. Gli attributi restituiti includono nome dell'interfaccia utente, descrizione, supporto dei segmenti e altro ancora.
Puoi utilizzare l'API Metadata per:
- Rilevamento automatico di nuove colonne
- Accedi a tutte le dimensioni e agli attributi delle metriche per le API dei report di Google Analytics
Guarda una risposta API live di metadati e scopri come usare questa funzionalità leggendo la Guida per gli sviluppatori.
Panoramica concettuale
I concetti fondamentali alla base dell'API Metadata sono:
Colonne
Una risorsa Colonna nell'API Metadata rappresenta una singola dimensione o metrica e contiene informazioni come Id e altri attributi per quella colonna. Una raccolta di Column risorse rappresenta tutte le dimensioni e le metriche per un'API di reporting.
Utilizzo dell'API
Quando esegui una query sull'API, specifichi il tipo di report per il quale vuoi recuperare i metadati. La risposta dell'API includerà una raccolta di tutte le colonne (ovvero dimensioni e metriche) disponibili per quel tipo di report. Leggi la Guida di riferimento API per i metadati per ulteriori informazioni sulla risposta dell'API e gli esempi di codice, nonché la Guida per gli sviluppatori per l'API Metadata per informazioni dettagliate sull'utilizzo dell'API.
Accesso API
L'API Metadata non richiede autenticazione e autorizzazione. Invece, l'unico requisito è che la tua applicazione si identifichi ogni volta che invia una richiesta all'API Analytics. Per dettagli su come fare, consulta la sezione sull'accesso alle API della guida per gli sviluppatori.
Norme su quote e ritiri
L'API Metadata gestisce milioni di operazioni. Per proteggere il sistema dalla ricezione di più operazioni rispetto a quelle che può gestire e per garantire una distribuzione equa delle risorse di sistema, è necessario impiegare un sistema di quote. Per ulteriori dettagli, consulta la guida relativa a limiti e quote.
Per dettagli su come vengono gestite le modifiche alle colonne API dei rapporti (ovvero dimensioni e metriche), leggi le Norme sul ritiro dei dati. Per scoprire come l'API Metadata può essere utilizzata per il controllo delle colonne deprecate, consulta la Guida allo sviluppo dell'API Metadata.