Présentation de l'API de métadonnées

Ce document offre une présentation générale de l'API Google Analytics Metadata. Pour une documentation de référence détaillée sur 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 création de rapports Google Analytics. Les attributs renvoyés incluent le nom de l'interface utilisateur, la description, la compatibilité des 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 reporting Google Analytics

Consultez la réponse de l'API Metadata en direct 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 "Colonne" représente une seule dimension ou métrique, et contient des informations telles que l'attribut Id ainsi que 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. Consultez 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. Consultez également 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 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 gérer, et pour garantir une distribution équitable des ressources système, il est nécessaire d'employer 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 relatif aux abandons de 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.