Règlement relatif aux abandons de données pour les API Google Analytics

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:

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 sur DEPRECATED.
  • 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 sur DEPRECATED et l'attribut replacedBy 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:

Groupes

Il est parfois nécessaire de modifier le nom d'un groupe ou l'ordre des colonnes. Dans ce cas: