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

Ce document décrit le règlement relatif aux abandons des données pour les API Core Reporting et Metadata.

Présentation

Les dimensions et les métriques (colonnes) permettent d'interroger les API Google Analytics Reporting. Il est parfois nécessaire d'ajouter, de supprimer ou de renommer ces colonnes. Le règlement relatif aux abandons de données a pour but d'améliorer la transparence sur la façon dont ces modifications sont appliquées.

Toutes les modifications de colonne seront transmises via les journaux des modifications, et l'API Metadata sera automatiquement mise à jour pour refléter ces modifications.

Sujets couverts par ce règlement

Cette règle couvre 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 ou les combinaisons valides de dimensions et de métriques.

Nouvelles données

Lorsque vous ajoutez des colonnes à une API:

Suppression des données

Lorsque des colonnes sont supprimées d'une API:

  • Le journal des modifications de l'API correspondante sera mis à jour avec les détails des colonnes en cours de suppression.
  • Dans l'API Metadata, l'attribut de colonne status sera défini sur DEPRECATED.
  • La ou les colonnes continueront de fonctionner dans les rapports sur les requêtes pendant au moins six mois.
  • Au bout de six mois, ces colonnes sont supprimées de l'API Metadata. Si vous les interrogez dans l'API de création de rapports, une erreur 400 Bad Request est renvoyée.

Changement de nom des données

Lorsque des colonnes sont renommées:

  • Le journal des modifications de l'API correspondante sera mis à jour avec les détails de la ou des colonnes d'origine et de remplacement.
  • Dans l'API Metadata, l'attribut status de la colonne d'origine est 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, la ou les colonnes d'origine sont supprimées de l'API Metadata. Si vous interrogez les colonnes dans l'API de création de rapports, une erreur 400 Bad Request est renvoyée.

Suppression d'attribut

Lorsque des attributs sont supprimés de l'API Metadata:

Groups

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