Connecteurs Google Workspace

Choisissez un connecteur et connectez-le via un compte partagé ou via le compte de chaque personne. Les scopes sont les permissions que votre application demande à Google. Demandez uniquement ceux dont elle a besoin.

Vous avez besoin d’un plan Builder ou supérieur pour utiliser les connecteurs dans votre application.

Ce que vous pouvez faire

Connectez votre application à vos e-mails, agendas, contacts et fichiers.

Automatiser les e-mails

Envoyez des confirmations et des relances. Transformez les e-mails entrants en tâches ou en tickets.

Synchroniser agendas et contacts

Synchronisez les réservations, affichez vos disponibilités et gardez vos contacts à jour.

Travailler avec des fichiers et des données

Enregistrez des rapports dans Drive, générez des Docs, et importez ou exportez des données Sheets.

Connecteur Google Workspace

Utilisez ce connecteur quand votre application combine plusieurs services Google. Par exemple, un assistant qui travaille avec votre boîte de réception, votre agenda et vos fichiers Drive. Si elle n’en utilise qu’un ou deux, connectez plutôt ceux-là. Exemples de prompts Dans le chat IA, décrivez les services Google concernés, ce qui déclenche l’action et les éventuels champs dynamiques. Par exemple :

Apprends à me connaître : parcours mes e-mails, réunions et fichiers Drive, et dis-moi sur quoi je travaille.

Sois mon assistant personnel : surveille ma boîte de réception et mon agenda, et dis-moi ce qui requiert mon attention aujourd'hui.

Prépare ma prochaine réunion à partir des fils d'e-mails, des fichiers et des informations des participants.

Rédige des relances pour les participants après chaque réunion.

Transforme les réunions et e-mails de cette semaine en un Doc et une Sheet.

Scopes

Ce connecteur demande les scopes ci-dessous sur 6 services. Il nécessite donc plus d’accès qu’un connecteur individuel.

Gmail : gmail.readonly, gmail.modify, gmail.compose, gmail.send
Calendar : calendar.readonly, calendar.settings.readonly, calendar.events
Contacts : contacts.readonly
Drive : drive.readonly, drive
Docs : documents.readonly, documents
Sheets : spreadsheets.readonly, spreadsheets

Chaque scope est décrit sous son service dans Services Google.

Accès : votre application travaille avec les données du compte Google qui autorise la connexion.

Connecter un service Google

Connectez un service Google via un compte partagé, ou laissez chaque personne connecter le sien.

Connecteur partagé
Connecteur utilisateur de l'application

Vous connectez un compte une seule fois. Toutes les personnes qui utilisent votre application partagent cette connexion et ses données.Pour ajouter un connecteur Google partagé :

Cliquez sur Connectors dans la barre latérale de votre espace de travail.
Cliquez sur Add connector.
Recherchez le service souhaité, comme Google Calendar ou Google Workspace, puis cliquez dessus.
Sélectionnez Shared connector, puis cliquez sur Next.
Saisissez un Connection name.
Choisissez où la connexion peut être utilisée dans Who can access. La valeur par défaut est Apps and Super agent.
Si Permissions apparaît, choisissez Read-only pour consulter les données. Choisissez Read & write si votre application doit envoyer, créer ou modifier des données. La valeur par défaut est Read-only.
Cliquez sur Add connector, puis connectez-vous avec le compte Google à partager.
Ouvrez votre application dans l’éditeur d’application.
Demandez au chat IA d’utiliser la connexion Google partagée pour la fonctionnalité à créer.

Chaque personne connecte son propre compte Google. Votre application travaille ainsi avec ses données. Google Calendar propose aussi Let Base44 manage OAuth.

Avant de commencer : les propriétaires et administrateurs de l’espace de travail configurent les connecteurs utilisateur de l’application. Pour utiliser Let Base44 manage OAuth, vous avez besoin d’un plan Pro ou supérieur. Si vous utilisez votre propre client OAuth, consultez Scopes et permissions avant de créer.

Si vous utilisez Let Base44 manage OAuth pour Google Calendar, passez directement à Pour ajouter un connecteur Google utilisateur de l’application.Pour préparer votre propre client OAuth :

Créez ou sélectionnez un projet dans la console Google Cloud.
Activez l’API de chaque service Google utilisé par votre application.
Configurez l’écran de consentement OAuth avec les scopes que vous prévoyez de demander.
Tant que votre application OAuth est en mode test, ajoutez comme utilisateurs test les comptes Google qui servent aux tests.
Créez un client OAuth pour une application web.
Ajoutez https://connectors.base44.com/api/oauth/callback comme URI de redirection autorisé.
Copiez l’ID client et le secret client.

Pour ajouter un connecteur Google utilisateur de l’application :

Cliquez sur Connectors dans la barre latérale de votre espace de travail.
Cliquez sur Add connector.
Recherchez le service souhaité, comme Google Calendar ou Google Drive, puis cliquez dessus.
Sélectionnez App user connector, puis cliquez sur Next.
Si Choose how to manage authentication apparaît, sélectionnez Let Base44 manage OAuth ou Use your own OAuth client.
Saisissez un Connector name.
Si vous utilisez votre propre client OAuth, saisissez son Client ID et son Client Secret.
Sous Scopes, décochez les scopes dont votre application n’a pas besoin. Avec votre propre client OAuth, ajoutez-en d’autres sous Additional scopes. Pour savoir à quoi sert chaque scope, consultez Services Google.
Cliquez sur Add Connector.
Ouvrez votre application dans l’éditeur d’application.
Demandez au chat IA d’ajouter un moyen pour chaque personne de connecter son propre compte Google.

Services Google

Trouvez le service utilisé par votre application pour voir ce qu’il permet et les scopes qu’il demande. Pour d’autres connecteurs Google, comme Google Analytics, Google Meet et Google Search Console, consultez le catalogue des connecteurs.

Gmail

Envoyez, lisez et gérez des e-mails dans Gmail. Exemples de prompts Dans le chat IA, décrivez l’objet, le corps du message, la mise en forme, les destinataires et les éventuels champs dynamiques. Par exemple :

Envoie des e-mails de confirmation automatiques quand une nouvelle commande est passée.

Lis et analyse les e-mails entrants pour créer des tickets de support.

Déclenche automatiquement un workflow à l'arrivée d'un nouvel e-mail.

Envoie des e-mails de relance personnalisés aux nouveaux prospects.

Préviens les membres de l'équipe par e-mail quand des tâches leur sont attribuées.

Scopes

La lecture du contenu des e-mails est un scope Google restreint.

Les noms des scopes Gmail commencent par https://www.googleapis.com/auth/ :

gmail.readonly : lire les messages et leurs métadonnées
gmail.modify : lire, libeller et modifier les messages, sans les supprimer définitivement
gmail.compose : créer des brouillons et envoyer des e-mails
gmail.send : envoyer des messages
gmail.labels : gérer les libellés
gmail.settings.basic : gérer les filtres, les signatures et le répondeur automatique

Accès : votre application travaille avec les e-mails du compte Gmail qui autorise la connexion.

Google Calendar

Consultez et gérez les événements Google Calendar. Exemples de prompts Dans le chat IA, décrivez l’agenda, les événements, ce qui déclenche l’action et les éventuels champs dynamiques. Par exemple :

Synchronise toutes mes réservations directement dans mon Google Calendar.

Montre aux clients mes disponibilités en temps réel depuis Google Calendar.

Lance une automatisation quand un événement d'agenda est créé ou mis à jour.

Bloque automatiquement les créneaux de réunion dans mon agenda personnel.

Ajoute de nouveaux événements d'agenda quand une tâche est marquée comme terminée.

Scopes

Le scope large calendar gère tous les agendas. Choisissez un scope plus restreint si votre application lit seulement les événements ou les disponibilités. Avec Let Base44 manage OAuth, le sélecteur ne propose que les scopes plus restreints.

Les noms des scopes Google Calendar commencent par https://www.googleapis.com/auth/ :

calendar : gérer tous les agendas et événements
calendar.readonly : voir tous les agendas, événements et leurs paramètres
calendar.events : gérer les événements des agendas
calendar.events.readonly : voir les événements des agendas
calendar.events.freebusy : voir les informations de disponibilité des agendas sans voir le détail des événements
calendar.freebusy : voir les informations de disponibilité des agendas
calendar.app.created : gérer les agendas créés par votre application
calendar.calendarlist.readonly : voir la liste des agendas
calendar.events.public.readonly : voir les événements publics des agendas
calendar.settings.readonly : voir les paramètres de Google Calendar

Accès : votre application travaille avec les agendas du compte Google qui autorise la connexion.

Google Contacts

Lisez, créez et gérez des contacts dans Google Contacts. Exemples de prompts Dans le chat IA, décrivez les contacts, ce qui déclenche l’action et les éventuels champs dynamiques. Par exemple :

Crée un CRM qui synchronise les clients dans les deux sens avec mes Google Contacts.

Importe comme prospects les personnes à qui j'ai écrit mais que je n'ai jamais enregistrées comme contacts.

Analyse mon réseau de contacts et classe automatiquement les contacts avec l'IA.

Crée un annuaire d'entreprise consultable à partir de mon organisation Google Workspace.

Enregistre automatiquement les nouveaux clients comme contacts lors de leur inscription.

Scopes

Choisissez contacts.readonly si votre application doit seulement lire les contacts enregistrés.

Les noms des scopes Google Contacts commencent par https://www.googleapis.com/auth/ :

contacts.readonly : voir les contacts
contacts : voir, créer, modifier et supprimer des contacts
contacts.other.readonly : voir les autres contacts, comme les personnes à qui vous avez écrit sans les enregistrer
directory.readonly : voir l’annuaire Google Workspace de votre organisation

Accès : votre application travaille avec les contacts du compte Google qui autorise la connexion.

Google Drive

Recherchez, consultez et gérez des fichiers dans Google Drive. Exemples de prompts Dans le chat IA, décrivez les fichiers ou dossiers, ce qui déclenche l’action et les éventuels champs dynamiques. Par exemple :

Liste tous les fichiers de mon Google Drive et affiche-les dans mon application.

Recherche dans Google Drive les documents correspondant à un mot-clé et affiche les résultats.

Enregistre dans Google Drive les rapports PDF générés par mon application.

Lis une feuille de calcul depuis Google Drive et importe ses données dans mon application.

Déclenche un workflow quand un fichier est ajouté ou mis à jour dans Drive.

Scopes

Le scope drive donne à votre application accès à tous les fichiers et dossiers de Google Drive. Le scope drive.file couvre uniquement les fichiers que votre application crée ou ouvre.

Les noms des scopes Google Drive commencent par https://www.googleapis.com/auth/ :

drive : voir, créer, modifier et supprimer tous les fichiers et dossiers de Google Drive
drive.readonly : voir tous les fichiers et dossiers de Google Drive
drive.file : accéder uniquement aux fichiers que votre application crée ou ouvre avec autorisation

Accès : votre application travaille avec les fichiers du Google Drive du compte Google qui autorise la connexion.

Google Docs

Créez et modifiez des documents Google Docs. Exemples de prompts Dans le chat IA, décrivez le document, ce qui le déclenche et les éventuels champs dynamiques. Par exemple :

Génère automatiquement des documents de comptes rendus de réunion.

Crée des contrats à partir de modèles avec les données des clients.

Mets à jour les documents partagés quand le statut d'un projet change.

Exporte les rapports au format Google Docs.

Collabore sur des documents avec des commentaires de l'équipe.

Scopes

Le scope documents permet à votre application de voir et modifier tous les documents Google Docs du compte connecté, pas seulement ceux qu’elle crée.

Les noms des scopes Google Docs commencent par https://www.googleapis.com/auth/ :

documents : voir, créer et modifier tous les documents Google Docs
documents.readonly : voir tous les documents Google Docs

Accès : votre application travaille avec les documents du compte Google qui autorise la connexion.

Google Sheets

Lisez et écrivez des données dans des feuilles de calcul Google Sheets. Exemples de prompts Dans le chat IA, décrivez la feuille de calcul, ce qui déclenche l’action et les éventuels champs dynamiques. Par exemple :

Exporte les données de l'application vers une feuille de calcul Google Sheets.

Importe des prospects depuis une Google Sheet dans le CRM.

Mets à jour automatiquement les niveaux de stock dans Google Sheets.

Crée des rapports hebdomadaires et enregistre-les dans Google Sheets.

Synchronise les envois de formulaires avec une base de données Google Sheets.

Scopes

Le scope spreadsheets permet à votre application de modifier toutes les feuilles de calcul du compte, pas seulement celles qu’elle crée.

Les noms des scopes Google Sheets commencent par https://www.googleapis.com/auth/ :

spreadsheets : voir, modifier, créer et supprimer toutes les feuilles de calcul Google Sheets
spreadsheets.readonly : voir toutes les feuilles de calcul Google Sheets

Accès : votre application travaille avec les feuilles de calcul du compte Google qui autorise la connexion.

Scopes et permissions

Quand vous utilisez votre propre client OAuth, l’application OAuth vous appartient. C’est vous qui soumettez sa validation à Google. Les connecteurs Google partagés et Let Base44 manage OAuth utilisent l’application OAuth de Base44. Vous n’avez alors rien à soumettre à Google. Consultez Utiliser votre propre client OAuth. Google classe les permissions demandées par votre application en 3 catégories. Ces catégories déterminent la validation nécessaire avant la mise en ligne de votre application. Choisissez donc les scopes les plus restreints qui couvrent les besoins de votre application. C’est surtout important pour Gmail, Drive et Calendar.

Basiques : couvrent le nom, l’adresse e-mail et le profil. Google ne demande rien de plus.
Sensibles : couvrent un accès plus large à un service Google, comme la création d’événements d’agenda. Google demande une validation de l’application, avec un examen de votre utilisation des données.
Restreints : couvrent la lecture du contenu des messages ou des fichiers d’une personne, comme la lecture de Gmail. Google demande une validation de l’application. Il peut aussi exiger une évaluation de sécurité indépendante annuelle.

Pour envoyer des e-mails sans validation de scope restreint, demandez uniquement gmail.send.

La validation des scopes restreints peut prendre plusieurs semaines. En attendant, Google peut limiter le nombre de personnes qui utilisent votre application et afficher un avertissement d’application non validée. Si Google exige une évaluation de sécurité, un évaluateur indépendant agréé par Google examine votre application selon le cadre CASA. L’évaluation porte sur la plateforme qui exécute votre application et sur votre propre code. Contactez le support tôt. Les exigences, délais et exceptions sont fixés par Google. Consultez la documentation développeur de Google avant de planifier en fonction d’eux.

Base44 ajoute toujours le scope email pour identifier le compte Google. Comme il est toujours inclus, il apparaît comme scope verrouillé sous Scopes.

Utiliser les services Google dans une fonction backend

Si vous écrivez vos propres fonctions backend, elles peuvent appeler directement les API de Google. Base44 gère le flux OAuth et le stockage des jetons. Pour une connexion partagée, passez à getConnection() un ID de service du tableau ci-dessous. Pour une connexion utilisateur de l’application, passez l’ID de votre propre connecteur, pas un ID de service.

Connecteur partagé
Connecteur utilisateur de l'application

// One account the whole app uses
const { accessToken } =
  await base44.asServiceRole.connectors.getConnection("googlecalendar");
// Use the access token to call the Google Calendar API.

// The signed-in person's own account
const { accessToken } =
  await base44.asServiceRole.connectors.getCurrentAppUserConnection(
    "YOUR_CONNECTOR_ID",
  );
// Use the access token to call the Google API for that person.

Service	ID de service (connexions partagées)
Gmail	`gmail`
Google Calendar	`googlecalendar`
Google Contacts	`google_contacts`
Google Drive	`googledrive`
Google Docs	`googledocs`
Google Sheets	`googlesheets`
Google Workspace	`googleworkspace`

Connecteurs partagés

Configurez, déployez et appelez une connexion partagée depuis une fonction backend.

Connecteurs utilisateur de l'application

Récupérez un jeton par utilisateur et appelez l’API au nom de la personne connectée.

Dépannage

Si vous utilisez votre propre client OAuth, vérifiez ces points quand des personnes n’arrivent pas à connecter leur compte Google.

Certaines personnes n'arrivent pas à connecter leur propre compte

Votre propre client OAuth démarre en mode test. Dans ce mode, seuls les utilisateurs test approuvés peuvent se connecter. Avant d’ouvrir l’accès plus largement, passez votre application OAuth en production. Effectuez aussi toute validation exigée par Google.

La connexion échoue avec une erreur d'URI de redirection

Enregistrez l’URL de callback utilisée par votre connexion comme URI de redirection autorisé dans votre client OAuth Google :

Pour l’URL de callback unique, saisissez exactement https://connectors.base44.com/api/oauth/callback.
Pour les URL de callback par application, consultez Consulter vos URL de callback.

Cette page a été traduite par IA. Pour les informations les plus précises et à jour, consultez la version anglaise.

Démarrage

Créer votre app

Sécuriser votre app

Promouvoir votre app

Connecteurs

Notes de version

Ce que vous pouvez faire

Automatiser les e-mails

Synchroniser agendas et contacts

Travailler avec des fichiers et des données

Connecteur Google Workspace

Connecter un service Google

Services Google

Gmail

Google Calendar

Google Contacts

Google Drive

Google Docs

Google Sheets

Scopes et permissions

Utiliser les services Google dans une fonction backend

Connecteurs partagés

Connecteurs utilisateur de l'application

Dépannage

​Ce que vous pouvez faire

Automatiser les e-mails

Synchroniser agendas et contacts

Travailler avec des fichiers et des données

​Connecteur Google Workspace

​Connecter un service Google

​Services Google

​Gmail

​Google Calendar

​Google Contacts

​Google Drive

​Google Docs

​Google Sheets

​Scopes et permissions

​Utiliser les services Google dans une fonction backend

Connecteurs partagés

Connecteurs utilisateur de l'application

​Dépannage

Ce que vous pouvez faire

Connecteur Google Workspace

Connecter un service Google

Services Google

Gmail

Google Calendar

Google Contacts

Google Drive

Google Docs

Google Sheets

Scopes et permissions

Utiliser les services Google dans une fonction backend

Dépannage