Panoramica dell'API Metadata

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.