Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Vous pouvez utiliser l'API Data pour accéder de manière programmatique aux données de rapport Google Analytics. Cette API n'est pas compatible avec les anciennes propriétés Universal Analytics.
Voici quelques exemples de rapports que vous pouvez créer à l'aide de la version 1 de l'API Google Analytics Data:
Nombre d'utilisateurs actifs par jour sur votre application Android au cours de la semaine précédente
Nombre de pages vues enregistrées par les 10 premières pages de votre site au cours des 28 derniers jours.
Nombre d'utilisateurs actifs par pays pour votre application iOS au cours des 30 dernières minutes
Vous pouvez également utiliser la version 1 de l'API Google Analytics Data pour effectuer les opérations suivantes:
Créez des tableaux de bord personnalisés pour afficher les données Google Analytics.
gagner du temps en automatisant les tâches de reporting complexes ;
Intégrer vos données Google Analytics à d'autres applications métier.
Commencer
Pour commencer, consultez le tutoriel de démarrage de la bibliothèque cliente. Des bibliothèques clientes sont disponibles en Java, Python, Node.js et dans d'autres langages pour simplifier votre implémentation.
Méthodes disponibles
Voici la liste des méthodes de l'API Data. Pour en savoir plus, consultez la documentation de référence.
runReport Cette méthode renvoie un rapport personnalisé de vos données d'événement Google Analytics. Elle est recommandée pour les requêtes de rapports simples.
batchRunReports Il s'agit d'une version par lot de la méthode runReport, qui vous permet de générer plusieurs rapports à l'aide d'un seul appel d'API.
runPivotReport Cette méthode renvoie un rapport croisé dynamique personnalisé de vos données d'événements Google Analytics. Les rapports croisés dynamiques sont des formats plus avancés et plus expressifs que les rapports standards. Chaque pivot décrit les colonnes et les lignes de dimension visibles dans la réponse du rapport.
batchRunPivotReports
Il s'agit d'une version par lot de la méthode runPivotReport, qui vous permet de générer plusieurs rapports à l'aide d'un seul appel d'API.
getMetadata Cette méthode renvoie les métadonnées des dimensions et des métriques disponibles dans les méthodes de création de rapports. Permet d'explorer les dimensions et les métriques. La réponse de cette méthode inclut également les dimensions et métriques personnalisées disponibles pour la propriété Google Analytics spécifiée.
checkCompatibility Cette méthode liste les dimensions et les métriques pouvant être ajoutées à une requête de rapport et assurer la compatibilité.
runRealtimeReport : cette méthode renvoie un rapport personnalisé sur les données d'événements en temps réel pour votre propriété. Les événements apparaissent dans les rapports en temps réel quelques secondes après avoir été envoyés à Google Analytics. Les rapports "Temps réel" affichent les événements et les données d'utilisation pour les périodes allant du moment présent à 30 minutes en arrière (jusqu'à 60 minutes pour les propriétés Google Analytics 360).
properties.recurringAudienceLists(Preview anticipé) : groupe de méthodes qui vous permettent de gérer les exportations d'audience récurrentes. Une exportation d'audience récurrente génère de nouvelles listes d'audience chaque jour.
runFunnelReport(Preview anticipée) Cette méthode renvoie un rapport sur l'entonnoir personnalisé de vos données d'événement Google Analytics. L'exploration de l'entonnoir vous permet de visualiser les étapes suivies par vos utilisateurs afin d'exécuter une tâche. Ainsi, vous voyez rapidement s'ils réussissent ou s'ils échouent à chacune des étapes en question.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/03/10 (UTC).
[null,null,["Dernière mise à jour le 2025/03/10 (UTC)."],[[["\u003cp\u003eThe Google Analytics Data API (v1) allows programmatic access to Google Analytics report data, excluding Universal Analytics properties.\u003c/p\u003e\n"],["\u003cp\u003eThis API offers methods for retrieving various report types, including standard, pivot, realtime, and funnel reports, and enables tasks like building custom dashboards and automating reporting.\u003c/p\u003e\n"],["\u003cp\u003eUsers can leverage client libraries in Java, Python, Node.js, and other languages for streamlined implementation.\u003c/p\u003e\n"],["\u003cp\u003eThe API is currently in Alpha and Beta stages with potential for breaking changes, particularly in Alpha features.\u003c/p\u003e\n"],["\u003cp\u003eComprehensive documentation, including API schema, quickstart guides, and reference materials, are available to aid developers in utilizing the API effectively.\u003c/p\u003e\n"]]],["The Google Analytics Data API allows programmatic access to report data, excluding legacy Universal Analytics properties. It offers Alpha and Beta channels with varying stability. Key actions include generating reports (simple, pivot, funnel, real-time), batching reports, retrieving metadata, and checking compatibility. The API can build dashboards, automate reporting, and integrate data with other apps. Client libraries simplify implementation. Methods include `runReport`, `runPivotReport`, `runFunnelReport`, and managing audience exports, among others.\n"],null,["# Google Analytics Data API Overview\n\nYou can use the [Data API](/analytics/devguides/reporting/data/v1/rest) to\nprogrammatically access Google Analytics (Google Analytics) report data. This\nAPI isn't compatible with legacy Universal Analytics properties.\n\n[Learn more about Google Analytics\nproperties](//support.google.com/analytics/answer/9325020).\n| This API provides features in Alpha and Beta channels. Alpha and Beta products may have limited support, and changes to these products may not be compatible with other Alpha and Beta versions.\n|\n| **Alpha**:\n| Features are in an early preview stage. While we try to notify you of\n| upcoming changes, expect to encounter breaking changes before the API is publicly released.\n|\n| **Beta**:\n| No breaking changes are expected in this channel.\n|\n| For official Google Analytics API announcements, subscribe to the\n| [Google Analytics API Notify Group](https://groups.google.com/forum/#!forum/google-analytics-api-notify).\n\nHere are some examples you might report on using the Google Analytics Data API v1:\n\n- How many daily active users has your Android app had in the last week.\n- How many page views the top 10 pages on your site had in the last 28 days.\n- How many active users per country your iOS app had in the last 30 minutes.\n\nYou can also use the Google Analytics Data API v1 to do the following:\n\n- Build custom dashboards to display Google Analytics data.\n- Automate complex reporting tasks to save time.\n- Integrate your Google Analytics data with other business applications.\n\nGet started\n-----------\n\nTo get started, see the [client library\nquickstart](/analytics/devguides/reporting/data/v1/quickstart-client-libraries). There are client libraries in Java,\nPython, Node.js, and other languages to simplify your implementation.\n\nAvailable methods\n-----------------\n\nHere's a list of the Data API methods. For more details, see the [reference\ndocumentation](/analytics/devguides/reporting/data/v1/rest).\n\n- [`runReport`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport) This method returns a customized report of your Google Analytics event data and is the preferred method for [simple report queries](/analytics/devguides/reporting/data/v1/basics).\n- [`batchRunReports`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/batchRunReports) This is a batch version of the runReport method which lets you generate multiple reports using a single API call.\n- [`runPivotReport`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runPivotReport) This method returns a customized [pivot report](/analytics/devguides/reporting/data/v1/pivots) of you Google Analytics event data. Pivot reports are more advanced and expressive formats than regular reports. Each pivot describes the visible dimension columns and rows in the report response.\n- [`batchRunPivotReports`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/batchRunPivotReports) This is a batch version of the runPivotReport method which lets you generate multiple reports using a single API call.\n- [`getMetadata`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/getMetadata) This method returns metadata for dimensions and metrics available in reporting methods. Used to explore the dimensions and metrics. The response of this method also includes the Custom dimensions and metrics available for the specified Google Analytics property.\n- [`checkCompatibility`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/checkCompatibility) This method lists dimensions and metrics that can be added to a report request and maintain compatibility.\n- [`runRealtimeReport`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runRealtimeReport) This method returns a customized [report of realtime event data](/analytics/devguides/reporting/data/v1/realtime-basics) for your property. Events appear in realtime reports seconds after they have been sent to the Google Analytics. Realtime reports show events and usage data for the periods of time ranging from the present moment to 30 minutes ago (up to 60 minutes for Google Analytics 360 properties).\n- [`properties.audienceExports`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports) A group of methods that let you [generate Audience\n Exports](/analytics/devguides/reporting/data/v1/audience-export-basics), which include a snapshot of the users in an audience.\n- [`properties.recurringAudienceLists`](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.recurringAudienceLists) **(Early preview)** A group of methods that let you manage recurring Audience Exports. A recurring audience export produces new audience lists each day.\n- [`runFunnelReport`](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties/runFunnelReport) **(Early preview)** This method returns a customized [funnel\n report](/analytics/devguides/reporting/data/v1/funnels) of your Google Analytics event data. Funnel exploration lets you visualize the steps your users take to complete a task and quickly see how well they are succeeding or failing at each step.\n\nSupported dimensions and metrics\n--------------------------------\n\nFor a list of all the dimensions and metrics supported by the Data API, see the\n[API schema documentation](/analytics/devguides/reporting/data/v1/api-schema)."]]
