Ce document fournit une vue d'ensemble de l'API Google Analytics Metadata. Pour obtenir des informations détaillées sur l'API, consultez la documentation de référence sur les API.
Introduction
L'API Metadata renvoie la liste et les attributs des colonnes (c'est-à-dire les dimensions et les métriques) exposés dans les API de création de rapports Google Analytics. Les attributs renvoyés incluent le nom de l'interface utilisateur, la description, la compatibilité avec les segments, etc.
Vous pouvez utiliser l'API Metadata pour:
- Découvrir automatiquement les nouvelles colonnes
- Accéder à tous les attributs de dimensions et de métriques pour les API de création de rapports Google Analytics
Consultez une réponse en direct concernant l'API Metadata et découvrez comment l'utiliser en lisant le guide du développeur.
Présentation du concept
Les concepts fondamentaux sous-jacents de l'API Metadata sont les suivants:
Colonnes
Une ressource "Column" dans l'API Metadata représente une seule dimension ou métrique et contient des informations telles que Id et d'autres attributs pour cette colonne. Une collection de ressources Column représente toutes les dimensions et les 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 les métadonnées. La réponse de l'API inclut une collection de toutes les colonnes (c'est-à-dire les dimensions et les métriques) disponibles pour ce type de rapport. Pour en savoir plus sur la réponse de l'API et les exemples de code, consultez le Guide de référence de l'API Metadata. Pour en savoir plus sur l'utilisation de l'API, consultez le guide de développement de l'API Metadata.
Accès API
L'API Metadata ne nécessite pas d'authentification ni d'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 aux API du guide du développeur.
Règles relatives aux quotas et aux abandons
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 traiter, et pour garantir 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 plus d'informations sur la gestion des modifications apportées aux colonnes de l'API Reporting (c'est-à-dire les dimensions et les métriques), consultez le Règlement relatif aux abandons de données. Pour savoir comment utiliser l'API Metadata afin d'identifier les colonnes obsolètes, consultez le guide de développement de l'API Metadata.