> ## Documentation Index > Fetch the complete documentation index at: https://docs.base44.com/llms.txt > Use this file to discover all available pages before exploring further. # Connecteurs Google Workspace > Connectez Gmail, Google Calendar, Contacts, Drive, Docs et Sheets avec un connecteur individuel, ou utilisez-les ensemble via le connecteur 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. > [!NOTE] > > Vous avez besoin d'un [**plan Builder**](https://base44.com/pricing) 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 : ```text wrap theme={null} Apprends à me connaître : parcours mes e-mails, réunions et fichiers Drive, et dis-moi sur quoi je travaille. ``` ```text wrap theme={null} Sois mon assistant personnel : surveille ma boîte de réception et mon agenda, et dis-moi ce qui requiert mon attention aujourd'hui. ``` ```text wrap theme={null} Prépare ma prochaine réunion à partir des fils d'e-mails, des fichiers et des informations des participants. ``` ```text wrap theme={null} Rédige des relances pour les participants après chaque réunion. ``` ```text wrap theme={null} 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](#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é** 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é :** 1. Cliquez sur **Connectors** dans la barre latérale de votre espace de travail. 2. Cliquez sur **Add connector**. 3. Recherchez le service souhaité, comme **Google Calendar** ou **Google Workspace**, puis cliquez dessus. 4. Sélectionnez **Shared connector**, puis cliquez sur **Next**. 5. Saisissez un **Connection name**. 6. Choisissez où la connexion peut être utilisée dans **Who can access**. La valeur par défaut est **Apps and Super agent**. 7. 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**. 8. Cliquez sur **Add connector**, puis connectez-vous avec le compte Google à partager. 9. Ouvrez votre application dans l'éditeur d'application. 10. Demandez au chat IA d'utiliser la connexion Google partagée pour la fonctionnalité à créer. **Connecteur utilisateur de l'application** Chaque personne connecte son propre compte Google. Votre application travaille ainsi avec ses données. Google Calendar propose aussi **Let Base44 manage OAuth**. > [!TIP] > > **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](https://base44.com/pricing) ou supérieur. Si vous utilisez votre propre client OAuth, consultez [Scopes et permissions](#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 :** 1. Créez ou sélectionnez un projet dans la console Google Cloud. 2. Activez l'API de chaque service Google utilisé par votre application. 3. Configurez l'écran de consentement OAuth avec les scopes que vous prévoyez de demander. 4. Tant que votre application OAuth est en mode test, ajoutez comme utilisateurs test les comptes Google qui servent aux tests. 5. Créez un client OAuth pour une application web. 6. Ajoutez `https://connectors.base44.com/api/oauth/callback` comme URI de redirection autorisé. 7. Copiez l'ID client et le secret client. **Pour ajouter un connecteur Google utilisateur de l'application :** 1. Cliquez sur **Connectors** dans la barre latérale de votre espace de travail. 2. Cliquez sur **Add connector**. 3. Recherchez le service souhaité, comme **Google Calendar** ou **Google Drive**, puis cliquez dessus. 4. Sélectionnez **App user connector**, puis cliquez sur **Next**. 5. Si **Choose how to manage authentication** apparaît, sélectionnez **Let Base44 manage OAuth** ou **Use your own OAuth client**. 6. Saisissez un **Connector name**. 7. Si vous utilisez votre propre client OAuth, saisissez son **Client ID** et son **Client Secret**. 8. 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](#services-google). 9. Cliquez sur **Add Connector**. 10. Ouvrez votre application dans l'éditeur d'application. 11. 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](https://docs.base44.com/fr/Integrations/connectors-catalog.md). ### Gmail Envoyez, lisez et gérez des e-mails dans [Gmail](https://base44.com/integrations/connectors/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 : ```text wrap theme={null} Envoie des e-mails de confirmation automatiques quand une nouvelle commande est passée. ``` ```text wrap theme={null} Lis et analyse les e-mails entrants pour créer des tickets de support. ``` ```text wrap theme={null} Déclenche automatiquement un workflow à l'arrivée d'un nouvel e-mail. ``` ```text wrap theme={null} Envoie des e-mails de relance personnalisés aux nouveaux prospects. ``` ```text wrap theme={null} 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](https://base44.com/integrations/connectors/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 : ```text wrap theme={null} Synchronise toutes mes réservations directement dans mon Google Calendar. ``` ```text wrap theme={null} Montre aux clients mes disponibilités en temps réel depuis Google Calendar. ``` ```text wrap theme={null} Lance une automatisation quand un événement d'agenda est créé ou mis à jour. ``` ```text wrap theme={null} Bloque automatiquement les créneaux de réunion dans mon agenda personnel. ``` ```text wrap theme={null} 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 : ```text wrap theme={null} Crée un CRM qui synchronise les clients dans les deux sens avec mes Google Contacts. ``` ```text wrap theme={null} Importe comme prospects les personnes à qui j'ai écrit mais que je n'ai jamais enregistrées comme contacts. ``` ```text wrap theme={null} Analyse mon réseau de contacts et classe automatiquement les contacts avec l'IA. ``` ```text wrap theme={null} Crée un annuaire d'entreprise consultable à partir de mon organisation Google Workspace. ``` ```text wrap theme={null} 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](https://base44.com/integrations/connectors/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 : ```text wrap theme={null} Liste tous les fichiers de mon Google Drive et affiche-les dans mon application. ``` ```text wrap theme={null} Recherche dans Google Drive les documents correspondant à un mot-clé et affiche les résultats. ``` ```text wrap theme={null} Enregistre dans Google Drive les rapports PDF générés par mon application. ``` ```text wrap theme={null} Lis une feuille de calcul depuis Google Drive et importe ses données dans mon application. ``` ```text wrap theme={null} 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](https://base44.com/integrations/connectors/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 : ```text wrap theme={null} Génère automatiquement des documents de comptes rendus de réunion. ``` ```text wrap theme={null} Crée des contrats à partir de modèles avec les données des clients. ``` ```text wrap theme={null} Mets à jour les documents partagés quand le statut d'un projet change. ``` ```text wrap theme={null} Exporte les rapports au format Google Docs. ``` ```text wrap theme={null} 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](https://base44.com/integrations/connectors/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 : ```text wrap theme={null} Exporte les données de l'application vers une feuille de calcul Google Sheets. ``` ```text wrap theme={null} Importe des prospects depuis une Google Sheet dans le CRM. ``` ```text wrap theme={null} Mets à jour automatiquement les niveaux de stock dans Google Sheets. ``` ```text wrap theme={null} Crée des rapports hebdomadaires et enregistre-les dans Google Sheets. ``` ```text wrap theme={null} 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](https://docs.base44.com/fr/Integrations/Connectors.md#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. > [!TIP] > > 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](https://docs.base44.com/fr/Community-and-support/Contacting-support.md) tôt. Les exigences, délais et exceptions sont fixés par Google. Consultez la [documentation développeur de Google](https://developers.google.com/identity/protocols/oauth2/production-readiness/restricted-scope-verification) avant de planifier en fonction d'eux. > [!NOTE] > > 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é** ```javascript theme={null} // One account the whole app uses const { accessToken } = await base44.asServiceRole.connectors.getConnection("googlecalendar"); // Use the access token to call the Google Calendar API. ``` **Connecteur utilisateur de l'application** ```javascript theme={null} // 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](https://docs.base44.com/fr/developers/backend/resources/connectors/shared-connectors.md)** > > Configurez, déployez et appelez une connexion partagée depuis une fonction backend. > **[Connecteurs utilisateur de l'application](https://docs.base44.com/fr/developers/backend/resources/connectors/app-user-connectors.md)** > > 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](https://docs.base44.com/fr/Integrations/Connectors.md#consulter-vos-url-de-callback). > [!NOTE] > > Cette page a été traduite par IA. Pour les informations les plus précises et à jour, consultez la [version anglaise](https://docs.base44.com/index.md). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.