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 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:

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

Groupes

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