Ce document décrit le règlement relatif aux abandons de données pour les API principales de création de rapports et de métadonnées.
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 aux abandons de 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.
Sujets couverts par 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 les détails des nouvelles colonnes.
- La ou les colonnes seront disponibles dans l'API de métadonnées.
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 supprimées.
- 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.
- Au bout de six mois, la ou les colonnes sont supprimées de l'API Metadata, et toute requête sur ces colonnes dans l'API de création de rapports 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 détails 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
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.
- Au bout de six mois, les colonnes d'origine sont supprimées de l'API Metadata, et toute requête sur ces colonnes dans l'API de création de rapports génère une erreur
400 Bad Request
.
Suppression d'un attribut
Lorsque des 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.
- Au bout de 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 détails sur le nom du groupe et les modifications apportées à l'ordre.