Questo documento fornisce una panoramica generale dell'API Google Analytics Metadata. Per un riferimento dettagliato dell'API, consulta la pagina di riferimento API.
Introduzione
L'API Metadata restituisce l'elenco e gli attributi delle colonne (ovvero dimensioni e metriche) visualizzate nelle API di reporting di Google Analytics. Gli attributi restituiti includono il nome dell'interfaccia utente, la descrizione, il supporto dei segmenti e altro ancora.
Puoi utilizzare l'API Metadata per:
- Scopri automaticamente nuove colonne
- Accedi a tutti gli attributi delle dimensioni e delle metriche per le API di reporting di Google Analytics
Dai un'occhiata a una risposta dell'API Metadata in tempo reale e scopri come utilizzarla leggendo la guida per gli sviluppatori.
Panoramica concettuale
I concetti fondamentali alla base dell'API Metadata sono:
Colonne
Una risorsa Column nell'API Metadata rappresenta una singola dimensione o metrica e contiene informazioni come Id
e altri attributi della colonna. Una raccolta di risorse Column
rappresenta tutte le dimensioni e 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 dell'API Metadata per ulteriori informazioni sulla risposta dell'API e sugli esempi di codice, nonché la guida per gli sviluppatori dell'API Metadata per maggiori dettagli sull'utilizzo dell'API.
Accesso API
L'API Metadata non richiede autenticazione e autorizzazione. L'unico requisito è che l'applicazione si identifichi ogni volta che invia una richiesta all'API Analytics. Per i dettagli su come eseguire questa operazione, consulta la sezione Accesso alle API della Guida per gli sviluppatori.
Criteri per le quote e il ritiro
L'API Metadata gestisce milioni di operazioni. Per impedire al sistema di ricevere più operazioni di quante ne possa gestire e per garantire una distribuzione equa delle risorse di sistema, è necessario impiegare un sistema di quote. Per ulteriori dettagli, consulta la guida su limiti e quota.
Per informazioni dettagliate su come vengono gestite le modifiche alle colonne dell'API di reporting (ad esempio dimensioni e metriche), leggi le norme sul ritiro dei dati. Per informazioni su come utilizzare l'API Metadata per verificare la presenza di colonne deprecate, consulta la Guida per lo sviluppo di API Metadata.