L'API Google Analytics Management permet un accès programmatique aux comptes, propriétés et vues. Ce document explique comment utiliser différentes ressources d'API pour configurer votre compte Google Analytics.
Introduction
L'API Management traite deux cas d'utilisation courants de la configuration de votre compte Google Analytics. Le premier est la nécessité d'obtenir rapidement un résumé du compte contenant l'arborescence hiérarchique complète des comptes, propriétés et vues. La seconde consiste à apporter des modifications spécifiques à la configuration.
Récapitulatifs du compte
Le point de terminaison Récapitulatif du compte permet de lister facilement et rapidement des informations concernant les comptes, les propriétés et les vues Google Analytics d'un utilisateur autorisé.
Les récapitulatifs de compte peuvent servir à indexer la hiérarchie des comptes. Il est courant que les applications qui s'intègrent à Google Analytics offrent une interface permettant aux utilisateurs de sélectionner un compte, une propriété et une vue. Une seule requête envoyée à l'API vous permet de récupérer toutes les informations pertinentes pour créer un sélecteur de ce type. Pour obtenir un exemple, consultez l'explorateur de requêtes et des exemples de code sur GitHub.
Pour obtenir des détails et des exemples de code, consultez la documentation de référence sur les ressources pour les récapitulatifs de comptes, ainsi que les références sur les méthodes de liste.
Configuration du compte
Contrairement aux récapitulatifs de compte lorsque vous utilisez la méthode de liste Account, Property et View, l'API renvoie des informations détaillées pour chaque ressource.
Comptes
Les comptes d'entité de premier niveau sont importants, car chaque demande d'API de niveau inférieur nécessite un ID de compte. L'API de gestion permet uniquement l'opération list sur les comptes. Notez bien dans la réponse de l'API la propriété childlink qui donne la requête API pour toutes les propriétés Web enfants.
Propriétés
Également appelée "propriété Web", la deuxième entité est importante, car toutes les données sont collectées à ce niveau. Par exemple, lorsque vous ajoutez un code de suivi à un site Web ou à une application mobile, vous devez inclure un ID qui ressemble à UA-XXXXX-Y. Cet ID, appelé "ID de propriété" ou "ID de suivi", permet de distinguer dans lequel les données du compte Google Analytics sont stockées. Vous pouvez utiliser l'API pour créer ou mettre à jour des propriétés. Consultez la ressource de propriété pour en savoir plus et obtenir des exemples de code.
Vues
Les vues (profils) représentent le troisième niveau de la hiérarchie des comptes, car il s'agit du niveau au niveau duquel les rapports sont créés. L'API Core Reporting utilise l'ID de la vue (profil) comme paramètre clé afin de spécifier la vue à partir de laquelle récupérer des données. En plus du niveau de rapport, de nombreuses autres ressources sont liées ou associées à cette ressource (objectifs, tests, rapports non échantillonnés et liens de filtrage, par exemple). Vous pouvez utiliser l'API pour créer ou mettre à jour des vues. Consultez la ressource "Vue (profil)" pour en savoir plus et obtenir des exemples de code.
Étapes suivantes
Après avoir lu ce guide, vous devriez savoir utiliser l'API Management pour parcourir et manipuler les différentes entités de configuration de compte. Le guide suivant explique comment utiliser l'API pour gérer les utilisateurs.