Ce document décrit le règlement relatif aux abandons de données pour les API principales Reporting et Metadata.
Présentation
Les dimensions et les métriques (colonnes) permettent d'interroger les API Reporting de Google Analytics. Il est parfois nécessaire d'ajouter, de supprimer ou de renommer ces colonnes. Le règlement relatif à l'abandon des données vise à accroître la transparence sur la façon dont ces modifications sont effectuées.
Toutes les modifications apportées aux colonnes seront communiquées via des journaux de modifications, et l'API Metadata sera automatiquement mise à jour pour refléter ces modifications.
Quels sont les champs d'application de cette Politique ?
Cette règle concerne les dimensions et les métriques exposées par les API publiques. Il ne couvre pas la requête API (paramètres de requête), la réponse de l'API, les valeurs renvoyées par l'API ni les combinaisons valides de dimensions et de métriques.
Nouvelles données
Lorsque de nouvelles colonnes sont ajoutées à une API:
- Le journal des modifications de l'API correspondante sera mis à jour avec des informations sur les nouvelles colonnes.
- La ou les colonnes seront disponibles dans l'API Metadata.
Suppression de données
Lorsque des colonnes sont supprimées d'une API:
- Le journal des modifications de l'API correspondante sera mis à jour avec des informations sur la ou les colonnes à supprimer.
- Dans l'API Metadata, l'attribut de colonne
status
sera défini surDEPRECATED
. - Elles continueront de fonctionner dans les requêtes de rapport pendant au moins six mois.
- Après six mois, ces colonnes sont supprimées de l'API Metadata, et l'interrogation des colonnes dans l'API Reporting génère une erreur
400 Bad Request
.
Changement de nom des données
Lorsque les colonnes sont renommées:
- Le journal des modifications de l'API correspondante sera mis à jour avec des informations sur les colonnes d'origine et de remplacement.
- Dans l'API Metadata
, l'attribut
status
de la colonne d'origine sera défini surDEPRECATED
et l'attributreplacedBy
sera défini sur l'ID de la colonne de remplacement. - La ou les colonnes d'origine continueront de fonctionner dans les requêtes de rapport pendant au moins six mois.
- Après six mois, la ou les colonnes d'origine sont supprimées de l'API Metadata, et toute requête sur ces colonnes dans l'API Reporting génère une erreur
400 Bad Request
.
Suppression d'attribut
Lorsque les attributs sont supprimés de l'API Metadata:
- Le journal des modifications de l'API Metadata sera mis à jour avec des informations sur le ou les attributs supprimés.
- Ils resteront disponibles dans l'API Metadata pendant au moins six mois.
- Après six mois, le ou les attributs seront supprimés de l'API Metadata.
Groupes
Il est parfois nécessaire de modifier le nom d'un groupe ou l'ordre des colonnes. Dans ce cas:
- Le journal des modifications de l'API Metadata sera mis à jour avec des informations sur le nom du groupe et les modifications apportées à l'ordre.