L'API de gestion de Google Analytics permet d'accéder de manière 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 charge deux cas d'utilisation courants lorsqu'il s'agit de configurer la configuration de votre compte Google Analytics. Tout d'abord, vous devez 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ésumés du compte
Le point de terminaison Récapitulatifs des comptes permet de lister facilement, via une requête simple et rapide, des informations simples sur les comptes, propriétés et vues Google Analytics pour un utilisateur autorisé.
Les récapitulatifs de compte permettent de créer un index de la hiérarchie des comptes. Il arrive souvent que les applications qui s'intègrent à Google Analytics proposent une interface permettant aux utilisateurs de sélectionner un compte, une propriété et une vue. Il vous suffit d'envoyer une requête à l'API pour récupérer toutes les informations pertinentes pour créer un sélecteur. Pour voir un exemple, consultez l'Explorateur de requêtes et les exemples de code sur GitHub.
Consultez la documentation de référence sur les ressources des résumés 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 compte lorsque vous utilisez la méthode "list" des ressources Account, Property et View (Vue), l'API affiche des informations complètes pour 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. Dans la réponse de l'API, il est important de noter la propriété childlink, qui renvoie 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 toute la collecte de données s'effectue à ce niveau. Par exemple, lorsque vous ajoutez le code de suivi à un site Web ou à une application mobile, vous devez inclure un ID ressemblant à UA-XXXXX-Y. Il s'agit d'un ID de propriété ou d'ID de suivi, qui 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 en savoir plus et obtenir des exemples de code.
Vues
Les vues (profils) constituent le troisième niveau de la hiérarchie des comptes, car c'est à ce niveau que les rapports sont générés. L'API Core Reporting utilise l'ID de la 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 des rapports, de nombreuses autres ressources sont associées à celle-ci ou sont des enfants de celle-ci, comme les objectifs, les tests, les rapports non échantillonnés et les liens de filtres. Vous pouvez utiliser l'API pour créer ou mettre à jour des vues. Pour obtenir des détails et des exemples de code, consultez la section Afficher la ressource (profil).
Étapes suivantes
Après avoir lu ce guide, vous devriez être capable d'utiliser l'API Management pour parcourir et manipuler les différentes entités de configuration de compte. Le prochain guide explique comment effectuer la gestion des utilisateurs à l'aide de l'API.