Norme sul ritiro dei dati per le API di Google Analytics

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:

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