GSP250

Présentation

Avec les bots Google Chat, vous disposez de points d'accès aux données et services de votre organisation. Et ils sont très simples à utiliser. Les utilisateurs peuvent converser avec les bots dans une interface de chat. Vous pouvez créer un bot Google Chat à l'aide de Google Apps Script. Cela vous permet également d'accéder facilement à d'autres services Google tels que Drive, Gmail, Agenda, Docs et Sheets.

Dans cet atelier, vous allez utiliser Google Apps Script pour créer un bot Google Chat simple. Il s'agit d'une introduction rapide aux bots Google Chat.

Objectifs de l'atelier

Dans cet atelier, vous allez réaliser les tâches suivantes :

• Créer une application de chat à partir d'un modèle avec des gestionnaires d'événements préremplis
• Configurer et publier le bot Google Chat

Préparation

Avant de cliquer sur le bouton "Démarrer l'atelier"

Lisez ces instructions. Les ateliers sont minutés, et vous ne pouvez pas les mettre en pause. Le minuteur, qui démarre lorsque vous cliquez sur Démarrer l'atelier, indique combien de temps les ressources Google Cloud resteront accessibles.

Cet atelier pratique vous permet de suivre les activités dans un véritable environnement cloud, et non dans un environnement de simulation ou de démonstration. Des identifiants temporaires vous sont fournis pour vous permettre de vous connecter à Google Cloud le temps de l'atelier.

Pour réaliser cet atelier :

• Vous devez avoir accès à un navigateur Internet standard (nous vous recommandons d'utiliser Chrome).

Remarque : Ouvrez une fenêtre de navigateur en mode incognito (recommandé) ou de navigation privée pour effectuer cet atelier. Vous éviterez ainsi les conflits entre votre compte personnel et le compte temporaire de participant, qui pourraient entraîner des frais supplémentaires facturés sur votre compte personnel.

• Vous disposez d'un temps limité. N'oubliez pas qu'une fois l'atelier commencé, vous ne pouvez pas le mettre en pause.

Remarque : Utilisez uniquement le compte de participant pour cet atelier. Si vous utilisez un autre compte Google Cloud, des frais peuvent être facturés à ce compte.

Démarrer l'atelier et se connecter à la console Google Cloud

1. Cliquez sur le bouton Démarrer l'atelier. Si l'atelier est payant, une boîte de dialogue s'affiche pour vous permettre de sélectionner un mode de paiement. Sur la gauche, vous trouverez le panneau "Détails concernant l'atelier", qui contient les éléments suivants :

   • Le bouton "Ouvrir la console Google Cloud"
   • Le temps restant
   • Les identifiants temporaires que vous devez utiliser pour cet atelier
   • Des informations complémentaires vous permettant d'effectuer l'atelier

2. Cliquez sur Ouvrir la console Google Cloud (ou effectuez un clic droit et sélectionnez Ouvrir le lien dans la fenêtre de navigation privée si vous utilisez le navigateur Chrome).

   L'atelier lance les ressources, puis ouvre la page "Se connecter" dans un nouvel onglet.

   Conseil : Réorganisez les onglets dans des fenêtres distinctes, placées côte à côte.

   Remarque : Si la boîte de dialogue Sélectionner un compte s'affiche, cliquez sur Utiliser un autre compte.

3. Si nécessaire, copiez le nom d'utilisateur ci-dessous et collez-le dans la boîte de dialogue Se connecter.

   {{{user_0.username | "Username"}}}

   Vous trouverez également le nom d'utilisateur dans le panneau "Détails concernant l'atelier".

4. Cliquez sur Suivant.

5. Copiez le mot de passe ci-dessous et collez-le dans la boîte de dialogue Bienvenue.

   {{{user_0.password | "Password"}}}

   Vous trouverez également le mot de passe dans le panneau "Détails concernant l'atelier".

6. Cliquez sur Suivant.

   Important : Vous devez utiliser les identifiants fournis pour l'atelier. Ne saisissez pas ceux de votre compte Google Cloud. Remarque : Si vous utilisez votre propre compte Google Cloud pour cet atelier, des frais supplémentaires peuvent vous être facturés.

7. Accédez aux pages suivantes :

   • Acceptez les conditions d'utilisation.
   • N'ajoutez pas d'options de récupération ni d'authentification à deux facteurs (ce compte est temporaire).
   • Ne vous inscrivez pas à des essais sans frais.

Après quelques instants, la console Cloud s'ouvre dans cet onglet.

Remarque : Pour accéder aux produits et services Google Cloud, cliquez sur le menu de navigation ou saisissez le nom du service ou du produit dans le champ Recherche.

Tâche 1 : Créer une application de chat à partir d'un modèle

Pour implémenter votre bot, créez un projet Google Apps Script à l'aide du modèle d'application de chat.

Remarque : Lorsque vous vous connectez à la console Google Cloud, votre projet et vos identifiants sont définis. Avant de cliquer sur le lien de l'éditeur Google Apps Script à l'étape 1, assurez-vous d'être connecté à la console Google Cloud.

1. Cliquez sur ce lien vers la page d'accueil de Google Apps Script pour ouvrir l'éditeur en ligne Google Apps Script.

2. Sous Déclencheurs des modules complémentaires Google Workspace, cliquez sur Application de chat (version intermédiaire).

3. Cliquez sur Projet sans titre (nom actuel du projet).

4. Dans la boîte de dialogue Modifier le nom du projet, renommez le projet Friendly Bot, puis cliquez sur Renommer.

Événements dans Google Chat

La plupart des interactions d'un bot Apps Script avec Google Chat sont basées sur des événements. Les interactions entre l'utilisateur, le bot et Google Chat se déroulent généralement de la manière suivante :

1. Un utilisateur lance une action, telle que l'ajout d'un bot à un salon, le démarrage d'un message privé (MP) avec un bot ou la suppression du bot d'un salon.
2. Cette action déclenche un événement destiné au bot dans Google Chat.
3. Google Chat appelle le gestionnaire d'événements correspondant défini dans le script du bot.

Google Chat déclenche quatre événements pouvant être écoutés par votre bot Apps Script :

• ADDED_TO_SPACE : cet événement se produit lorsqu'un utilisateur humain ajoute un bot à un salon ou à un MP. Dans Apps Script, la gestion de cet événement s'effectue grâce à une fonction onAddedToSpace().
• REMOVED_FROM_SPACE : cet événement se produit lorsqu'un utilisateur supprime le bot d'un salon ou d'un MP. Cet événement ne publie aucun message de réponse à l'intention de Google Chat. Dans Apps Script, la gestion de cet événement s'effectue grâce à une fonction onRemovedFromSpace().
• MESSAGE : cet événement se produit lorsqu'un utilisateur adresse un message au bot, soit directement par le biais d'un MP, soit sous la forme d'une @mention dans un salon. Dans Apps Script, la réponse à cet événement s'effectue grâce à une fonction onMessage().

Mettre à jour le code du gestionnaire d'événements MESSAGE

Le modèle d'application de chat préremplit le fichier de code contenant les gestionnaires d'événements.

• Cliquez sur le fichier Code.gs pour examiner les gestionnaires d'événements préremplis.

Remarquez les gestionnaires d'événements pour les événements MESSAGE, ADDED_TO_SPACE et REMOVE_FROM_SPACE. Ils exécutent les fonctions spécifiques mentionnées précédemment pour effectuer diverses tâches, comme répondre aux messages des utilisateurs dans Google Chat.

Créer une application de chat à partir d'un modèle

Tâche 2 : Publier et tester le chatbot

Pour que vous puissiez exécuter et tester le bot, l'API Google Chat doit être activée pour votre projet Google Cloud, et votre bot doit être publié.

Dans cette tâche, vous allez effectuer les différentes étapes de configuration pour pouvoir publier le bot. Vous allez ainsi configurer l'écran de consentement OAuth, mettre à jour l'application Apps Script pour qu'elle référence le projet Google Cloud approprié et mettre à jour la configuration de l'API Google Chat pour publier le bot à des fins de test.

Configurer l'écran de consentement OAuth

1. Accédez à la console Google Cloud, cliquez sur le menu de navigation () en haut à gauche, puis accédez à API et services > Écran de consentement OAuth.

2. Cliquez sur Commencer.

3. Sur la page de configuration du projet, sous Informations sur l'application, configurez les éléments suivants, puis cliquez sur Suivant :

Champ	Valeur
Nom de l'application	Friendly Bot
Adresse e-mail d'assistance utilisateur	Sélectionnez l'ID d'adresse e-mail dans le menu déroulant. Il s'agit également de votre adresse e-mail utilisateur dans le panneau de gauche des instructions de l'atelier.

4. Dans le champ Audience, sélectionnez Interne, puis cliquez sur Suivant.

5. Pour Coordonnées, saisissez l'adresse e-mail , puis cliquez sur Suivant.

6. Acceptez le règlement, puis cliquez sur Continuer et Créer.

Cliquez sur Vérifier ma progression pour valider l'objectif.

Configurer l'écran de consentement de l'utilisateur

Identifier le numéro du projet Google Cloud et mettre à jour l'application Apps Script pour y faire référence

1. Dans le menu de navigation (), cliquez sur Présentation Cloud > Tableau de bord.

2. Dans le tableau de bord, localisez la section Informations sur le projet.

3. Enregistrez le numéro du projet. Il sera utilisé à l'étape suivante pour configurer votre projet.

4. Revenez à l'éditeur Apps Script, puis accédez aux paramètres du projet Friendly Bot ().

5. Sous Projet Google Cloud Platform (GCP), cliquez sur Changer de projet.

6. Dans le champ Numéro de projet GCP, saisissez le numéro de projet que vous avez copié précédemment. Cliquez ensuite sur Définir un projet.

Configurer et publier le chatbot

1. Dans l'éditeur Apps Script, cliquez sur Déployer > Tester les déploiements (en haut à droite de l'écran), puis sur Copier à côté de l'ID de déploiement Head pour obtenir l'ID de déploiement Head du déploiement de test.

2. Dans la console Google Cloud, accédez au menu de navigation () > API et services > Bibliothèque.

3. Dans la bibliothèque, recherchez Google Chat API, puis sélectionnez l'API dans la liste des résultats.

L'API Google Chat doit déjà être activée dans ce projet. Si ce n'est pas le cas, cliquez sur Activer.

4. Cliquez sur Gérer, puis sur l'onglet Configuration de l'API Google Chat.

5. Dans la boîte de dialogue Configuration, saisissez ces valeurs dans les champs suivants :

Champ	Valeur
Nom de l'application	Friendly Bot
URL de l'avatar	https://goo.gl/kv2ENA
Description	Bot de l'atelier Apps Script
Fonctionnalité	Activez Rejoindre des espaces et des conversations de groupe.
Paramètres de connexion	Sélectionnez Apps Script, puis collez l'ID de déploiement Head que vous avez copié à l'étape 1 dans la zone ID de déploiement.
Visibilité

6. Cliquez sur Enregistrer.

7. Une fois les modifications enregistrées, faites défiler la boîte de dialogue Configuration jusqu'en haut pour définir l'état de l'application sur EN COURS – disponible pour les utilisateurs.

Vous devrez peut-être actualiser la page pour voir le champ État de l'application. Si la valeur d'État de l'application est déjà définie sur EN COURS – disponible pour les utilisateurs, vous pouvez la conserver, mais veillez à enregistrer à nouveau la page à l'étape suivante.

8. Cliquez à nouveau sur Enregistrer.

Tester le chatbot

Nous voici arrivés à la dernière section. Pour tester votre bot dans Google Chat, suivez les étapes ci-dessous.

1. Cliquez sur le lien Google Chat pour ouvrir Google Chat.

2. Sélectionnez Démarrer une discussion.

3. Recherchez Friendly bot.

4. Dans les résultats, sélectionnez le Friendly Bot (bot de l'atelier Apps Script) que vous avez créé pour démarrer une discussion.

Lorsque le fil de discussion de messages privés s'affiche, vous devez recevoir un message dans lequel le bot vous remercie de l'avoir ajouté à un MP.

Thank you for adding me to a direct message, student XXXXX!

Cette réponse est initiée par la fonction onAddedToSpace, qui répond à l'événement spécifique d'ajout du bot à un espace de chat.

5. Enfin, saisissez un message pour le bot, par exemple "Bonjour !".

Le bot doit répéter votre message, par exemple :

You said "Bonjour !"

Cette réponse est initiée par la fonction nommée onMessage, qui répond à l'événement spécifique des utilisateurs envoyant un message privé au bot.

Félicitations !

Vous avez rapidement créé un bot Google Chat qui répond aux messages des utilisateurs.

Étapes suivantes et informations supplémentaires

• Découvrez ce que vous pouvez faire d'autre avec Workspace :
  • Google Apps Script : accéder à Google Sheets, Maps et Gmail en quatre lignes de code
• Consultez ces ressources utiles :
  • Site de documentation de Google Chat
  • Guide de démarrage rapide d'un bot Apps Script
  • Créer des bots
  • Publier des bots
  • Créer des fiches interactives
  • Documentation de référence sur les fiches
  • Documentation de référence sur les objets d'événement
  • Documentation de référence sur le service avancé de Gmail
  • Documentation de référence sur l'API Apps Script Calendar
  • Centre de formation Google Workspace

Formations et certifications Google Cloud

Les formations et certifications Google Cloud vous aident à tirer pleinement parti des technologies Google Cloud. Nos cours portent sur les compétences techniques et les bonnes pratiques à suivre pour être rapidement opérationnel et poursuivre votre apprentissage. Nous proposons des formations pour tous les niveaux, à la demande, en salle et à distance, pour nous adapter aux emplois du temps de chacun. Les certifications vous permettent de valider et de démontrer vos compétences et votre expérience en matière de technologies Google Cloud.

Dernière mise à jour du manuel : 18 août 2025

Dernier test de l'atelier : 18 août 2025

Copyright 2025 Google LLC. Tous droits réservés. Google et le logo Google sont des marques de Google LLC. Tous les autres noms d'entreprises et de produits peuvent être des marques des entreprises auxquelles ils sont associés.