Ce document offre une présentation générale de l'API Google Analytics Metadata. Pour une description détaillée de l'API, consultez la documentation de référence de l'API.
Introduction
L'API Metadata renvoie la liste et les attributs des colonnes (dimensions et métriques) affichées dans les API de reporting Google Analytics. Les attributs renvoyés incluent le nom de l'UI, la description, la compatibilité des segments, etc.
Vous pouvez utiliser l'API Metadata pour:
- Découvrir automatiquement de nouvelles colonnes
- Accéder à tous les attributs de dimensions et de métriques pour les API de reporting Google Analytics
Consultez la réponse en direct de l'API Metadata et découvrez comment l'utiliser en lisant le guide du développeur.
Présentation du concept
Les concepts fondamentaux de l'API Metadata sont les suivants:
Colonne
Dans l'API Metadata, une ressource de colonne représente une seule dimension ou métrique et contient des informations telles que Id et d'autres attributs pour cette colonne. Un ensemble de ressources Column représente toutes les dimensions et métriques d'une API de création de rapports.
Travailler avec l'API
Lorsque vous interrogez l'API, vous spécifiez le type de rapport pour lequel vous souhaitez récupérer des métadonnées. La réponse de l'API inclura une collection de toutes les colonnes (dimensions et métriques) disponibles pour ce type de rapport. Lisez le Guide de référence de l'API Metadata pour en savoir plus sur la réponse de l'API et les exemples de code, ainsi que le Guide de développement de l'API Metadata pour en savoir plus sur l'utilisation de l'API.
Accès API
L'API Metadata ne nécessite ni authentification, ni autorisation. La seule condition requise est que votre application s'identifie chaque fois qu'elle envoie une requête à l'API Analytics. Pour en savoir plus sur la procédure à suivre, consultez la section Accès à l'API du guide du développeur.
Règles de quotas et d'abandon
L'API Metadata gère des millions d'opérations. Pour empêcher le système de recevoir plus d'opérations qu'il ne peut en gérer, et pour assurer une répartition équitable des ressources système, il est nécessaire d'utiliser un système de quotas. Pour en savoir plus, consultez le guide Limites et quotas.
Pour en savoir plus sur le traitement des modifications apportées aux colonnes de l'API de création de rapports (dimensions et métriques, par exemple), consultez le Règlement sur l'abandon des données. Pour savoir comment rechercher des colonnes obsolètes à l'aide de l' API Metadata, consultez le Guide de développement de l'API Metadata.