Questo documento descrive le norme sul ritiro dei dati per le API Core Reporting e Metadata.
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 alle colonne verranno comunicate tramite i log delle modifiche e l'API metadata verrà aggiornata automaticamente per riflettere queste modifiche.
Cosa è coperto da queste norme
Questo criterio riguarda le dimensioni e le metriche esposte dalle API pubbliche. Non riguarda 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 da rimuovere.
- Nell'API metadata, l'attributo della colonna
status
verrà impostato suDEPRECATED
. - Le colonne continueranno a funzionare nelle query dei report per un minimo di 6 mesi.
- Dopo 6 mesi, le colonne verranno rimosse dall'API metadata e l'esecuzione di query sulle colonne nell'API di reporting genererà un errore
400 Bad Request
.
Ridenominazione dati
Quando le colonne vengono rinominate:
- Il log delle modifiche dell'API corrispondente verrà aggiornato con i dettagli delle colonne originali e sostitutive.
- 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 dei report per un minimo di 6 mesi.
- Dopo 6 mesi, le colonne originali verranno rimosse dall'API metadata e l'esecuzione di query sulle colonne nell'API di reporting genererà un errore
400 Bad Request
.
Rimozione degli attributi
Quando gli attributi vengono rimossi dall'API Metadata:
- Il log delle modifiche dell'API Metadata verrà aggiornato con i dettagli relativi agli 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 questo caso:
- Il log delle modifiche dell'API Metadata verrà aggiornato con i dettagli relativi alle modifiche al nome del gruppo e all'ordine.