Nous mettons régulièrement à jour l'API Management Google Analytics afin de proposer de nouvelles fonctionnalités et de réparer les défauts détectés dans les versions précédentes. Dans la plupart des cas, ces modifications seront transparentes pour les développeurs d'API. Cependant, nous devons parfois apporter des modifications qui obligent les développeurs à modifier leurs applications existantes.
Cette page décrit toutes les modifications apportées à l'API de gestion de Google Analytics susceptibles d'affecter votre application. Nous recommandons aux développeurs d'API de consulter régulièrement cette liste pour prendre connaissance des nouvelles annonces. Vous pouvez également vous abonner aux modifications via les flux listés dans la section S'abonner ci-dessous.
S'abonner aux journaux de modifications associés
Inclut toutes les API de collecte, de configuration et de reporting.
Inclut l'API de gestion et l'API de gestion des comptes.
Version 17/07/2018 (17 juillet 2018)
La méthode hashClientId a été ajoutée à l'API Management
La méthode hashClientId fournit le hachage de l'ID client donné, qui est disponible dans certains formats de données exportés, tels que les données Google Analytics exportées vers BigQuery.
Version 11/05/2018 (11 mai 2018)
Paramètres de conservation des données utilisateur dans l'API Management
Il est désormais possible de configurer par programmation les paramètres de conservation des données utilisateur à l'aide des nouveaux champs "dataConservationTtl" et "dataDeletionOnNewActivity" ajoutés à la ressource WebProperty.
Version 2018-02-22 (22 février 2018)
Opérations d'écriture dans l'API Management
Vous n'avez plus besoin d'ajouter à la liste blanche les opérations d'écriture dans l'API de gestion (création, mise à jour, suppression, correction, etc.) pour les ressources de propriété Web, de vue (profil) et d'objectif. La limite quotidienne par défaut pour toutes les opérations d'écriture dans l'API Management est de 50 écritures/jour. Pour en savoir plus, consultez la page Limites et quotas.
Version 2017-04-19 (19 avril 2017)
Audience de remarketing - Assistance Optimize
Cette version est compatible avec Google Optimize, OPTIMIZE
en tant que type de compte publicitaire associé. Pour en savoir plus, consultez la documentation de référence sur l'audience de remarketing et le guide du développeur de l'audience de remarketing.
Version 23/03/2017 (23 mars 2017)
Audience de remarketing
Cette version ajoute le verbe DELETE
à la ressource Audience de remarketing. Pour en savoir plus, consultez le Guide du développeur sur les audiences de remarketing.
- Audience de remarketing : supprimer : supprime une audience de remarketing.
Version 09/02/2017 (9 février 2017)
Custom Metrics (Métriques personnalisées)
Cette version corrige un bug. Elle résout le problème qui empêchait la création d'une métrique personnalisée de type TIME
lorsque min_value
n'était pas défini. Les requêtes sans min_value
créent désormais une métrique personnalisée avec une valeur min_value
par défaut de 0.
Version 2016/08/2016 (9 août 2016)
Devises
Cette version corrige un bug. Elle corrige un problème qui empêchait un sous-ensemble de devises d'être accepté dans l'interface Web Analytics, mais pas dans l'API. Cette version est compatible avec les devises suivantes:
- UAH, AED, BOB, CLP, COP, EGP, HRK, ILS, MAD, MYR, PEN, PKR, RON, RSD, SAR, SGD, VEF, LVL
Pour en savoir plus, consultez la documentation de référence sur les vues (profils). - Article du centre d'aide Documentation de référence sur les devises.
Version 08/08/2016 (8 août 2016)
Cette version ajoute les audiences de remarketing à l'API Management.
Audiences de remarketing
L'API Management vous permet d'create
, de get
, de list
, de update
et d'patch
d'audiences de remarketing pour une propriété Google Analytics. Pour en savoir plus sur le fonctionnement des audiences de remarketing, consultez l'article À propos des audiences de remarketing dans Analytics du centre d'aide.
Version 2016-03-11 (11 mars 2016)
Avec
Cette version ajoute la propriété starred
aux résumés des comptes, aux comptes, aux propriétés Web et aux vues (profils).
Version 25/02/2016 (25 février 2016)
Limitation du taux d'erreur
Depuis toujours, les développeurs doivent implémenter un intervalle exponentiel entre les tentatives lorsqu'ils traitent des réponses 500 ou 503. Aujourd'hui, nous introduisons une limite du débit pour les erreurs 500 et 503 afin d'appliquer cette règle.
- 50 requêtes d'écriture ayant échoué par heure
Version 2016-02-01 (1er février 2016)
Rapports non échantillonnés
L'API de rapports non échantillonnés n'est plus limitée à 100 rapports par jour. L'API utilise le même système de jetons par propriété, par jour que lors de la création d'un rapport non échantillonné via l'interface Web.
Version 26/01/2016 (26 janvier 2016)
Rapports non échantillonnés
Les rapports non échantillonnés auxquels l'utilisateur actuel n'a pas accès ne présenteront plus de lien de téléchargement dans le message de réponse de l'API de gestion. Ce comportement est désormais cohérent avec la fonctionnalité du tableau de bord de l'interface utilisateur, où seuls les propriétaires du rapport peuvent voir le lien de téléchargement du document généré.
Version 17/12/2015 (17 décembre 2015)
Vues (profils)
Cette version ajoute la propriété botFilteringEnabled
à la ressource de vue (profil). Cette propriété indique si le filtrage des robots est activé pour une vue (profil). Pour en savoir plus, consultez la documentation de référence sur les vues (profils).
Rapports non échantillonnés
Cette version ajoute la méthode delete
aux rapports non échantillonnés. Pour en savoir plus, consultez les documents de référence sur la suppression de rapports non échantillonnés.
Version 17/11/2015 (17 novembre 2015)
Segments
Cette version corrige un bug. Cette version corrige un problème qui entraînait un affichage incorrect des segments dont la définition comportait des valeurs de devise lors de l'appel de la méthode de liste de segments.
Version 06/10/2015 (6 octobre 2015)
Segments
Cette version corrige un bug. Dans cette version, les utilisateurs dont les segments privés sont épinglés à plusieurs vues (profils) reçoivent une réponse d'erreur 500
lorsqu'ils appellent la méthode de liste de segments.
Version 03/09/2015 (3 septembre 2015)
Traitement par lot
Dans cette version, en plus de la compatibilité générale avec le traitement par lot, nous avons ajouté une compatibilité spéciale pour l'API User Permissions. Les demandes d'autorisations utilisateur par lot permettent d'améliorer considérablement les performances et de réduire l'utilisation des quotas.
Version 06/08/2015 (6 août 2015)
Vues (profils)
Dans cette version, la propriété currency
de la vue (profil) est désormais définie sur USD par défaut si elle n'est pas définie lors d'une opération insert. De plus, les opérations get
et list
renvoient USD pour les vues (profils) créées précédemment sans propriété currency
.
-
Pour en savoir plus sur l'utilisation des vues (profils) dans l'API de gestion, veuillez consulter le guide du développeur de vues (profil).
-
Veuillez consulter la documentation de référence sur les vues (profils) pour obtenir la liste complète des paramètres de la ressource Vue (profil).
Version 2015-05-28 (28 mai 2015)
Filtres
Cette version marque la suppression finale des champs de filtre obsolètes IS_MOBILE
et IS_TABLET
, qui doivent être remplacés par DEVICE_CATEGORY=mobile
et DEVICE_CATEGORY=tablet
. Les requêtes d'insertion, de mise à jour et de correctif qui définissent les champs de filtre pour utiliser IS_MOBILE
et IS_TABLET
renvoient une erreur.
-
Pour en savoir plus sur l'utilisation des filtres dans l'API Management, consultez le guide du développeur de filtres.
-
Veuillez consulter la documentation de référence sur les filtres pour obtenir la liste complète des paramètres de la ressource "Filtre".
Version 2015-05-05 (5 mai 2015)
Filtres
Cette version permet d'utiliser une dimension personnalisée pour un champ de filtre en ajoutant une propriété fieldIndex
à toutes les sections des détails du filtre. Par exemple, il est maintenant possible de définir l'expression de filtre avec "field": "CUSTOM_DIMENSION"
et "fieldIndex": "1"
pour que le filtre fonctionne sur la première dimension personnalisée.
-
Pour en savoir plus sur l'utilisation des filtres dans l'API Management, consultez le guide du développeur de filtres.
-
Veuillez consulter la documentation de référence sur les filtres pour obtenir la liste complète des paramètres de la ressource "Filtre".
Objectifs
Cette version résout également un problème en cas d'échec de la création d'un objectif avec "comparisonValue": "0"
.
-
Pour en savoir plus sur leur utilisation dans l'API Management, consultez le Guide du développeur d'objectifs.
-
Veuillez consulter la documentation de référence sur les objectifs afin d'obtenir la liste complète des paramètres associés à la ressource "Objectif".
Version 13/03/2015 (13 mars 2015)
Cette version marque l'abandon final et la suppression de la ressource dailyUpload
. La ressource dailyUpload
a été officiellement obsolète le 20 juin 2014. Toutes les données de coût doivent désormais être importées à l'aide de la ressource d'importations.
- Veuillez consulter le Règlement relatif aux abandons de données pour en savoir plus sur le processus d'abandon de l'API Google Analytics.
- Consultez le Guide du développeur pour l'importation de données afin de découvrir comment importer des données dans Google Analytics.
Version 23/01/2015 (23 janvier 2015)
Cette version ajoute deux nouvelles collections à l'API de gestion : les dimensions personnalisées et les métriques personnalisées.
Statistiques et dimensions personnalisées
Il est désormais possible de créer, de répertorier, d'obtenir, de corriger et de mettre à jour des dimensions et des métriques personnalisées avec l'API de gestion.
Version 08/01/2015 (8 janvier 2015)
La réponse de la méthode list
pour toutes les collections inclut désormais une liste vide pour la propriété items
lorsque la collection ne contient aucune ressource. Auparavant, la propriété items
était omise de la réponse. Consultez la documentation de référence de l'API pour en savoir plus sur les requêtes et les réponses concernant les données de configuration Google Analytics.
Version 16/12/2014 (16 décembre 2014)
Correction de bugs
- Correction du problème 467 : la collection de segments renvoie désormais des segments utilisant la syntaxe
dateOfSession
.
Version 20/11/2014 (20 novembre 2014)
Cette version introduit un nouveau champ d'application pour l'API de gestion de Google Analytics. - analytics.manage.users.readonly
- Afficher les autorisations des utilisateurs de Google Analytics.
Version 2014-11-05 (5 novembre 2014)
Un nouveau champ de filtres DEVICE_CATEGORY
a été ajouté, et IS_MOBILE
et IS_TABLET
sont désormais obsolètes. Utilisez DEVICE_CATEGORY=mobile
et DEVICE_CATEGORY=tablet
.
Version du 29/10/2014 (29 octobre 2014)
La ressource Vue (profil) inclut désormais une propriété enhancedECommerceTracking
qui indique si l'e-commerce amélioré est activé (true
) ou désactivé (false
).
Version 2014-06 (20 juin 2014)
Cette version inclut de nouveaux types d'importation de données et l'abandon de la ressource dailyUpload
.
Importation de données
Pour savoir comment utiliser l'API de gestion afin d'importer des données dans votre compte Google Analytics, consultez le Guide du développeur pour l'importation de données.
Mises en ligne
- La ressource
upload
est désormais compatible avec les types d'importation suivants :- Données de la campagne
- Données relatives au contenu
- Données de coût
- Données relatives aux produits
- Données relatives aux rejets de débit
- Données utilisateur
- La ressource
upload
dispose d'une nouvelle méthodemigrateDataImport
pour migrer les données de coûtcustomDataSources
existantes.
Abandon des importations quotidiennes
- La ressource
dailyUpload
est désormais obsolète. Consultez le guide de migration pour en savoir plus sur la migration afin d'utiliser la fonctionnalité d'importation de données. - La ressource
dailyUpload
continuera de fonctionner pendant six mois supplémentaires, après quoi toutcustomDataSources
restant avec la propriétéuploadType
définie suranalytics#dailyUploads
sera automatiquement migré et ne fonctionnera qu'avec la ressourceupload
. - Les utilisateurs actuels de la ressource
dailyUpload
doivent mettre à jour leur code et migrer vers la ressource d'importation dès que possible.
Version 2014-05 (28 mai 2014)
Cette version ajoute deux nouvelles API de configuration.
Associations à AdWords
-
Les associations AdWords de l'API Management vous permettent de créer, répertorier, obtenir, mettre à jour, corriger et supprimer des associations entre des comptes Google AdWords et des propriétés Google Analytics, et de gérer les vues (profils) associées aux données AdWords.
Filtres
-
Les filtres de l'API Management vous permettent de créer, répertorier, obtenir, mettre à jour, corriger et supprimer des filtres pour votre compte Google Analytics. Les liens de filtres de profil vous permettent de créer, de répertorier, d'obtenir, de mettre à jour, de corriger et de supprimer des liens entre les filtres et les vues (profils).
Version 2014-05-27 (27 mai 2014)
Rapports non échantillonnés: API Management
Nous ajoutons à l'API Management une ressource appelée Rapports non échantillonnés. Les rapports non échantillonnés sont des rapports Google Analytics (GA) qui ont été générés à l'aide de données non échantillonnées.Les rapports non échantillonnés ne sont actuellement disponibles que pour les utilisateurs de GA Premium.
- Consultez le guide du développeur.
Version 11/04/2014 (11 avril 2014)
Segments: API Management versions 2.4 et 3.0
Les modifications suivantes ont été apportées à la collection de segments:
- Les segments d'utilisateurs et de séquence sont désormais compatibles avec l'API.
- La collection de segments renvoie désormais tous les segments intégrés et personnalisés au niveau de la session et au niveau de l'utilisateur.
- La propriété
definition
des segments utilise désormais la nouvelle syntaxe de segment. Cela inclut les définitions des segments existants au niveau de la session, qui passeront dedefinition: "
à" definition: "sessions::condition::
." - Une nouvelle propriété
type
a été ajoutée à la ressource Segment pour indiquer si un segment estCUSTOM
(créé par un utilisateur dans l'interface Web) ouBUILT_IN
(fourni par Google Analytics).
Tests
Les métriques AdSense suivantes peuvent désormais être utilisées comme objectifs d'optimisation:
ga:adsenseAdsClicks
: nombre de fois où les utilisateurs ont cliqué sur les annonces AdSense de votre site.ga:adsenseAdsViewed
: nombre d'annonces AdSense vues. Plusieurs annonces peuvent être diffusées dans un bloc d'annonces.ga:adsenseRevenue
: revenu total généré par les annonces AdSense
Version 25/03/2014 (25 mars 2014)
Nouvelle collection de résumés de compte
- La collection AccountSummaries a été ajoutée à l'API Management. Il fournit un résumé des informations pour chaque compte, propriété et vue (profil) auquel un utilisateur autorisé a accès, via une requête unique et rapide. Pour en savoir plus, consultez le Guide du développeur sur les résumés de compte.
Version 12/12/2013 (12 décembre 2013)
Les modifications suivantes ont été apportées aux segments par défaut en raison de l'abandon des dimensions ga:isMobile
et ga:isTablet
:
- Le segment
gaid::-11
a été renommé Trafic sur mobile en Trafic sur mobile et tablette. La définition de ce segment est passée dega:isMobile==Yes
àga:deviceCategory==mobile,ga:deviceCategory==tablet
. Notez quega:isMobile
inclut le trafic provenant des tablettes, ce qui se reflète dans la nouvelle définition. Si vous ne souhaitez afficher que le trafic sur mobile, à l'exclusion des tablettes, passez au nouveau segment Trafic sur mobile (gaid::-14
). - La définition du segment
gaid::-13
est passée dega:isTablet==Yes
àga:deviceCategory==tablet
. Cela représente toujours le trafic des tablettes. - Le segment
gaid::-14
a été ajouté. Le nom du segment est Trafic sur mobile et sa définition estga:deviceCategory==mobile
.
Version 2013-10-28 (28 octobre 2013)
Corrections de bugs:
- Les informations de fuseau horaire pour les vues (profils) ont été corrigées. Détails: avant ce correctif, dans certains cas, lors de la création d'une liste de vues (profils) dans l'API Management, des informations de fuseau horaire incorrectes pour une vue (profil) s'affichaient. Le fuseau horaire des vues (profils) est désormais le même que celui défini dans l'interface d'administration de Google Analytics.
Version 2013-10-04 (4 octobre 2013)
Importations (élargissement de dimension)
- La nouvelle ressource Importations permet d'importer des données d'élargissement de dimension. Pour en savoir plus, consultez le Guide du développeur relatif à l'importation de données (importations).
Version 2013-10-03 (3 octobre 2013)
Cette version présente les opérations d'écriture pour les ressources de propriété Web, de vue (profil) et d'objectif, ainsi qu'un ensemble de trois nouvelles ressources permettant de gérer les autorisations de l'utilisateur.
API de configuration et de configuration du compte
- Il est désormais possible de créer, de mettre à jour, de corriger et de supprimer des vues (profils). Consultez la documentation de référence sur les vues (profils) pour en savoir plus sur les nouvelles méthodes.
- Il est désormais possible de créer, de mettre à jour et de corriger des propriétés Web et des objectifs. Pour en savoir plus sur les nouvelles méthodes, consultez la documentation de référence sur les propriétés Web et la documentation de référence sur les objectifs.
- Vous pouvez désormais demander une propriété Web, une vue (profil) ou un objectif unique à l'aide de la méthode
get
. - Ces fonctionnalités sont actuellement disponibles en Preview développeur en version bêta limitée. Si vous souhaitez vous inscrire, demandez l'accès à la version bêta.
Autorisations de l'utilisateur dans l'API de gestion
- La nouvelle ressource accountUserLinks permet de gérer les autorisations de compte pour les utilisateurs.
- La nouvelle ressource webpropertyUserLinks permet de gérer les autorisations de propriété pour les utilisateurs.
- La nouvelle ressource profileUserLinks permet de gérer les autorisations de vue (profil) pour les utilisateurs.
- Les autorisations accordées à un utilisateur autorisé sont désormais disponibles dans les ressources Compte, Site Web et Vue (profil).
- Un nouveau champ d'application a été introduit et est requis pour gérer les autorisations des utilisateurs.
https://www.googleapis.com/auth/analytics.manage.users
. - Pour en savoir plus, consultez le Guide du développeur sur les autorisations utilisateur.
Version 15/07/2013 (16 juillet 2013)
Dans le cadre du lancement des nouveaux segments, nous allons apporter les modifications suivantes à la collection de segments:
- Tous les ID de segment passeront des entiers positifs à des chaînes alphanumériques. Si vous avez enregistré des ID de segment utilisateur, nous vous recommandons de les mettre à jour avec les nouveaux ID.
- La collection "Segments" n'affiche que les segments existants au niveau de la visite. Les nouveaux segments de visiteur, de cohorte et de séquence ne sont actuellement pas compatibles avec l'API.
- La collection "Segments" continuera à renvoyer les segments par défaut existants associés aux mêmes ID numériques négatifs. Toutefois, les nouveaux segments par défaut ne sont pas acceptés pour le moment.
Version 2013-06-05 (5 juin 2013)
Cette version ajoute deux nouvelles propriétés à la ressource de propriété Web:
profileCount
: renvoie le nombre de profils pour une propriété. Cela vous permet de filtrer les propriétés qui n'ont pas de profil (par exemple, profileCount = 0).industryVertical
: affiche le secteur/la catégorie d'activité sélectionné pour une propriété.
Corrections de bugs:
- La propriété
eCommerceTracking
de la ressource de profil correspond désormais aux paramètres d'e-commerce de la section "Administration" de l'interface Web. Renvoietrue
si le suivi de l'e-commerce est activé, etfalse
dans le cas contraire.
Version 2013-05-08 (8 mai 2013)
- La ressource Webproperty inclut désormais une propriété
level
pour indiquer si la propriété Web estPREMIUM
ouSTANDARD
.
Version 2013-04-04 (4 avril 2013)
- Un nouveau point de terminaison a été ajouté à l'API Management v3 pour accéder aux ressources Tests et les modifier.
Version 14/01/2013 (14 janvier 2013)
- La ressource de profil inclut désormais une propriété
type
pour déterminer si un profil est configuré pour un site Web ou une application. Les deux valeurs possibles sontWEB
ouAPP
.
Version 2012-01 (26 janvier 2012)
Cette version ajoute des réponses d'erreur utiles à l'API Management.
Versions 2011-12 (5 décembre 2011)
Cette version ajoute des données, modifie des fonctionnalités existantes et corrige un bug.
Nouvelles données
- La collection "Segment avancé" contient désormais un champ
segmentId
utilisable dans le paramètre segment de l'API d'exportation des données.
Changements
-
Le type de données de
max-results
a été remplacé parinteger
. -
La valeur par défaut et maximale de
max-results
est passée à 1 000.
Correction de bugs
- Les comptes, sites Web et profils utilisés pour les tests de l'Optimiseur de Site Google ne sont plus inclus dans les collections correspondantes.
Version 2011-08 (29 août 2011)
Cette version ajoute deux nouvelles versions de l'API avec de nombreuses nouvelles fonctionnalités et abandonne l'ancienne version. Les modifications ont une incidence sur la façon dont vous demandez et gérez les données de l'API.
Version 3.0
-
Il s'agit de la dernière version majeure de notre API. Elle n'est pas rétrocompatible. Tout développement futur de l'API se fera sur cette version.
-
Nouvelles données
- Représentation complète des objectifs de l'événement
- ID de propriété Web interne permettant de créer un lien profond dans l'interface utilisateur GA.
- Configurations de profil pour les paramètres de requête de recherche sur site et de page par défaut
-
Changements
- Une nouvelle règle relative aux quotas
- L'intégration à la console des API Google permet de gérer l'accès aux API et de demander une augmentation de quota.
- La compatibilité avec OAuth 2.0 est la nouvelle méthode recommandée pour autoriser les utilisateurs.
- Nouvelle URL pour l'envoi des requêtes:
https://www.googleapis.com/analytics/v3/management/…
- Réponse d'API plus compacte au format JSON
- Nouvelles bibliothèques clientes pour les API Google compatibles avec de nombreux langages
- Compatibilité avec l'API Google Discovery
Version 2.4
-
Il s'agit d'une mise à niveau de version mineure principalement rétrocompatible avec la version 2.3 existante.
-
Changements
- Une nouvelle règle relative aux quotas
- L'intégration à la console des API Google permet de gérer l'accès aux API et de demander une augmentation de quota.
- Maintien de la compatibilité avec les mécanismes d'autorisation existants et OAuth 2.0
- Nouvelle URL pour l'envoi des requêtes:
https://www.googleapis.com/analytics/v2.4/management/…
- Réponses au format XML uniquement
- Incompatibilité avec la bibliothèque cliente JavaScript de Google Data
- La sortie XML est cohérente avec la version 2.3. Les autres bibliothèques clientes Google Data existantes continueront donc de fonctionner.
Obsolescence
- Nous annonçons l'abandon de l'ancienne version 2.3 de l'API Management. Elle continuera de fonctionner pendant deux mois, après quoi toutes les requêtes v2.3 renverront une réponse v2.4.
Version 2010-08 (18 août 2010)
Il s'agit de la version bêta de l'API de gestion de Google Analytics.
Nouveaux flux
-
Cinq nouveaux flux ont été créés pour simplifier l'accès aux données de configuration des comptes Google Analytics:
Bibliothèques clientes mises à jour
- L'API de gestion appartient à la même bibliothèque que l'API d'exportation de données Google Analytics. Les bibliothèques Java et JavaScript de Google Data ont été mises à jour. Vous pouvez accéder à chaque flux en spécifiant l'URI de flux approprié dans la méthode
getManagementFeed()
des bibliothèques.
Nouvelle documentation
- Une nouvelle section de la documentation destinée aux développeurs Google Analytics a été créée afin de décrire le fonctionnement de la nouvelle API de gestion.