Comment connecter Google Analytics à Google Sheets - Interroger Web Analytics avec SQL

Connexion · GA4 à Google Sheets

Récupérer des données à partir de GA4 dans Google Sheets

Importez en temps réel les données de votre compte GA4 dans Google Sheets et actualisez-les à votre guise. Aucun fichier CSV, aucun script Apps Script, aucun copier-coller. Une dizaine de minutes suffisent la première fois, et le forfait gratuit couvre tout.

Environ 10 minutes Aucun codage nécessaire Vos identifiants vous suivent. N'importe quel navigateur, n'importe quel appareil

Ce que vous obtiendrez

Une feuille Google Sheets affichant les résultats en direct d'une requête SQL sur votre compte GA4, avec un bouton permettant d'afficher les dernières lignes dès que les données changent. Par exemple :

Ventes Enregistré sur Drive

DéposerModifierVoirInsérerFormatDonnéesOutilsExtensionsAide

	A	B	C	D	E
1	numéro de client	prénom	nom de famille	pays	total
2	1042	Marie	Alvarez	USA	1,284.50
3	1043	Daniel	Okafor	USA	612.00
4	1047	Priya	Nair	USA	2,090.75
5	1051	Thomas	Berg	USA	338.20
6	1056	Lucía	Ferreira	USA	1,455.00
7	1060	Kenji	Sato	USA	874.10
8

+ clients Feuille1 En direct de GA4

Google Analytics 4 stocke vos données via son API. Pour les importer dans Google Sheets, il faut généralement exporter un fichier CSV depuis le tableau de bord GA4 à chaque fois que vous avez besoin de données actualisées. Query Streams simplifie cette étape : un petit programme auxiliaire, appelé Agent, exécute la requête à l'emplacement de vos données, et une extension Google Sheets lui demande les lignes souhaitées. Seuls les résultats sont transférés, via une connexion chiffrée, et Google Sheets est accessible partout : depuis n'importe quel navigateur et sur n'importe quel appareil.

Ce dont vous aurez besoin

Un compte Query Streams

Le forfait gratuit suffit pour ce guide. Inscrivez-vous sur mon.querystreams.com.

L'agent sur n'importe quel ordinateur toujours allumé

Un petit programme qui s'exécute en arrière-plan et appelle GA4 lorsque Google Sheets le demande. Il nécessite simplement une connexion internet.

Votre identifiant GA4

Vous vous connecterez à GA4 une seule fois et autoriserez l'accès en lecture. Aucun mot de passe n'est saisi dans les flux de requêtes.

Connectez-le en cinq étapes

1. Créez votre compte

   Aller à mon.querystreams.com et inscrivez-vous. Choisissez le Gratuit Ce forfait est définitif, il ne s'agit pas d'une version d'essai, et il comprend la connexion de votre compte GA4 et l'exécution de requêtes depuis Google Sheets.

2. Installez l'agent sur n'importe quel ordinateur toujours allumé.

   Connectez-vous, ouvrez TéléchargerInstallez ensuite l'agent sur n'importe quel ordinateur ou serveur toujours allumé et disposant d'un accès Internet. L'installation ne prend qu'une minute et l'agent s'exécute ensuite automatiquement.

   Pourquoi un petit programme plutôt qu'un pilote ? L'Agent est une installation unique pour Windows, Mac ou Linux (environ 85 Mo sous Windows, un peu plus de 100 Mo sous Mac et Linux) qui fonctionne discrètement en arrière-plan. Il établit une connexion sortante chiffrée avec Query Streams, comme le ferait un navigateur ; vous n'avez donc pas besoin d'ouvrir de port dans votre pare-feu ni de configurer de VPN. Vos clés restent sur votre machine et les données sont transmises où que vous soyez, via Internet si nécessaire. Le seul élément requis de votre côté est l'extension.

   La page de téléchargement affiche Votre clé d'accèsCollez-le dans l'Agent lorsqu'il vous le demande, et attendez que le badge affiche Connecté aux flux de requêtesC'est la seule chose que vous devez faire sur l'Agent lui-même.

   Des guides complets sont disponibles si vous le souhaitez : Fenêtres, Mac, Linux.

3. Indiquez-lui votre compte GA4

   De retour dans votre navigateur, ouvrez Agents de données (sous Données (dans le menu du haut). Votre agent y est répertorié. Cliquez Ajouter un connecteur et choisissez Google Analytics 4Vous devez d'abord vous munir de vos identifiants GA4 ? Ouvrez le guide, puis remplissez les champs :

   Créez vos identifiants GA4 (environ 15 minutes)

   Ouvrez ensuite Google Analytics 4 dans un autre onglet. Query Streams conserve les données que vous créez ici afin que votre agent puisse les utiliser, et ne lit que les données de Google Analytics 4.

   Qui peut faire ça ?

   Google Analytics : Administrateur de la propriété GA4 ou de son compte (nécessaire pour ajouter le compte de service). Google Cloud : Propriétaire du projet (vous êtes propriétaire de tout projet que vous créez) ou administrateur des rôles « Créer des comptes de service », « Administrateur de la clé du compte de service » et « Administrateur de l’utilisation du service » sur ce projet.

   Recommandé

   Clé JSON du compte de service Google Cloud (un fichier .json de type service_account), avec le compte de service ajouté en tant que visionneur sur la propriété GA4

   Avant de commencer

   • Une propriété GA4. Son ID de propriété est un simple numéro. Un ID de suivi UA- indique une ancienne propriété Universal Analytics, que l'API de Google ne peut pas lire.
   • Un compte Google disposant du rôle d'administrateur sur cette propriété GA4 est nécessaire. Si vous n'en possédez pas, vous pouvez effectuer la partie relative à Google Cloud (étapes 1 à 13) et demander à un administrateur d'effectuer les étapes 14 à 19.
   • Vous devez disposer d'un projet Google Cloud à gérer ou de l'autorisation d'en créer un. Si l'organisation Google Cloud de votre entreprise a été créée le 3 mai 2024 ou après cette date, Google bloque par défaut les téléchargements de clés et votre administrateur Google Cloud devra peut-être les autoriser (voir Problèmes courants).
   • L'assistant Query Streams s'ouvre dans un autre onglet (Agents de données → Ajouter un connecteur → Google Analytics 4) avec votre agent en ligne.

   Mesures

   1. Ouvrez la page Nouveau projet dans Google Cloud

      Connectez-vous avec votre compte Google et ouvrez la page Nouveau projet Google Cloud.

      Vous avez déjà un projet Google Cloud que vous souhaitez utiliser ? Passez à l'étape 3 et sélectionnez-le. Lors de votre première connexion à Google Cloud, il se peut que Google vous demande votre pays et que vous acceptiez ses conditions d'utilisation avant d'afficher la page.

   2. Nommez et créez le projet

      Dans le champ Nom du projet, saisissez un nom tel que Query Streams GA4. Laissez le champ Organisation ou Emplacement tel quel (aucune organisation n'est requise). Cliquez sur Créer.

      Google n'a pas besoin de compte de facturation pour créer le projet. Sa création prend de quelques secondes à une minute.

   3. Sélectionnez le projet

      Cliquez sur le sélecteur de projet en haut de la page, à côté du logo Google Cloud, puis cliquez sur le nom de votre projet. Toutes les étapes Google Cloud décrites ci-dessous se déroulent dans ce projet.

      L'erreur la plus fréquente consiste à activer l'API dans un projet et à créer la clé dans un autre. Vérifiez le nom du projet en haut de la page avant chaque étape Google Cloud.

   4. Activez l'API de données Google Analytics

      Ouvrez la page de l'API Google Analytics Data dans la bibliothèque d'API. Vérifiez que le nom de votre projet apparaît en haut, puis cliquez sur Activer.

      Choisissez l'API Google Analytics Data, et non l'API Google Analytics Reporting, qui ne fonctionne qu'avec les anciennes propriétés Universal Analytics. Si le bouton affiche « Gérer » au lieu d'« Activer », l'API est déjà activée. Cette API fournit également le rapport en temps réel de GA4 ; aucune activation supplémentaire n'est donc nécessaire pour la table realtime_active_users.

   5. Activez l'API d'administration de Google Analytics (recommandé)

      Ouvrez la page d'administration de l'API Google Analytics dans la bibliothèque d'API et cliquez sur Activer.

      La synchronisation ne nécessite pas cette API. Elle alimente le bouton « Détecter » situé à côté de l’ID de propriété GA4 dans l’assistant « Flux de requêtes », qui affiche la liste des propriétés accessibles au compte de service. Ignorez cette étape si vous saisissez vous-même l’ID de propriété.

   6. Créer un compte de service

      Ouvrez la page Comptes de service. Dans Google Cloud, vous pouvez également ouvrir le menu de navigation (trois lignes, en haut à gauche) et sélectionner IAM et administration → Comptes de service. Cliquez sur + Créer un compte de service.

      Vous avez déjà créé un compte de service pour le connecteur Google Search Console de Query Streams ? Vous pouvez également l'utiliser ici : suivez les étapes 4 et 5 de son projet, puis passez à l'étape 14 avec son adresse e-mail et sa clé.

   7. Nom du compte de service

      Dans le champ Nom du compte de service, saisissez query-streams-ga4. Google renseigne automatiquement l'ID du compte de service. La description est facultative. Cliquez sur Créer et continuer.

      Cet identifiant ne peut pas être modifié ultérieurement. Il devient la première partie de l'adresse électronique du compte de service.

   8. Ignorez les rôles du projet

      La section suivante propose les rôles au sein du projet. Laissez le champ « Rôle » vide et cliquez sur « Continuer ».

      N'attribuez pas ici les rôles de propriétaire, d'éditeur ou de lecteur au compte de service. Son accès à Google Analytics est accordé dans Google Analytics à l'étape 18. Un rôle de projet est inutile dans Google Analytics et sert uniquement à étendre les actions possibles de la clé dans Google Cloud.

   9. Finalisez la création du compte de service

      Laissez la dernière section (personnes autorisées à utiliser ou gérer le compte de service) vide et cliquez sur Terminé. Vous revenez à la liste des comptes de service.

   10. Copiez l'adresse e-mail du compte de service

       Dans la liste, repérez le nouveau compte. Son adresse e-mail ressemble à [email protected]. Copiez-la et conservez-la pour l'étape 17.

       Copiez l'adresse complète, via .iam.gserviceaccount.com. Un nouveau compte de service peut prendre une minute ou plus avant d'être utilisable.

   11. Ouvrez l'onglet Clés

       Cliquez sur l'adresse e-mail du compte de service, puis sur l'onglet Clés.

   12. Démarrer une nouvelle clé

       Cliquez sur Ajouter une clé, puis choisissez Créer une nouvelle clé.

       Si Google indique que la création de clés de compte de service est désactivée, votre organisation bloque le téléchargement des clés. Consultez la section Problèmes courants.

   13. Téléchargez la clé JSON

       Choisissez JSON comme type de clé et cliquez sur Créer. Votre navigateur téléchargera un fichier .json portant le nom de votre projet, généralement dans votre dossier Téléchargements.

       Ce téléchargement est unique : Google n'en conserve aucune copie et vous ne pouvez pas télécharger le fichier à nouveau. Si vous le perdez, créez une nouvelle clé et supprimez l'ancienne. Ne choisissez pas P12. Conservez le fichier privé. Ne l'envoyez pas par e-mail et ne le placez pas dans un dossier partagé, car toute personne en possession de ce fichier peut consulter vos données Analytics. Query Streams le stocke pour votre agent et ne le consulte qu'avec celui-ci.

   14. Ouvrir l'interface d'administration de Google Analytics

       Ouvrez Google Analytics et cliquez sur Administration (l'icône d'engrenage en bas à gauche). En haut de la page, vérifiez que le sélecteur de compte et de propriété affiche bien la propriété GA4 que vous souhaitez analyser.

       Pour ajouter des utilisateurs, vous devez disposer du rôle d'administrateur sur cette propriété ou son compte. Si vous ne le possédez pas, transmettez le courriel de l'étape 10 à une personne qui le possède et demandez-lui de suivre les étapes 15 à 19.

   15. Gestion d'accès aux propriétés ouvertes

       Dans les paramètres de la propriété, dans le groupe Propriété, cliquez sur Gestion des accès à la propriété.

       Utilisez la gestion des accès aux propriétés, et non la gestion des accès aux comptes. Les accès ajoutés au niveau du compte s'appliquent à toutes les propriétés de ce compte.

   16. Ajouter un utilisateur

       Cliquez sur le bouton bleu + en haut à droite et choisissez Ajouter des utilisateurs.

   17. Saisissez l'adresse e-mail du compte de service.

       Collez l'adresse e-mail du compte de service obtenue à l'étape 10 dans le champ prévu à cet effet. Décochez la case « Notifier les nouveaux utilisateurs par e-mail ».

       Personne ne consulte la boîte de réception de cette adresse, il est donc inutile de l'envoyer. Si Google Analytics 4 affiche le message « Cette adresse e-mail ne correspond pas à un compte Google » ou « Échec de l'ajout de l'utilisateur : adresse e-mail introuvable », consultez la section « Problèmes courants ». Google rencontre un problème connu avec les nouveaux comptes de service depuis avril 2026 ; patienter quelques heures a généralement résolu le problème.

   18. Choisissez le rôle de spectateur

       Dans la liste des rôles, sélectionnez « Lecteur ». Laissez les options « Aucun indicateur de coût » et « Aucun indicateur de revenu » décochées.

       L'option « Visionneuse » suffit, car Query Streams ne fait que lire les rapports. Si l'option « Aucune métrique de revenu » est cochée, Google renvoie 0 dans toutes les colonnes de revenus des tables ecommerce_overview et transactions.

   19. Ajouter le compte de service

       Cliquez sur Ajouter en haut à droite. Le compte de service apparaît désormais dans la liste des utilisateurs de la propriété avec le rôle de Visionneur.

       Certains écrans affichent ce bouton sous le nom « Créer ».

   20. Copiez l'identifiant de la propriété

       Retournez à l'interface d'administration. Dans les paramètres de la propriété, groupe Propriété, cliquez sur Détails de la propriété. En haut à droite, l'identifiant de la propriété s'affiche (par exemple : 486480978). Cliquez sur l'icône de copie à côté.

       Utilisez ce numéro, et non l'identifiant de mesure (qui commence par G-) ni l'identifiant de compte. Ce même numéro apparaît dans la barre d'adresse GA4 après la lettre p, par exemple : …/p486480978/….

   21. Copiez l'intégralité du fichier clé

       Ouvrez le fichier .json de l'étape 13 dans un éditeur de texte brut. Sous Windows, cliquez avec le bouton droit sur le fichier et choisissez Ouvrir avec → Bloc-notes. Sous macOS, cliquez dessus en maintenant la touche Contrôle enfoncée et choisissez Ouvrir avec → TextEdit. Appuyez ensuite sur Ctrl+A, puis Ctrl+C (Cmd+A, puis Cmd+C sous macOS).

       Copiez tout le texte entre les premières accolades { et }. Ne le recopiez pas et ne le modifiez pas. La ligne « private_key » doit rester exactement telle qu'elle a été écrite par Google.

   Autorisations à accorder

   Ressource	Accès	Utilisé pour
   Rôle de propriété dans Google Analytics : Visionneuse (Gestion des accès à la propriété)	Visionneur	Chaque table ga4 : traffic_overview, traffic_sources, geographic_data, page_views, user_engagement, events, ecommerce_overview, transactions et realtime_active_users. La connexion de test lit également la liste des champs de la propriété.
   Restriction des données : aucune donnée sur les revenus	Décoché	Les colonnes de revenus dans ecommerce_overview (purchase_revenue, total_revenue, average_purchase_revenue) et transactions (item_revenue) affichent la valeur 0 lorsqu'elles sont cochées.
   Restriction des données : aucune mesure de coût	Décochée (recommandé)	Aucune table Query Streams ne lit actuellement les métriques de coût ; cette option est donc sans conséquence aujourd’hui. La laisser décochée permet de conserver la lisibilité de toutes les données de coût.
   API Google Cloud : API de données Google Analytics	Activé	Chaque table ga4 et connexion de test. Le rapport en temps réel associé à realtime_active_users fait partie de la même API.
   API Google Cloud : API d'administration de Google Analytics	Activé (facultatif)	Seul le bouton Détecter situé à côté de l'ID de propriété GA4 affiche la liste des propriétés accessibles au compte de service. Aucune table ne permet de le lire.
   rôle du projet Google Cloud pour le compte de service	Aucun	Non requis pour aucun tableau. L'accès à Google Analytics est uniquement fourni par le rôle « Lecteur » mentionné ci-dessus.
   Portée OAuth : https://www.googleapis.com/auth/analytics.readonly	Demandé par l'agent (vous n'avez rien à paramétrer)	Chaque table ga4, Test de connexion et Détection. Il s'agit du périmètre Analytics en lecture seule de Google ; la clé ne peut donc rien modifier dans Google Analytics.

   Coller dans les flux de requêtes

   Clé JSON du compte de service

   Copiez l'intégralité du fichier .json à l'étape 21, de la première accolade ouvrante { à la dernière accolade fermante }. Lors de la modification ultérieure d'un connecteur, laissez ce champ vide pour conserver la clé enregistrée ou collez un nouveau fichier pour la remplacer.

   GA4 Identifiant de propriété

   Le numéro que vous avez copié à l'étape 20, uniquement les chiffres (par exemple : 486480978). Vous pouvez également cliquer sur « Détecter » à côté de la case et sélectionner votre propriété dans la liste. La détection nécessite l'API d'administration de l'étape 5 et un agent connecté.

   Problèmes courants

   La connexion de test a échoué en raison d'un type de clé invalide. Type attendu : « service_account ».

   Pourquoi: Le fichier collé n'est pas une clé de compte de service. Il s'agit généralement d'un fichier client OAuth (nommé par exemple client_secret_….json) ou d'une clé API disponible dans API et services → Identifiants.

   Réparer: Créez une clé JSON sur le compte de service (étapes 11 à 13) et collez ce fichier. Une clé de compte de service contient la ligne « type » : « service_account ».

   Le test de connexion échoue en raison d'un format JSON invalide ou d'un champ « private_key » manquant ou vide.

   Pourquoi: Seule une partie du fichier a été copiée, ou le texte a été modifié pendant la copie.

   Réparer: Ouvrez à nouveau le fichier dans le Bloc-notes ou TextEdit, appuyez sur Ctrl+A (Cmd+A sur un Mac), copiez-le et collez-le dans la clé JSON du compte de service sans rien avant ni après.

   La connexion de test échoue avec le message « Interdit » – L’utilisateur ne dispose pas des autorisations suffisantes pour cette propriété.

   Pourquoi: Le compte de service n'a pas été ajouté à cette propriété, a été ajouté à une autre propriété ou l'identifiant de la propriété appartient à une autre propriété. Ce problème survient également pendant quelques minutes après l'ajout du compte de service.

   Réparer: Ouvrez la propriété dont les détails affichent le même identifiant et vérifiez que l'adresse e-mail du compte de service figure bien dans la gestion des accès à la propriété avec Viewer (étapes 14 à 19). Patientez 5 à 10 minutes, puis cliquez à nouveau sur Tester.

   La connexion de test échoue avec un message d'erreur indiquant que l'API Google Analytics Data n'a pas été utilisée dans le projet… auparavant ou qu'elle est désactivée.

   Pourquoi: L'API Data n'est pas activée dans le projet Google Cloud auquel appartient la clé. Le nom du projet figure sur la ligne `project_id` du fichier de clé.

   Réparer: Sélectionnez ce projet dans Google Cloud, activez l'API Google Analytics Data (étape 4), patientez quelques minutes, puis cliquez à nouveau sur Tester.

   Le test de connexion échoue avec le message d'erreur suivant : « Format d'ID de propriété non valide : 'G-…'. Doit être numérique » ou « Propriété '…' introuvable. »

   Pourquoi: L'identifiant de mesure (G-…), un ancien identifiant de suivi UA ou un numéro mal saisi a été entré à la place de l'identifiant de propriété.

   Réparer: Copiez le numéro affiché sous ID DE PROPRIÉTÉ sur la page des détails de la propriété (étape 20) et collez-le dans ID de propriété GA4.

   Google Analytics n'accepte pas l'adresse e-mail du compte de service : cette adresse e-mail ne correspond pas à un compte Google, ou Échec de l'ajout de l'utilisateur : adresse e-mail introuvable.

   Pourquoi: Un problème connu de Google : depuis fin avril 2026, Google Analytics 4 et Search Console peuvent ne pas reconnaître temporairement les comptes de service nouvellement créés. Des signalements ont continué jusqu'en septembre 2026. Une faute de frappe ou un espace dans l'adresse provoque le même message d'erreur.

   Réparer: Collez à nouveau l'adresse sans espaces. Si elle est toujours refusée, patientez quelques heures et réessayez. Un compte de service créé précédemment fonctionne généralement ; si vous en possédez un, créez une nouvelle clé (étapes 11 à 13) et ajoutez cette adresse e-mail. Un administrateur maîtrisant l'explorateur d'API de Google peut également ajouter le compte de service via la méthode `accessBindings.create` de l'API d'administration et le rôle `predefinedRoles/viewer`.

   Google Cloud indique que la création de clés de compte de service est désactivée lorsque vous cliquez sur « Créer une nouvelle clé ».

   Pourquoi: Votre organisation applique la politique iam.disableServiceAccountKeyCreation. Google l'active par défaut pour les organisations créées à partir du 3 mai 2024.

   Réparer: Demandez à votre administrateur Google Cloud (une personne disposant du rôle d'administrateur de stratégie d'organisation) d'autoriser la création de clés pour ce projet ou compte de service. Google propose une exemption basée sur les balises pour un projet ou un compte de service. Répétez ensuite les étapes 12 et 13.

   Detect indique qu'aucune propriété GA4 n'a été trouvée ou signale que l'API d'administration de Google Analytics n'a pas été utilisée dans le projet.

   Pourquoi: L'API d'administration n'est pas activée (étape 5), ou le compte de service n'a pas encore été ajouté à une propriété.

   Réparer: Activez l'API d'administration et suivez les étapes 14 à 19, puis cliquez à nouveau sur Détecter. Vous pouvez également saisir manuellement l'identifiant de la propriété.

   Les tables ecommerce_overview et transactions sont synchronisées, mais toutes les colonnes de revenus sont à 0.

   Pourquoi: Le compte de service a été ajouté avec la restriction de données « Aucune mesure de revenu ».

   Réparer: Dans la gestion des accès aux propriétés, ouvrez l'entrée du compte de service, décochez « Aucune mesure de revenu » et enregistrez. La prochaine synchronisation affichera les valeurs réelles.

   Un connecteur qui fonctionnait auparavant ne se synchronise plus, avec une erreur mentionnant invalid_grant ou une signature JWT invalide.

   Pourquoi: La clé a été supprimée ou désactivée dans Google Cloud. Google désactive également les clés exposées publiquement.

   Réparer: Créez une nouvelle clé (étapes 11 à 13). Dans Query Streams, ouvrez le connecteur dans Data Agents, cliquez sur Modifier, collez l'intégralité du nouveau fichier dans Clé JSON du compte de service, cliquez sur Tester la connexion, puis sur Enregistrer les modifications. Supprimez l'ancienne clé dans Google Cloud.

   Les synchronisations échouent avec le code 429 ou RESOURCE_EXHAUSTED.

   Pourquoi: Cette propriété a épuisé son quota d'API Google Analytics. Chaque application qui accède à cette propriété via l'API utilise le même quota par propriété.

   Réparer: Veuillez patienter : les quotas horaires sont réapprovisionnés en une heure et les quotas quotidiens sont réinitialisés à minuit, heure du Pacifique. Désactivez les tables que vous n’utilisez pas ou réduisez la fréquence de synchronisation.

   Vous souhaitez que Query Streams cesse de lire cette propriété.

   Pourquoi: La suppression du connecteur ne supprime pas l'accès de Google. Le compte de service reste un utilisateur en mode lecture seule et la clé reste valide.

   Réparer: Dans la gestion des accès aux propriétés, supprimez le compte de service. Dans Google Cloud, ouvrez l'onglet Clés du compte de service et supprimez la clé. Supprimez ensuite le connecteur dans les agents de données.

   Limites à connaître

   • Fraîcheur des données : GA4 peut mettre entre 24 et 48 heures pour terminer le traitement quotidien des données, et les chiffres des jours précédents peuvent évoluer par la suite. Chaque synchronisation des tables quotidiennes relit les données des 3 derniers jours, ce qui permet aux données plus récentes de s’intégrer automatiquement. Les données en temps réel sont disponibles en quelques minutes.
   • Fenêtre temps réel : le rapport en temps réel de GA4 ne couvre que les 30 dernières minutes (60 minutes pour Analytics 360). La table realtime_active_users est un instantané remplacé à chaque actualisation (toutes les 5 minutes par défaut), et non un historique. Elle utilise la même API, la même clé et les mêmes droits d’accès que les autres tables, avec son propre quota temps réel.
   • Quota API pour une propriété standard : 200 000 jetons par jour et 40 000 par heure pour l’ensemble de la propriété, 14 000 par heure pour un projet Google Cloud, et 10 requêtes simultanées. La plupart des requêtes coûtent 10 jetons ou moins. Les propriétés Analytics 360 bénéficient de 10 fois ces limites. Le quota quotidien est réinitialisé à minuit, heure du Pacifique.
   • Historique : la première synchronisation demande toutes les données depuis octobre 2020, date de lancement de GA4. Google ne renvoie que les données à partir du moment où votre propriété a commencé la collecte. Les propriétés Universal Analytics (UA-) ne sont pas accessibles via cette API.
   • Une propriété par connecteur : l’ID de propriété sélectionne une propriété GA4. Pour lire une autre propriété, ajoutez le même compte de service en tant que lecteur et créez un second connecteur. La même clé fonctionne pour les deux.
   • Clés : une clé de compte de service n’expire jamais, sauf si votre organisation définit une durée de vie maximale. Chaque compte de service peut avoir jusqu’à 10 clés, et le fichier de clés ne peut être téléchargé qu’une seule fois.
   • Restrictions relatives aux données : si le compte de service ne comporte aucune métrique de revenus ou aucune métrique de coûts, Google renvoie 0 pour ces métriques au lieu d’une erreur.

   Étapes vérifiées le 8 octobre 2026. Sources : developers.google.com/analytics/devguides/reporting/data/v1, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/config/admin/v1…, developers.google.com/analytics/devguides/config/admin/v1…, developers.google.com/analytics/devguides/config/admin/v1…, développeurs.google.com/workspace/guides/create-project, docs.cloud.google.com/resource-manager/docs/creating-mana…, docs.cloud.google.com/service-usage/docs/enable-disable, docs.cloud.google.com/iam/docs/service-accounts-create, docs.cloud.google.com/iam/docs/keys-create-delete, docs.cloud.google.com/iam/docs/service-account-creds, docs.cloud.google.com/iam/docs/troubleshoot-org-policies, docs.cloud.google.com/iam/docs/best-practices-for-managin…, support.google.com/googleapi/answer/6158841?hl=en, support.google.com/analytics/answer/9305788?hl=en, support.google.com/analytics/answer/9305587?hl=en, support.google.com/analytics/answer/9304776?hl=en, support.google.com/analytics/answer/11198161?hl=en, docs.ovhcloud.com/en/guides/public-cloud/data-platform/co…, windsor.ai/documentation/how-to-connect-ga4-to-windsor-ai…, seopress.org/support/guides/find-my-google-analytics-4-pr…, analytify.io/add-user-to-google-analytics, optimizesmart.com/blog/google-analytics-4-measurement-id-…, discuss.google.dev/t/problem-with-new-service-accounts/36…, piunikaweb.com/2026/05/01/google-service-account-email-no…, sanj.dev/post/google-analytics-search-console-service-acc…, oneuptime.com/blog/post/2026-01-24-gcp-service-account-ke…, help.genesys.cloud/articles/data-action-returns-a-400-error.

   Nom de la connexion

   Un nom que vous reconnaîtrez plus tard, comme base de données des ventes.

   Clé JSON du compte de service

   Collez le contenu du fichier clé d'un compte de service Google ajouté en tant que visionneuse sur votre propriété GA4.

   GA4 Identifiant de propriété

   Le numéro qui identifie votre propriété GA4, que vous trouverez dans l'administration GA4 sous Paramètres de la propriété, par exemple 486480978.

   Cliquez sur Test de connexion.Quand il lit Connecté, cliquez ÉconomiserLa connexion atteint votre agent en quelques secondes.

   Agents de données ouvertes

   Test échoué ? Il s'agit généralement d'une autorisation manquante ou d'identifiants provenant d'un compte GA4 incorrect. La procédure détaillée ci-dessus répertorie les problèmes courants et leurs solutions.

4. See your data in Query Builder Facultatif

   You can look at your GA4 account before Google Sheets is involved at all. Open Générateur de requêtes in the portal and pick the connection you just made. The Schéma tab lists your tables and columns, and clicking one puts its name in the editor, so you can write a query without remembering exact names. Click Exécuter and the rows appear under Résultats. Query Builder is on every plan, Free included.

   On Business plans you can also ask Nova in plain English (“show me customers in the USA”) and it writes the SQL for you. When the query looks right, save it: from Personal Core up it shows in the add-on’s Saved Queries list, and on any plan you can copy the SQL into the next step.

5. Ajouter des flux de requêtes à Google Sheets

   Ouvrez n'importe quelle feuille Google, allez à Extensions → Modules complémentaires → Télécharger des modules complémentaires, Rechercher Flux de requêtes, et cliquez InstallerOu installez-le directement depuis Flux de requêtes sur la place de marché Google WorkspaceGoogle vous demandera d'autoriser l'extension ; c'est normal.

   Ensuite, dans chaque feuille Google que vous ouvrez, vous trouverez une icône Query Streams dans le panneau latéral droit, également répertoriée sous ExtensionsIl n'y a pas de connexion séparée. Le système reconnaît le compte Google que vous utilisez déjà ; l'adresse e-mail doit donc être celle associée à votre compte Query Streams.

6. Installez votre première table

   Cliquez sur l'icône Flux de requêtes dans le panneau latéral à droite de la feuille (ou trouvez-la sous Extensions). Choisir Flux de requêtes et sélectionnez la connexion que vous venez d'établir.

   Saisissez la requête que vous souhaitez exécuter. Celle-ci extrait quelques colonnes d'une base de données. ga4.aperçu_du_trafic tableau:

   Exemple · SQL

   SELECT date, sessions, total_users, screen_page_views FROM ga4.traffic_overview ORDER BY date DESC LIMIT 100;

   Sous Fiche de destination Sélectionnez l'onglet dans lequel les lignes doivent apparaître, puis cliquez. Exécuter une requêteLes lignes s'affichent dans cet onglet en une ou deux secondes. Cliquez à nouveau sur « Exécuter la requête » dès que les données changent ; l'onglet se met alors à jour.

   Vous ne connaissez pas SQL ? Build it in Générateur de requêtes first and paste it here, or pick it from Saved Queries if you saved it.

Bonnes prochaines étapes

• Enregistrer la requête dans le portail, vous pouvez donc le relancer en un seul clic, depuis Google Sheets ou Excel.
• Ajouter un filtre par exemple, une plage de dates, afin que la même requête puisse répondre « ce mois-ci » sans modification.
• Partagez les résultats avec un collègue. Il voit les rangs, pas vos qualifications.

Questions que se posent les gens

Guides associés

• Google Analytics 4 vers Microsoft Excel
• Stripe vers Google Sheets
• HubSpot vers Google Sheets
• Shopify vers Google Sheets
• Power Query pour Google Sheets
• Tous les guides