Questo documento descrive le norme relative al ritiro dei dati per le API Core e i metadati.
Panoramica
Le dimensioni e le metriche (colonne) vengono utilizzate per eseguire query sulle API di reporting di Google Analytics. A volte è necessario aggiungere, rimuovere o rinominare queste colonne. Le norme sul ritiro dei dati vengono fornite per aumentare la trasparenza su come vengono applicate queste modifiche.
Tutte le modifiche delle colonne saranno comunicate tramite changelogs e l'API Metadata si aggiornerà automaticamente per riflettere tali modifiche.
Cosa è coperto da queste norme
Questo criterio riguarda le dimensioni e le metriche esposte dalle API pubbliche. Non riguardano la richiesta API (parametri di query), la risposta dell'API, i valori restituiti dall'API o combinazioni valide di dimensioni e metriche.
Nuovi dati
Quando vengono aggiunte nuove colonne a un'API:
- Il log delle modifiche dell'API corrispondente verrà aggiornato con i dettagli delle nuove colonne.
- Le colonne saranno disponibili nell'API Metadata.
Rimozione dei dati
Quando le colonne vengono rimosse da un'API:
- Il log delle modifiche dell'API corrispondente verrà aggiornato con i dettagli delle colonne rimosse.
- Nell'API Metadata, l'attributo colonna
status
verrà impostato suDEPRECATED
. - Le colonne continueranno a funzionare nelle query di reporting per almeno 6 mesi.
- Dopo 6 mesi, le colonne verranno rimosse dall'API Metadata e le query relative alle colonne nell'API di reporting determineranno un errore
400 Bad Request
.
Rinomina dati
Quando le colonne vengono rinominate:
- Il log delle modifiche dell'API corrispondente verrà aggiornato con i dettagli delle colonne originali e di sostituzione.
- Nell'API Metadata, l'attributo
status
della colonna originale verrà impostato suDEPRECATED
e l'attributoreplacedBy
verrà impostato sull'ID della colonna sostitutiva. - Le colonne originali continueranno a funzionare nelle query di reporting per almeno 6 mesi.
- Dopo 6 mesi, le colonne originali verranno rimosse dall'API Metadata e le query relative alle colonne nell'API di reporting determineranno un errore
400 Bad Request
.
Rimozione attributo
Quando gli attributi vengono rimossi dall'API Metadata:
- Il log delle modifiche dell'API Metadata verrà aggiornato con i dettagli degli attributi rimossi.
- Gli attributi continueranno a essere disponibili nell'API Metadata per un minimo di 6 mesi.
- Dopo 6 mesi, gli attributi verranno rimossi dall'API Metadata.
Gruppi
A volte è necessario modificare il nome di un gruppo o l'ordine delle colonne, In questi casi:
- Il log delle modifiche dell'API Metadata verrà aggiornato con i dettagli sul nome del gruppo e sulle modifiche di ordinamento.