Norme sul ritiro dei dati per le API di Google Analytics

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:

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 su DEPRECATED.
  • 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 su DEPRECATED e l'attributo replacedBy 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: