google-analytics-api · Google Analytics V3, qui inclut l'API Core Reporting, l'API de gestion, l'API MetaData et un certain nombre d'autres API. Ces API renvoient Json Google Analytics

google-analytics-api

#google-

analytics-

api

Table des matières

À propos 1

Chapitre 1: Démarrer avec google-analytics-api 2

Remarques 2

Versions 4

Examples 4

Accès aux API Google Analytics 4

introduction 5

Hello World Reporting API - Reste 7

Chapitre 2: API de reporting (Analytics v4) 9

Remarques 9

Examples 9

Exemple de rapport unique utilisant Oauth2 C # 9

Exemple de rapport unique Reste 10

Chapitre 3: API temps réel 12

Syntaxe 12

Paramètres 12

Remarques 13

Examples 14

Exemple PHP 14

Chapitre 4: Authentification 17

Syntaxe 17

Paramètres 17

Remarques 17

Examples 19

Oauth2 C # 19

Authentification du compte de service Vb.net 20

Chapitre 5: Métadonnées api 22

Syntaxe 22

Paramètres 22

Remarques 22

Examples 22

Exemple de repos 22

Exemple Java 23

Exemple PHP 24

Exemple Python 25

C # exemple 26

Chapitre 6: Réponses d'erreur 28

Syntaxe 28

Paramètres 28

Remarques 29

Examples 29

400 Paramètre invalide 29

Crédits 31

À propos

You can share this PDF with anyone you feel could benefit from it, downloaded the latest version from: google-analytics-api

It is an unofficial and free google-analytics-api ebook created for educational purposes. All the content is extracted from Stack Overflow Documentation, which is written by many hardworking individuals at Stack Overflow. It is neither affiliated with Stack Overflow nor official google-analytics-api.

The content is released under Creative Commons BY-SA, and the list of contributors to each chapter are provided in the credits section at the end of this book. Images may be copyright of their respective owners unless otherwise specified. All trademarks and registered trademarks are the property of their respective company owners.

Use the content presented in this book at your own risk; it is not guaranteed to be correct nor accurate, please send your feedback and corrections to [email protected]

https://riptutorial.com/fr/home 1

http://riptutorial.com/ebook/google-analytics-apihttps://archive.org/details/documentation-dump.7zmailto:[email protected]

Chapitre 1: Démarrer avec google-analytics-api

Remarques

Les API Google Analytics vous permettent d'accéder aux données de Google Analytics. Il ne faut pas confondre avec le protocole de mesure utilisé pour insérer des données dans Google Analytics .

L'API Google Analytics est divisée en plusieurs parties.

API de génération de rapports Google Analytics

L' API Google Analytics Core Reporting v3 vous donne accès à la plupart des données de rapport dans Google Analytics. Avec l'API Core Reporting, vous pouvez:

Créez des tableaux de bord personnalisés pour afficher les données Google Analytics.•Gagnez du temps en automatisant des tâches de reporting complexes.•Intégrez vos données Google Analytics à d'autres applications métier.•

1.

L' API de reporting de Google Analytics V4 est la méthode de programmation la plus avancée pour accéder aux données de rapport dans Google Analytics. Avec l'API de rapport Google Analytics, vous pouvez:

Créez des tableaux de bord personnalisés pour afficher les données Google Analytics.•Automatisez les tâches de reporting complexes pour gagner du temps.•Intégrez vos données Google Analytics à d'autres applications métier.•

2.

L' API de génération de rapports en temps réel vous permet de demander des données en temps réel, par exemple une activité en temps réel sur une vue, pour un utilisateur authentifié. Vous pouvez utiliser l'API de reporting en temps réel pour:

Afficher les visualiseurs actifs d'une page et créer un sentiment d'urgence pour les utilisateurs qui regardent un élément avec un inventaire fini.

•

Affichez le contenu le plus populaire, tel que les 10 premières pages actives.•Créez et affichez un tableau de bord en temps réel.•

2.

L'API de génération de rapports en temps réel, en version bêta limitée, est disponible uniquement pour un aperçu des développeurs. Inscrivez-vous pour accéder à l'API.

L' API de rapport sur les entonnoirs multicanaux vous permet de demander des données sur les entonnoirs multicanaux pour un utilisateur authentifié. Les données sont dérivées des données de chemin de conversion, qui montrent les interactions de l'utilisateur avec différentes sources de trafic sur plusieurs sessions avant la conversion. Cela vous permet d'analyser comment plusieurs canaux marketing influencent les conversions au fil du temps. Pour plus de détails sur les données disponibles, lisez l'article À propos des entonnoirs

3.


https://developers.google.com/analytics/devguides/reporting/https://developers.google.com/analytics/devguides/collection/protocol/v1/?hl=enhttps://analytics.google.com/analytics/web/https://analytics.google.com/analytics/web/https://developers.google.com/analytics/devguides/reporting/core/v3/https://developers.google.com/analytics/devguides/reporting/core/v4/https://developers.google.com/analytics/devguides/reporting/realtime/v3/https://developers.google.com/analytics/devguides/reporting/realtime/v3/https://docs.google.com/forms/d/e/1FAIpQLSc9OpoDGB3tBD7oy1OG9fyum8KBIxs-2ihPCsHp13WTnM-SSQ/viewformhttps://developers.google.com/analytics/devguides/reporting/mcf/v3/

multicanaux, ainsi que À propos des données sur les entonnoirs multicanaux. Grâce à l'API de reporting des entonnoirs multicanaux, vous pouvez:

Créez des rapports personnalisés à l'aide de données d'entonnoirs multicanaux. Par exemple, vous pouvez utiliser les données relatives aux chemins de conversion supérieurs pour signaler des attributs tels que la position relative des interactions dans un chemin de conversion.

•

Intégrez les données sur les entonnoirs multicanaux à vos données professionnelles. Par exemple, vous pouvez mettre en corrélation les données de conversion en ligne avec les données de vente hors ligne et les données de coût des médias pour obtenir une image plus complète du retour sur investissement marketing.

•

Afficher les entonnoirs multicanaux dans de nouveaux environnements. Par exemple, vous pouvez créer des visualisations et d'autres présentations des données qui communiquent la valeur de différents canaux marketing dans les conversions.

•

Des aides

L' API de métadonnées renvoie la liste et les attributs des colonnes (c.-à-d. Dimensions et métriques) exposées dans les API de génération de rapports de Google Analytics. Les attributs renvoyés incluent le nom de l'interface utilisateur, la description, la prise en charge des segments, etc. Vous pouvez utiliser l'API de métadonnées pour:

Détecter automatiquement de nouvelles colonnes.•Accédez à tous les attributs de dimensions et de métriques pour les API de génération de rapports Google Analytics.

•

1.

Remarque: cette fonction ne renvoie que les métadonnées de l’API Core Reporting et de l’API de génération de rapports. Pas de métadonnées en temps réel.

L' API intégrée Google Analytics est une bibliothèque JavaScript qui vous permet de créer et d'intégrer facilement un tableau de bord sur un site Web tiers en quelques minutes. Il vous fournit un ensemble de composants enfichables qui peuvent fonctionner ensemble pour créer des outils complexes, les rendant à la fois simples et puissants.

2.

API de configuration

L' API Analytics Management permet un accès par programme aux données de configuration de Google Analytics. Vous pouvez créer des applications pour gérer plus efficacement des comptes Google Analytics volumineux ou complexes. Les grandes entreprises possédant de nombreuses propriétés peuvent automatiser la configuration des comptes. Même si vous créez une application de génération de rapports, l'API de gestion fournit des outils pour naviguer dans votre compte. Vous pouvez utiliser l'API de gestion Google Analytics pour:

Répertorie toutes les informations de compte, de propriété et d'affichage pour un utilisateur.

•

Gérer les propriétés, les vues et les objectifs.•Gérer les autorisations utilisateur pour une hiérarchie de compte.•

1.


https://developers.google.com/analytics/devguides/reporting/metadata/v3/https://developers.google.com/analytics/devguides/reporting/embed/v1/https://developers.google.com/analytics/devguides/reporting/embed/v1/https://developers.google.com/analytics/devguides/config/mgmt/v3/

Récupérez un ID de vue à utiliser avec l'API Core Reporting.•Déterminez quels objectifs sont actifs et accédez à leurs noms configurés.•Gérer les liens entre les propriétés Analytics et les comptes AdWords.•Gérer les audiences de remarketing.•

Les opérations d'écriture dans l'API de gestion (par exemple, créer, mettre à jour, supprimer, appliquer un correctif) pour les ressources de propriété Web, View (Profile) et Goal sont actuellement disponibles en tant que prévisualisation de développeur en version bêta limitée . Si vous souhaitez utiliser ces fonctionnalités, demandez l’accès à la version bêta .

L' API d'approvisionnement peut être utilisée pour créer de nouveaux comptes Google Analytics et activer Google Analytics pour vos clients à grande échelle. Il est destiné aux prestataires de services qualifiés et aux grands partenaires. Par exemple, vous pouvez utiliser l'API d'approvisionnement dans le cadre d'un nouveau processus d'intégration utilisateur pour créer un nouveau compte Google Analytics pour un client, puis utiliser des ressources API de gestion supplémentaires pour configurer le compte par programme et le lier à AdWords. Cela peut être automatisé et initié à partir de votre propre interface d'administration ou de rapports.

2.

L'API d'approvisionnement est disponible sur invitation uniquement. Nous n'acceptons pas actuellement de nouveaux projets.

Versions

Il existe actuellement trois versions de l'API Google Analytics en direct.

Google Analytics V2 version 2.4 de l'API Core Reporting est une API XML uniquement compatible avec la version 2.3. (Héritage)

Google Analytics V3, qui inclut l'API Core Reporting, l'API de gestion, l'API MetaData et un certain nombre d'autres API. Ces API renvoient Json

Google Analytics V4, qui n'inclut actuellement que l'API de reporting, est considéré comme le moyen le plus avancé de récupérer des données de reporting depuis Google Analytics.

Examples

Accès aux API Google Analytics

Vous pouvez techniquement accéder aux API Google Analytics à l'aide de tout langage de programmation capable de gérer une demande HTTP Post ou HTTP Get .

Cela étant dit, Google a également créé un certain nombre de bibliothèques client standard officielles pour vous aider. Utiliser une bibliothèque client standard pour votre langage de programmation choisi peut être beaucoup plus facile que de la coder vous-même.


https://docs.google.com/forms/d/e/1FAIpQLSf01NWo9R-SOHLKDUH0U4gWHNDBIY-gEI-zqBMG1Hyh3_hHZw/viewformhttps://docs.google.com/forms/d/e/1FAIpQLSf01NWo9R-SOHLKDUH0U4gWHNDBIY-gEI-zqBMG1Hyh3_hHZw/viewformhttps://developers.google.com/analytics/devguides/config/provisioning/v3/https://developers.google.com/analytics/devguides/reporting/core/v2/https://developers.google.com/analytics/devguides/reporting/core/v3/https://developers.google.com/analytics/devguides/reporting/core/v4/https://en.wikipedia.org/wiki/POST_(HTTP)https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol#Request_methods

Bibliothèques client OFFICAL avec prise en charge de l'API Google Analytics:

Bibliothèque de PHP pour les API Google - GitHub1. Bibliothèque Google API .Net Client - GitHub NuGet2. Bibliothèque de clients Python des API Google - GitHub3. Bibliothèque du client Java des API Google - lien4. Bibliothèque Objective-C des API Google - GitHub5.

Il y a plus de bibliothèques ici .

introduction

Les API Google Analytics vous permettent d'accéder aux données de Google Analytics. Il ne faut pas confondre avec le protocole de mesure utilisé pour insérer des données dans Google Analytics .

L'API Google Analytics est divisée en plusieurs parties.

API de génération de rapports Google Analytics

L' API Google Analytics Core Reporting v3 vous donne accès à la plupart des données de rapport dans Google Analytics. Avec l'API Core Reporting, vous pouvez:

Créez des tableaux de bord personnalisés pour afficher les données Google Analytics.•Gagnez du temps en automatisant des tâches de reporting complexes.•Intégrez vos données Google Analytics à d'autres applications métier.•

1.

L' API de reporting de Google Analytics V4 est la méthode de programmation la plus avancée pour accéder aux données de rapport dans Google Analytics. Avec l'API de rapport Google Analytics, vous pouvez:

Créez des tableaux de bord personnalisés pour afficher les données Google Analytics.•Automatisez les tâches de reporting complexes pour gagner du temps.•Intégrez vos données Google Analytics à d'autres applications métier.•

2.

L' API de génération de rapports en temps réel vous permet de demander des données en temps réel, par exemple une activité en temps réel sur une vue, pour un utilisateur authentifié. Vous pouvez utiliser l'API de reporting en temps réel pour:


•


2.


L' API de rapport sur les entonnoirs multicanaux vous permet de demander des données sur les entonnoirs multicanaux pour un utilisateur authentifié. Les données sont dérivées des

3.


https://github.com/google/google-api-php-clienthttps://github.com/google/google-api-dotnet-clienthttps://www.nuget.org/profiles/google-apis-packageshttps://github.com/google/google-api-python-clienthttps://developers.google.com/api-client-library/java/https://github.com/google/google-api-objectivec-clienthttp://Google%20APIs%20Client%20Librarieshttps://developers.google.com/analytics/devguides/reporting/https://developers.google.com/analytics/devguides/collection/protocol/v1/?hl=enhttps://analytics.google.com/analytics/web/https://analytics.google.com/analytics/web/https://developers.google.com/analytics/devguides/reporting/core/v3/https://developers.google.com/analytics/devguides/reporting/core/v4/https://developers.google.com/analytics/devguides/reporting/realtime/v3/https://developers.google.com/analytics/devguides/reporting/realtime/v3/https://docs.google.com/forms/d/e/1FAIpQLSc9OpoDGB3tBD7oy1OG9fyum8KBIxs-2ihPCsHp13WTnM-SSQ/viewformhttps://developers.google.com/analytics/devguides/reporting/mcf/v3/

données de chemin de conversion, qui montrent les interactions de l'utilisateur avec différentes sources de trafic sur plusieurs sessions avant la conversion. Cela vous permet d'analyser comment plusieurs canaux marketing influencent les conversions au fil du temps. Pour plus de détails sur les données disponibles, lisez l'article À propos des entonnoirs multicanaux, ainsi que À propos des données sur les entonnoirs multicanaux. Grâce à l'API de reporting des entonnoirs multicanaux, vous pouvez:

Créez des rapports personnalisés à l'aide de données d'entonnoirs multicanaux. Par exemple, vous pouvez utiliser les données relatives aux chemins de conversion supérieurs pour signaler des attributs tels que la position relative des interactions dans un chemin de conversion.

•

Intégrez les données sur les entonnoirs multicanaux à vos données professionnelles. Par exemple, vous pouvez mettre en corrélation les données de conversion en ligne avec les données de vente hors ligne et les données de coût des médias pour obtenir une image plus complète du retour sur investissement marketing.

•

Afficher les entonnoirs multicanaux dans de nouveaux environnements. Par exemple, vous pouvez créer des visualisations et d'autres présentations des données qui communiquent la valeur de différents canaux marketing dans les conversions.

•

Des aides

L' API de métadonnées renvoie la liste et les attributs des colonnes (c.-à-d. Dimensions et métriques) exposées dans les API de génération de rapports de Google Analytics. Les attributs renvoyés incluent le nom de l'interface utilisateur, la description, la prise en charge des segments, etc. Vous pouvez utiliser l'API de métadonnées pour:

Détecter automatiquement de nouvelles colonnes.•Accédez à tous les attributs de dimensions et de métriques pour les API de génération de rapports Google Analytics.

•

1.

Remarque: cette fonction ne renvoie que les métadonnées de l’API Core Reporting et de l’API de génération de rapports. Pas de métadonnées en temps réel.

L' API intégrée Google Analytics est une bibliothèque JavaScript qui vous permet de créer et d'intégrer facilement un tableau de bord sur un site Web tiers en quelques minutes. Il vous fournit un ensemble de composants enfichables qui peuvent fonctionner ensemble pour créer des outils complexes, les rendant à la fois simples et puissants.

2.

API de configuration

L' API Analytics Management permet un accès par programme aux données de configuration de Google Analytics. Vous pouvez créer des applications pour gérer plus efficacement des comptes Google Analytics volumineux ou complexes. Les grandes entreprises possédant de nombreuses propriétés peuvent automatiser la configuration des comptes. Même si vous créez une application de génération de rapports, l'API de gestion fournit des outils pour naviguer dans votre compte. Vous pouvez utiliser l'API de gestion Google Analytics pour:

1.


https://developers.google.com/analytics/devguides/reporting/metadata/v3/https://developers.google.com/analytics/devguides/reporting/embed/v1/https://developers.google.com/analytics/devguides/reporting/embed/v1/https://developers.google.com/analytics/devguides/config/mgmt/v3/

Répertorie toutes les informations de compte, de propriété et d'affichage pour un utilisateur.

•

Gérer les propriétés, les vues et les objectifs.•Gérer les autorisations utilisateur pour une hiérarchie de compte.•Récupérez un ID de vue à utiliser avec l'API Core Reporting.•Déterminez quels objectifs sont actifs et accédez à leurs noms configurés.•Gérer les liens entre les propriétés Analytics et les comptes AdWords.•Gérer les audiences de remarketing.•

Les opérations d'écriture dans l'API de gestion (par exemple, créer, mettre à jour, supprimer, appliquer un correctif) pour les ressources de propriété Web, View (Profile) et Goal sont actuellement disponibles en tant que prévisualisation de développeur en version bêta limitée . Si vous souhaitez utiliser ces fonctionnalités, demandez l’accès à la version bêta .

L' API d'approvisionnement peut être utilisée pour créer de nouveaux comptes Google Analytics et activer Google Analytics pour vos clients à grande échelle. Il est destiné aux prestataires de services qualifiés et aux grands partenaires. Par exemple, vous pouvez utiliser l'API d'approvisionnement dans le cadre d'un nouveau processus d'intégration utilisateur pour créer un nouveau compte Google Analytics pour un client, puis utiliser des ressources API de gestion supplémentaires pour configurer le compte par programme et le lier à AdWords. Cela peut être automatisé et initié à partir de votre propre interface d'administration ou de rapports.

2.

L'API d'approvisionnement est disponible sur invitation uniquement. Nous n'acceptons pas actuellement de nouveaux projets.

Hello World Reporting API - Reste

POST https://analyticsreporting.googleapis.com/v4/reports:batchGet?access_token={Access token from auth request} { "reportRequests":[ { "viewId":"XXXX", "dateRanges":[ { "startDate":"2015-06-15", "endDate":"2015-06-30" }], "metrics":[ { "expression":"ga:sessions" }], "dimensions": [ { "name":"ga:browser" }] }] }

Lire Démarrer avec google-analytics-api en ligne: https://riptutorial.com/fr/google-analytics-


https://docs.google.com/forms/d/e/1FAIpQLSf01NWo9R-SOHLKDUH0U4gWHNDBIY-gEI-zqBMG1Hyh3_hHZw/viewformhttps://docs.google.com/forms/d/e/1FAIpQLSf01NWo9R-SOHLKDUH0U4gWHNDBIY-gEI-zqBMG1Hyh3_hHZw/viewformhttps://developers.google.com/analytics/devguides/config/provisioning/v3/https://riptutorial.com/fr/google-analytics-api/topic/7253/demarrer-avec-google-analytics-api

api/topic/7253/demarrer-avec-google-analytics-api


https://riptutorial.com/fr/google-analytics-api/topic/7253/demarrer-avec-google-analytics-api

Chapitre 2: API de reporting (Analytics v4)

Remarques

L' API de reporting de Google Analytics V4 est la méthode de programmation la plus avancée pour accéder aux données de rapport dans Google Analytics . Avec l'API de rapport Google Analytics, vous pouvez:

Créez des tableaux de bord personnalisés pour afficher les données Google Analytics .•Automatisez les tâches de reporting complexes pour gagner du temps.•Intégrez vos données Google Analytics à d'autres applications métier.•

Caractéristiques

Google Analytics s'appuie sur une puissante infrastructure de reporting de données. L'API V4 de Google Analytics Reporting vous permet d'accéder à la puissance de la plateforme Google Analytics . L'API fournit ces fonctionnalités clés:

Expressions de métriques: L'API vous permet de demander non seulement des métriques intégrées, mais également une combinaison de métriques exprimées dans des opérations mathématiques. Par exemple, vous pouvez utiliser l'expression ga: goal1completions / ga: sessions pour demander la finalisation des objectifs par nombre de sessions.

•

Plusieurs plages de dates: L'API vous permet, dans une seule requête, d'obtenir des données dans deux plages de dates.

•

Valeur des cohortes et de la durée de vie: L'API dispose d'un vocabulaire riche pour demander des rapports de valeur de cohorte et de durée de vie.

•

Plusieurs segments: L'API vous permet d'obtenir plusieurs segments dans une même requête.

•

Examples

Exemple de rapport unique utilisant Oauth2 C #

Cet exemple utilise la bibliothèque officielle du client Google .net.

PM> Package d'installation Google.Apis.AnalyticsReporting.v4

Autorisation Requiert l'une des portées OAuth suivantes:

https://www.googleapis.com/auth/analytics.readonly•https://www.googleapis.com/auth/analytics•

Oauth2

// These are the scopes of permissions you need. string[] scopes = new string[] { AnalyticsReportingService.Scope.AnalyticsReadonly }; //


https://developers.google.com/analytics/devguides/reporting/core/v4/https://analytics.google.com/analytics/webhttps://analytics.google.com/analytics/webhttps://analytics.google.com/analytics/webhttps://analytics.google.com/analytics/webhttps://analytics.google.com/analytics/webhttps://analytics.google.com/analytics/webhttps://analytics.google.com/analytics/webhttps://www.nuget.org/packages/Google.Apis.AnalyticsReporting.v4/https://www.googleapis.com/auth/analytics.readonlyhttps://www.googleapis.com/auth/analytics

View your Google Analytics Data UserCredential credential; using (var stream = new FileStream(clientSecretJson, FileMode.Open, FileAccess.Read)) { string credPath = System.Environment.GetFolderPath(System.Environment.SpecialFolder.Personal); credPath = Path.Combine(credPath, ".credentials/", System.Reflection.Assembly.GetExecutingAssembly().GetName().Name); // Requesting Authentication or loading previously stored authentication for userName credential = GoogleWebAuthorizationBroker.AuthorizeAsync(GoogleClientSecrets.Load(stream).Secrets, scopes, userName, CancellationToken.None, new FileDataStore(credPath, true)).Result; } // Create Reporting API service. var service = new AnalyticsReportingService(new BaseClientService.Initializer() { HttpClientInitializer = credential, ApplicationName = string.Format("{0} Authentication", System.Reflection.Assembly.GetExecutingAssembly().GetName().Name), });

Demande de rapport

// Create the DateRange object. DateRange June2015 = new DateRange() { StartDate = "2015-01-01", EndDate = "2015-06-30" }; DateRange June2016 = new DateRange() { StartDate = "2016-01-01", EndDate = "2016-06-30" }; List dateRanges = new List() { June2016, June2015 }; // Create the ReportRequest object. // This should have a large number of rows ReportRequest reportRequest = new ReportRequest { ViewId = ConfigurationManager.AppSettings["GoogleAnaltyicsViewId"], DateRanges = dateRanges, Dimensions = new List() { new Dimension() { Name = "ga:date" }, new Dimension() { Name = "ga:usertype" } }, Metrics = new List() { new Metric() { Expression= "ga:users" }, new Metric() { Expression = "ga:sessions" } }, PageSize = 1000, }; List requests = new List(); requests.Add(reportRequest); var getReport = new GetReportsRequest() { ReportRequests = requests }; var response = service.Reports.BatchGet(getReport).Execute();

Exemple de rapport unique Reste

Les demandes d'API sont HTTP POST avec le jeton d'accès attaché à la fin du point de


terminaison de l'API.

Autorisation Requiert l'une des portées OAuth suivantes:

https://www.googleapis.com/auth/analytics.readonly•https://www.googleapis.com/auth/analytics•

Remarque lors de la publication des données, utilisez ContentType = "application/Json";

https://analyticsreporting.googleapis.com/v4/reports:batchGet?Access_token={from auth} { "reportRequests":[ { "viewId":"XXXX", "dateRanges":[ { "startDate":"2015-06-15", "endDate":"2015-06-30" }], "metrics":[ { "expression":"ga:sessions" }], "dimensions": [ { "name":"ga:browser" }] }] }

Lire API de reporting (Analytics v4) en ligne: https://riptutorial.com/fr/google-analytics-api/topic/7265/api-de-reporting--analytics-v4-


https://www.googleapis.com/auth/analytics.readonlyhttps://www.googleapis.com/auth/analyticshttps://riptutorial.com/fr/google-analytics-api/topic/7265/api-de-reporting--analytics-v4-https://riptutorial.com/fr/google-analytics-api/topic/7265/api-de-reporting--analytics-v4-

Chapitre 3: API temps réel

Syntaxe

GET https://www.googleapis.com/analytics/v3/data/realtime?ids=[Analytics view Id] & metrics = [Métriques en temps réel] & access_token = [Access_token_from_Authentcation]

•

GET https://www.googleapis.com/analytics/v3/data/realtime?ids=[Analytics view Id] & metrics = [métriques en temps réel] & dimensions = [métriques en temps réel] & access_token = [Access_token_from_Authentation]

•

Paramètres

(Obligatoire) Nom du paramètre

La description

les identifiantsID de table unique pour la récupération des données Analytics. L'ID de la table est de la forme ga: XXXX, où XXXX est l'ID de la vue analytique (profil).

métriqueUne liste de métriques Analytics séparées par des virgules. Par exemple, 'rt: activeUsers'. Au moins une métrique doit être spécifiée.

(Facultatif) Nom du paramètre

La description

dimensionsUne liste de dimensions en temps réel séparées par des virgules. Par exemple, 'rt: medium, rt: city'.

les filtresUne liste de filtres de dimension ou de métrique séparés par des virgules à appliquer aux données en temps réel.

max-result Le nombre maximal d'entrées à inclure dans ce flux.

TrierListe de dimensions ou de métriques séparées par des virgules qui déterminent l'ordre de tri des données en temps réel.

(Standard) Nom du paramètre

La description

rappelerNom de la fonction de rappel JavaScript qui gère la réponse. Utilisé dans les requêtes JavaScript JSON-P.

Renvoie la réponse dans un format lisible si true. Valeur par défaut: true. Si jolieImprimer


https://www.googleapis.com/analytics/v3/data/realtime?ids=%5BAnalyticshttps://www.googleapis.com/analytics/v3/data/realtime?ids=%5BAnalytics

(Obligatoire) Nom du paramètre

La description

c'est faux, cela peut réduire la taille de la charge utile de la réponse, ce qui peut améliorer les performances dans certains environnements.

quotaUser

Vous permet d'appliquer des quotas par utilisateur à partir d'une application côté serveur, même lorsque l'adresse IP de l'utilisateur est inconnue. Cela peut se produire, par exemple, avec des applications qui exécutent des tâches cron sur App Engine pour le compte d'un utilisateur. Vous pouvez choisir n'importe quelle chaîne arbitraire qui identifie de manière unique un utilisateur, mais elle est limitée à 40 caractères.Overrides userIp si les deux sont fournis. En savoir plus sur le plafonnement de l'utilisation

userIpVous permet d'appliquer des quotas par utilisateur lors de l'appel de l'API à partir d'une application côté serveur. En savoir plus sur le plafonnement de l'utilisation

Remarques


L' API de génération de rapports en temps réel vous permet de demander des données en temps réel, par exemple une activité en temps réel sur votre propriété, pour un utilisateur authentifié.

Vous pouvez utiliser l'API de reporting en temps réel pour:


•


Autorisation

Les appels à l'API en temps réel de Google Analytics nécessitent une autorisation avec au moins l'une des portées suivantes (pour en savoir plus sur l'authentification et l'autorisation).

Portée accès autorisé

https://www.googleapis.com/auth/analyticsAccès complet aux comptes Google Analytics jusqu'au niveau d'accès des utilisateurs authentifiés.

Accès en lecture seule aux comptes Google Analytics des utilisateurs

https://www.googleapis.com/auth/analytics.readonly


https://docs.google.com/forms/d/e/1FAIpQLSc9OpoDGB3tBD7oy1OG9fyum8KBIxs-2ihPCsHp13WTnM-SSQ/viewformhttps://developers.google.com/analytics/devguides/reporting/realtime/v3/https://developers.google.com/analytics/devguides/reporting/realtime/v3/https://www.googleapis.com/auth/analyticshttps://www.googleapis.com/auth/analytics.readonly

Portée accès autorisé

authentifiés

Examples

Exemple PHP

Utilise la bibliothèque client PHP

/** * 1.Create and Execute a Real Time Report * An application can request real-time data by calling the get method on the Analytics service object. * The method requires an ids parameter which specifies from which view (profile) to retrieve data. * For example, the following code requests real-time data for view (profile) ID 56789. */ $optParams = array( 'dimensions' => 'rt:medium'); try { $results = $analytics->data_realtime->get( 'ga:56789', 'rt:activeUsers', $optParams); // Success. } catch (apiServiceException $e) { // Handle API service exceptions. $error = $e->getMessage(); } /** * 2. Print out the Real-Time Data * The components of the report can be printed out as follows: */ function printRealtimeReport($results) { printReportInfo($results); printQueryInfo($results); printProfileInfo($results); printColumnHeaders($results); printDataTable($results); printTotalsForAllResults($results); } function printDataTable(&$results) { if (count($results->getRows()) > 0) { $table .= ''; // Print headers. $table .= ''; foreach ($results->getColumnHeaders() as $header) { $table .= '' . $header->name . ''; } $table .= '';


https://github.com/google/google-api-php-client

// Print table rows. foreach ($results->getRows() as $row) { $table .= ''; foreach ($row as $cell) { $table .= '' . htmlspecialchars($cell, ENT_NOQUOTES) . ''; } $table .= ''; } $table .= ''; } else { $table .= '

No Results Found.

'; } print $table; } function printColumnHeaders(&$results) { $html = ''; $headers = $results->getColumnHeaders(); foreach ($headers as $header) { $html .= getDataType()} HTML; } print $html; } function printQueryInfo(&$results) { $query = $results->getQuery(); $html = getDimensions()} Sort = {$query->getSort()} Filters = {$query->getFilters()} Max Results = {$query->getMax_results()} HTML; print $html; } function printProfileInfo(&$results) { $profileInfo = $results->getProfileInfo(); $html = getInternalWebPropertyId()} Profile ID = {$profileInfo->getProfileId()} Profile Name = {$profileInfo->getProfileName()}


Table ID = {$profileInfo->getTableId()} HTML; print $html; } function printReportInfo(&$results) { $html = getSelfLink()} Total Results = {$results->getTotalResults()} HTML; print $html; } function printTotalsForAllResults(&$results) { $totals = $results->getTotalsForAllResults(); foreach ($totals as $metricName => $metricTotal) { $html .= "Metric Name = $metricName\n"; $html .= "Metric Total = $metricTotal"; } print $html; }

Version originale extraite de la documentation officielle

Lire API temps réel en ligne: https://riptutorial.com/fr/google-analytics-api/topic/7305/api-temps-reel


https://developers.google.com/analytics/devguides/reporting/realtime/v3/reference/data/realtime/gethttps://riptutorial.com/fr/google-analytics-api/topic/7305/api-temps-reelhttps://riptutorial.com/fr/google-analytics-api/topic/7305/api-temps-reel

Chapitre 4: Authentification

Syntaxe

GET https://accounts.google.com/o/oauth2/auth?client_id= {clientid} & redirect_uri = urn: ietf: wg: oauth: 2.0: oob & scope = {Scopes} & response_type = code

•

POST https://accounts.google.com/o/oauth2/token code = {Code de l'appel ci-dessus} & client_id = {ClientId} & client_secret = {ClientSecret} & redirect_uri = urn: ietf: wg: oauth: 2.0: oob & grant_type = authorization_code

•

POST https://accounts.google.com/o/oauth2/token client_id = {ClientId} & client_secret = {ClientSecret} & refresh_token = {De l'appel ci-dessus} & grant_type = refresh_token

•

Paramètres

Paramètre La description

Identité du client

De la console de développement Google identifie votre projet ou votre application

secretDe la console de développement Google identifie votre projet ou votre application

redirect_uriDe l'emplacement de Google Developer où l'authentification doit être retournée. Dans le cas d'applications natives urn:ietf:wg:oauth:2.0:oob peut être utilisé pour désigner localhost

Remarques

Pour accéder à n'importe quelle API Google, vous devez vous identifier en tant que développeur et identifier votre projet. Nous faisons cela en créant un nouveau projet sur la console Google Developers .

Lorsque vous créez votre projet, si vous souhaitez accéder aux API Google Analytics, vous devez activer les API auxquelles vous souhaitez accéder.

Reporting API : accès à l'API Google Analytics Reporting v4.•API Analytics : accès à tout le reste.•

Vous devez maintenant décider comment vous souhaitez accéder aux données.

Avec Google Data, il existe deux types de données publiques et privées.

les données publiques ne sont pas la propriété d'un utilisateur. L'API de métadonnées est une API publique pour laquelle vous n'avez pas besoin d'être connecté pour accéder à ces données.

•


https://accounts.google.com/o/oauth2/auth?client_id=https://accounts.google.com/o/oauth2/tokenhttps://accounts.google.com/o/oauth2/tokenhttps://console.developers.google.com/apis?project=daimto-tutorials-101&pli=1https://console.developers.google.com/apis?project=daimto-tutorials-101&pli=1https://console.developers.google.com/apis?project=daimto-tutorials-101&pli=1https://console.developers.google.com/iam-admin/projects?authuser=0https://console.developers.google.com/iam-admin/projects?authuser=0

L'API de reporting contient les données Google Analytics des utilisateurs dont vous ne pouvez pas les consulter, à moins que l'utilisateur ne vous ait autorisé à y accéder.

•

Si vous accédez uniquement aux données publiques, il vous suffit de créer une clé API publique et d'accéder à l'API en question. Si vous souhaitez accéder à des données d'utilisateur privées, vous devrez créer des informations d'identification Oauth2 ou des informations de compte de service.

Autorisation Oauth2

Pour accéder aux données d'utilisateur privées, nous devons avoir la permission du propriétaire des données pour y accéder. Oauth2 nous permet de demander cet accès à un utilisateur.

Vous avez probablement déjà vu avant Oauth2 auparavant.

L'application "Google Analytics Windows" demande l'accès pour afficher les données "Google Analytics" des utilisateurs

Windows Analytics est le nom du projet créé sur la console de développement Google.1. Google Analytics Data correspond à la portée des autorisations demandées.2.

Portée Nous devons indiquer à l'utilisateur ce que nous avons l'intention de faire L'API d'analyse de Google a deux portées que vous pouvez utiliser.

https://www.googleapis.com/auth/analytics.readonly1. https://www.googleapis.com/auth/analytics2.

Il est préférable de ne demander que les portées dont vous avez besoin. Si vous ne lisez que les données d'un utilisateur, il vous suffit de demander l'étendue readonly.

Comptes de service d'autorisation

Les comptes de service sont différents car ils sont pré-approuvés. Si vous créez des identifiants de compte de service, en tant que développeur, vous pouvez prendre le courrier électronique du compte de service et l'ajouter en tant qu'utilisateur sur votre compte Google Analytics Au niveau


https://developers.google.com/identity/protocols/OAuth2http://i.stack.imgur.com/CH3Fc.pnghttps://www.googleapis.com/auth/analytics.readonlyhttps://www.googleapis.com/auth/analyticshttps://developers.google.com/identity/protocols/OAuth2ServiceAccount

du compte, le compte de service aura accès aux données. Vous n'avez pas besoin de faire apparaître la fenêtre d'authentification et de demander l'accès. Le compte de service aura accès aux données aussi longtemps qu'il s'agira d'un utilisateur du compte Google Analytics.

Conclusion

L'authentification est nécessaire pour accéder à la plupart des données exposées par l'API Google Analytics.

Vous ne pouvez pas utiliser le login / login et le mot de passe du client pour accéder à une API Google en mai 2015. Vous devez utiliser l'authentification Open.

**

Examples

Oauth2 C #

L'exemple utilise la bibliothèque cliente Google APIs Dotnet .

PM> Install-Package Google.Apis.AnalyticsReporting.v4

/// /// This method requests Authentcation from a user using Oauth2. /// Credentials are stored in System.Environment.SpecialFolder.Personal /// Documentation https://developers.google.com/accounts/docs/OAuth2 /// /// Path to the client secret json file from Google Developers console. /// Identifying string for the user who is being authentcated. /// DriveService used to make requests against the Drive API public static AnalyticsReportingService AuthenticateOauth(string clientSecretJson, string userName) { try { if (string.IsNullOrEmpty(userName)) throw new Exception("userName is required."); if (string.IsNullOrEmpty(clientSecretJson)) throw new Exception("clientSecretJson is required."); if (!File.Exists(clientSecretJson)) throw new Exception("clientSecretJson file does not exist."); // These are the scopes of permissions you need. string[] scopes = new string[] { AnalyticsReportingService.Scope.AnalyticsReadonly }; // View your Google Analytics Data UserCredential credential; using (var stream = new FileStream(clientSecretJson, FileMode.Open, FileAccess.Read)) { string credPath = System.Environment.GetFolderPath(System.Environment.SpecialFolder.Personal);


https://developers.google.com/api-client-library/dotnet/

credPath = Path.Combine(credPath, ".credentials/", System.Reflection.Assembly.GetExecutingAssembly().GetName().Name); // Requesting Authentication or loading previously stored authentication for userName credential = GoogleWebAuthorizationBroker.AuthorizeAsync(GoogleClientSecrets.Load(stream).Secrets, scopes, userName, CancellationToken.None, new FileDataStore(credPath, true)).Result; } // Create Drive API service. return new AnalyticsReportingService(new BaseClientService.Initializer() { HttpClientInitializer = credential, ApplicationName = string.Format("{0} Authentication", System.Reflection.Assembly.GetExecutingAssembly().GetName().Name), }); } catch (Exception ex) { Console.WriteLine("Create Oauth2 DriveService failed" + ex.Message); throw new Exception("CreateOauth2DriveFailed", ex); } }

Authentification du compte de service Vb.net

Exemple utilise Install-Package Google.Apis.AnalyticsReporting.v4

Public Shared Function getServiceInitializer() As BaseClientService Dim serviceAccountCredentialFilePath = "Path to Json service account key file" REM from Google Developers console Dim myKeyEMail = "[email protected]" REM from Google Developers console Dim scope = Google.Apis.AnalyticsReporting.v4.AnalyticsReportingService.Scope.AnalyticsReadonly Try Dim credential Using stream As New FileStream(serviceAccountCredentialFilePath, FileMode.Open, FileAccess.Read) credential = GoogleCredential.FromStream(stream).CreateScoped(scope) End Using Dim Initializer As New BaseClientService.Initializer() Initializer.HttpClientInitializer = credential Initializer.ApplicationName = "SRJCGMail" Dim service As New AnalyticsReportingService(Initializer) Return service


https://www.nuget.org/packages/Google.Apis.AnalyticsReporting.v4/

Catch ex As Exception Console.WriteLine(ex.Message) Return Nothing End Try End Function

Lire Authentification en ligne: https://riptutorial.com/fr/google-analytics-api/topic/7268/authentification


https://riptutorial.com/fr/google-analytics-api/topic/7268/authentificationhttps://riptutorial.com/fr/google-analytics-api/topic/7268/authentification

Chapitre 5: Métadonnées api

Syntaxe

HTTP GET https://www.googleapis.com/analytics/v3/metadata/ {reportType} / columns? Key = {APIKey}

•

HTTP GET https://www.googleapis.com/analytics/v3/metadata/ {reportType} / columns? Access_token = {Access_token}

•

Paramètres

Le nom du paramètre

La description

type de rapportType de rapport. Valeurs autorisées: ga . Où ga correspond à l' API Core Reporting .

Remarques

L' API de métadonnées renvoie la liste et les attributs des colonnes (c.-à-d. Les dimensions et les mesures) exposées dans les API de génération de rapports Google Analytics (v2, v3 et v4). Les attributs renvoyés incluent le nom de l'interface utilisateur, la description, la prise en charge des segments, etc.

Vous pouvez utiliser l'API de métadonnées pour:

Détecter automatiquement de nouvelles colonnes•Accédez à tous les attributs de dimensions et de métriques pour les API de génération de rapports Google Analytics

•

C'est la même liste que dans l' Explorateur de dimensions et de métriques .

Remarque: les dimensions et les métriques des entonnoirs de conversion en temps réel et multicanaux ne sont pas disponibles actuellement.

Examples

Exemple de repos

Les appels à l' API de métadonnées sont effectués avec HTTP Get:

Utilisation de la clé API publique

GET https://www.googleapis.com/analytics/v3/metadata/ga/columns?key=


https://www.googleapis.com/analytics/v3/metadata/https://www.googleapis.com/analytics/v3/metadata/https://developers.google.com/analytics/devguides/reporting/core/v3/https://developers.google.com/analytics/devguides/reporting/core/v3/https://developers.google.com/analytics/devguides/reporting/metadata/v3/https://developers.google.com/analytics/devguides/reporting/core/v3/https://developers.google.com/analytics/devguides/reporting/core/dimsmetshttps://developers.google.com/analytics/devguides/reporting/metadata/v3/https://www.googleapis.com/analytics/v3/metadata/ga/columns?key=

{YOUR_API_KEY}

Utilisation du jeton d'accès à partir de l'authentification Oauth2 ou du compte de service

GET https://www.googleapis.com/analytics/v3/metadata/ga/columns?access_token= {Authentcated_Access_Token}

Exemple Java

utilise la bibliothèque Java Client

/** * 1. Execute a Metadata Request * An application can request columns data by calling the list method on the Analytics service object. * The method requires an reportType parameter that specifies the column data to retrieve. * For example, the following code requests columns for the ga report type. */ try { Columns results = getMetadata(analytics); // Success } catch (GoogleJsonResponseException e) { // Catch API specific errors. handleApiError(e); } catch (IOException e) { // Catch general parsing network errors. e.printStackTrace(); } /** * 2. Print out the Columns data * The components of the result can be printed out as follows: */ private static Columns getMetadata(Analytics analytics) throws IOException { String reportType = "ga"; return analytics.metadata() .columns() .list(reportType) .execute(); } private static void printMetadataReport(Columns results) { System.out.println("Metadata Response Report"); printReportInfo(results); printAttributes(results.getAttributeNames()); printColumns(results.getItems()); } private static void printReportInfo(Columns results) { System.out.println("## Metadata Report Info ##"); System.out.println("Kind: " + results.getKind()); System.out.println("Etag: " + results.getEtag()); System.out.println("Total Results: " + results.getTotalResults());


https://www.googleapis.com/analytics/v3/metadata/ga/columns?access_token=https://developers.google.com/api-client-library/java/

System.out.println(); } private static void printAttributes(List attributeNames) { System.out.println("## Attribute Names ##"); for (String attribute : attributeNames) { System.out.println(attribute); } } private static void printColumns(List columns) { System.out.println("## Columns ##"); for (Column column : columns) { System.out.println(); System.out.println("Column ID: " + column.getId()); System.out.println("Kind: " + column.getKind()); Map columnAttributes = column.getAttributes(); for (Map.Entry attribute: columnAttributes.entrySet()) { System.out.println(attribute.getKey() + ": " + attribute.getValue()); } } }

Remarque: première version copiée de Metadata.list

Exemple PHP

Utilise la bibliothèque client PHP

/** * 1. Execute a Metadata Request * An application can request columns data by calling the list method on the Analytics service object. * The method requires an reportType parameter that specifies the column data to retrieve. * For example, the following code requests columns for the ga report type. */ try { $results = $analytics->metadata_columns->listMetadataColumns('ga'); // Success } catch (apiServiceException $e) { // Handle API service exceptions. $error = $e->getMessage(); } /** * 2. Print out the Columns data * The components of the result can be printed out as follows: */ function printMetadataReport($results) {


https://developers.google.com/analytics/devguides/reporting/metadata/v3/reference/metadata/columns/listhttps://github.com/google/google-api-php-client

print 'Metadata Report'; printReportInfo($results); printAttributes($results); printColumns($results); } function printReportInfo(&$results) { $html = 'Report Info'; $html .= getTotalResults()} HTML; print $html; } function printAttributes(&$results) { $html = 'Attribute Names'; $attributes = $results->getAttributeNames(); foreach ($attributes as $attribute) { $html .= ''. $attribute . ''; } $html .= ''; print $html; } function printColumns(&$results) { $columns = $results->getItems(); if (count($columns) > 0) { $html = 'Columns'; foreach ($columns as $column) { $html .= '' . $column->getId() . ''; $column_attributes = $column->getAttributes(); foreach ($column_attributes as $name=>$value) { $html .=

# An application can request columns data by calling the list method on the Analytics service object. # The method requires an reportType parameter that specifies the column data to retrieve. # For example, the following code requests columns for the ga report type. try: results = service.metadata().columns().list(reportType='ga').execute() except TypeError, error: # Handle errors in constructing a query. print ('There was an error in constructing your query : %s' % error) except HttpError, error: # Handle API errors. print ('Arg, there was an API error : %s : %s' % (error.resp.status, error._get_reason())) # 2. Print out the Columns data # The components of the result can be printed out as follows: def print_metadata_report(results): print 'Metadata Response Report' print_report_info(results) print_attributes(results.get('attributeNames')) print_columns(results) def print_report_info(columns): print "Metadata Report Info" if columns: print 'Kind = %s' % columns.get('kind') print 'Etag = %s' % columns.get('etag') print 'Total Results = %s' % columns.get('totalResults') def print_attributes(attributes): if attributes: print 'Attribute Names:' for attribute in attributes: print attribute def print_columns(columns_data): if columns_data: print 'Columns:' columns = columns_data.get('items', []) for column in columns: print print '%15s = %35s' % ('Column ID', column.get('id')) print '%15s = %35s' % ('Kind', column.get('kind')) column_attributes = column.get('attributes', []) for name, value in column_attributes.iteritems(): print '%15s = %35s' % (name, value)

Remarque: version originale copiée à partir de metadata.list

C # exemple


https://developers.google.com/analytics/devguides/reporting/metadata/v3/reference/metadata/columns/list

Utilise la bibliothèque du client .Net

PM> Package d'installation Google.Apis.Analytics.v3

var metadataService = new AnalyticsMetaDataService(new BaseClientService.Initializer() { ApiKey = {Public API KEY}, ApplicationName = "Metadata api", }); var result = Service.Metadata.Columns.List("ga").Execute();

Lire Métadonnées api en ligne: https://riptutorial.com/fr/google-analytics-api/topic/7297/metadonnees-api


https://github.com/google/google-api-dotnet-clienthttps://riptutorial.com/fr/google-analytics-api/topic/7297/metadonnees-apihttps://riptutorial.com/fr/google-analytics-api/topic/7297/metadonnees-api

Chapitre 6: Réponses d'erreur

Syntaxe

400 invalidParameter Indique qu'un paramètre de demande a une valeur non valide.•

400 badRequest Indique que la requête n'était pas valide. Par exemple, l'ID parent était manquant ou la combinaison des dimensions ou des mesures demandées n'était pas valide.

•

403 manquerPermissions Indique que l'utilisateur ne dispose pas des autorisations suffisantes pour l'entité spécifiée dans la requête.

•

403 dailyLimitExceeded Indique que l'utilisateur a dépassé le quota quotidien (par projet ou par vue (profil)).

•

403 usageLimits.userRateLimitExceededUnreg Indique que l'application doit être enregistrée dans Google API Console.

•

403 userRateLimitExceeded Indique que la limite de débit utilisateur a été dépassée. La limite de débit maximale est de 10 qps par adresse IP.

•

403 rateLimitExceeded Indique que les limites de taux globales ou globales du projet ont été dépassées. Réessayez en utilisant une sauvegarde exponentielle. Vous devez ralentir le rythme auquel vous envoyez les demandes.

•

403 quotaExceeded Indique que les 10 demandes simultanées par vue (profil) dans l'API Core Reporting ont été atteintes.

•

429 RESOURCE_EXHAUSTED AnalyticsDefaultGroupCLIENT_PROJECT-1d Indique que le quota de demandes par jour et par projet a été épuisé.

•

429 RESOURCE_EXHAUSTED AnalyticsDefaultGroupCLIENT_PROJECT-100s Indique que le quota de demandes par 100 secondes par projet a été épuisé.

•

429 RESOURCE_EXHAUSTED AnalyticsDefaultGroupUSER-100s Indique que les demandes par 100 secondes par utilisateur et par quota de projet ont été épuisées.

•

429 RESOURCE_EXHAUSTED DiscoveryGroupCLIENT_PROJECT-100s Indique que les demandes de découverte par quota de 100 secondes ont été épuisées.

•

500 internalServerError Une erreur de serveur interne inattendue s'est produite. Ne réessayez pas cette requête plus d'une fois.

•

503 backendError Server a renvoyé une erreur. Ne réessayez pas cette requête plus d'une fois.

•

Paramètres


prénom La description

domaine Emplacement de l'erreur ex: global

raison Raison de l'erreur

message Un message expliquant l'erreur et une solution possible.

Type de lieu Le type d'emplacement de l'erreur ex: paramater

emplacement L'emplacement réel de l'erreur

Remarques

Si une demande aboutit, l'API renvoie un code d'état 200 HTTP avec les données demandées dans le corps de la réponse.

Si une erreur se produit avec une demande, l'API renvoie un code d'état HTTP et une raison dans la réponse en fonction du type d'erreur. De plus, le corps de la réponse contient une description détaillée de la cause de l'erreur.

Examples

400 Paramètre invalide

Il est important de lire la réponse d'erreur renvoyée par le serveur d'API Google Analytics. Dans beaucoup de cas, ils peuvent vous dire exactement ce qui ne va pas.

400 invalidParameter { "error": { "errors": [ { "domain": "global", "reason": "invalidParameter", "message": "Invalid value '-1' for max-results. Value must be within the range: [1, 1000]", "locationType": "parameter", "location": "max-results" } ], "code": 400, "message": "Invalid value '-1' for max-results. Value must be within the range: [1, 1000]" } }

Dans ce cas le message:

"message": "Valeur invalide '-1' pour max-results. La valeur doit être dans la plage: [1, 1000]",


Nous dit que nous avons envoyé une valeur -1 pour le paramètre max-results qui n'est pas valide, nous pouvons seulement envoyer une valeur de 1-1000.

Lire Réponses d'erreur en ligne: https://riptutorial.com/fr/google-analytics-api/topic/7376/reponses-d-erreur


https://riptutorial.com/fr/google-analytics-api/topic/7376/reponses-d-erreurhttps://riptutorial.com/fr/google-analytics-api/topic/7376/reponses-d-erreur

Crédits

S. No

Chapitres Contributeurs

1Démarrer avec google-analytics-api

Community, DaImTo, K48, MarkeD

2API de reporting (Analytics v4)

DaImTo

3 API temps réel DaImTo

4 Authentification DaImTo, Matt

5 Métadonnées api DaImTo

6 Réponses d'erreur DaImTo


https://riptutorial.com/fr/contributor/-1/communityhttps://riptutorial.com/fr/contributor/1841839/daimtohttps://riptutorial.com/fr/contributor/6269864/k48https://riptutorial.com/fr/contributor/3878063/markedhttps://riptutorial.com/fr/contributor/1841839/daimtohttps://riptutorial.com/fr/contributor/1841839/daimtohttps://riptutorial.com/fr/contributor/1841839/daimtohttps://riptutorial.com/fr/contributor/3791516/matthttps://riptutorial.com/fr/contributor/1841839/daimtohttps://riptutorial.com/fr/contributor/1841839/daimto

À proposChapitre 1: Démarrer avec google-analytics-apiRemarquesVersionsExamplesAccès aux API Google AnalyticsintroductionHello World Reporting API - Reste

Chapitre 2: API de reporting (Analytics v4)RemarquesExamplesExemple de rapport unique utilisant Oauth2 C #Exemple de rapport unique Reste

Chapitre 3: API temps réelSyntaxeParamètresRemarquesExamplesExemple PHP

Chapitre 4: AuthentificationSyntaxeParamètresRemarquesExamplesOauth2 C #Authentification du compte de service Vb.net

Chapitre 5: Métadonnées apiSyntaxeParamètresRemarquesExamplesExemple de reposExemple JavaExemple PHPExemple PythonC # exemple

Chapitre 6: Réponses d'erreurSyntaxeParamètresRemarquesExamples400 Paramètre invalide

Crédits

Documents

google-analytics-api · Google Analytics V3, qui inclut l'API Core Reporting, l'API de gestion, l'API MetaData et un certain nombre d'autres API. Ces API renvoient Json Google Analytics