Questo documento fornisce una panoramica generale dell'API Metadata di Google Analytics. Per un riferimento dettagliato dell'API, consulta la documentazione di riferimento API.
Introduzione
L'API Metadata restituisce l'elenco e gli attributi delle colonne (ovvero dimensioni e metriche) esposte 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 alla 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 cui 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 gli esempi di codice e la guida per gli sviluppatori dell'API Metadata per informazioni dettagliate sull'utilizzo dell'API.
Accesso API
L'API Metadata non richiede autenticazione e autorizzazione. L'unico requisito, invece, è 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 di quota e deprecazione
L'API Metadata gestisce milioni di operazioni. Per evitare che il sistema riceva più operazioni di quante ne possa gestire e per garantire una distribuzione equa delle risorse di sistema, è necessario utilizzare un sistema di quote. Per ulteriori dettagli, leggi la guida su limiti e quota.
Per informazioni dettagliate su come vengono gestite le modifiche alle colonne dell'API di reporting (ovvero dimensioni e metriche), leggi le norme sul ritiro dei dati. Per informazioni su come l'API Metadata può essere utilizzata per verificare la presenza di colonne deprecate, consulta la guida per gli sviluppatori dell'API Metadata.