L'API de gestion de Google Analytics permet un accès programmatique aux comptes, propriétés et vues. Ce document explique comment utiliser différentes ressources d'API pour configurer la configuration de votre compte Google Analytics.
Introduction
L'API de gestion prend en compte deux cas d'utilisation courants lorsqu'il s'agit de configurer votre compte Google Analytics. Premièrement, vous devez pouvoir obtenir rapidement un récapitulatif du compte de 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ésumés du compte permet de répertorier facilement des informations légères sur les comptes, les propriétés et les vues Google Analytics pour un utilisateur autorisé, via une requête simple et rapide.
Les récapitulatifs de compte permettent de créer un index de la hiérarchie du compte. Il est courant que les applications qui s'intègrent à Google Analytics fournissent une interface permettant aux utilisateurs de sélectionner un compte, une propriété et une vue. En envoyant une seule requête à l'API, vous pouvez récupérer toutes les informations pertinentes pour créer un sélecteur. Pour obtenir un exemple, consultez l'explorateur de requêtes et les exemples de code disponibles sur GitHub.
Consultez la documentation de référence sur les ressources pour les récapitulatifs de compte et la documentation de référence sur la méthode list pour obtenir des détails et des exemples de code.
Configuration du compte
Contrairement aux récapitulatifs de comptes lorsque vous utilisez la méthode "list" des ressources Account, Property et View, l'API renvoie des informations complètes sur chaque ressource.
Comptes
En tant qu'entité de niveau supérieur, les comptes sont importants, car chaque requête API de niveau inférieur nécessite un ID de compte. L'API de gestion n'autorise l'opération list que sur les comptes. Il est à noter que dans la réponse de l'API, la propriété childlink fournit la requête API pour toutes les propriétés Web enfants.
Propriétés
Également appelée "Propriétés Web", l'entité de deuxième niveau est importante, car toutes les données sont collectées à ce niveau. Par exemple, lorsque vous ajoutez le code de suivi à un site Web ou à une application mobile, vous devez inclure un ID au format suivant : UA-XXXXX-Y. Cet ID, appelé "ID de propriété" ou "ID de suivi", permet de distinguer l'emplacement de stockage des données du compte Google Analytics. Vous pouvez utiliser l'API pour créer ou mettre à jour des propriétés. Consultez la ressource de propriété pour obtenir des détails et des exemples de code.
Vues
Les vues (profils), troisième niveau de la hiérarchie des comptes, sont importants, car il s'agit du niveau au sein duquel les rapports sont générés. L'API Core Reporting utilise l'ID de vue (profil) comme paramètre clé pour spécifier la vue à partir de laquelle récupérer les données. En plus d'être au niveau du rapport, de nombreuses autres ressources sont soit associées, soit enfants de cette ressource (par exemple, des objectifs, des tests, des rapports non échantillonnés et des liens de filtre). Vous pouvez utiliser l'API pour créer ou mettre à jour des vues. Consultez la ressource de vue (profil) pour obtenir des détails et des exemples de code.
Étapes suivantes
Après avoir lu ce guide, vous devriez être en mesure d'utiliser l'API Management pour parcourir et manipuler les différentes entités de configuration de compte. Le prochain guide vous explique comment utiliser l'API pour effectuer la gestion des utilisateurs.