Guide de démarrage rapide de l'application Chat de Google Apps Script

Créez une application Google Chat à laquelle vous pouvez envoyer directement des messages et qui répond en renvoyant les messages.

Objectifs

• configurer votre environnement ;
• Configurez le script.
• Publiez l'application.
• Exécutez le script.

Prérequis

• Un compte Google Workspace avec accès à Chat.
• un projet Google Cloud ;

Configurer votre environnement

Ouvrir votre projet Cloud dans la console Google Cloud

Si ce n'est pas déjà fait, ouvrez le projet Cloud que vous souhaitez utiliser pour cet exemple:

1. Dans la console Google Cloud, accédez à la page Sélectionner un projet.

   Sélectionner un projet Cloud

2. Sélectionnez le projet Google Cloud que vous souhaitez utiliser. Vous pouvez également cliquer sur Créer un projet et suivre les instructions à l'écran. Si vous créez un projet Google Cloud, vous devrez peut-être activer la facturation pour ce projet.

Activer l'API Chat

Avant d'utiliser les API Google, vous devez les activer dans un projet Google Cloud. Vous pouvez activer une ou plusieurs API dans un même projet Google Cloud.

• Dans la console Google Cloud, activez l'API Google Chat.

  Activer l'API

Configurer l'écran de consentement OAuth

Toutes les applications utilisant OAuth 2.0 nécessitent une configuration de l'écran d'autorisation. La configuration de l'écran d'autorisation OAuth de votre application définit ce qui s'affiche pour les utilisateurs et les examinateurs, et enregistre votre application pour que vous puissiez la publier plus tard.

1. Dans la console Google Cloud, accédez à Menu > API et services > Écran d'autorisation OAuth.

   Accéder à l'écran de consentement OAuth

2. Sélectionnez le type d'utilisateur de votre application, puis cliquez sur Créer.
3. Remplissez le formulaire d'inscription, puis cliquez sur Enregistrer et continuer.

4. Pour l'instant, vous pouvez ignorer l'ajout de champs d'application et cliquer sur Save and Continue (Enregistrer et continuer). À l'avenir, lorsque vous créerez une application à utiliser en dehors de votre organisation Google Workspace, vous devrez ajouter et valider les champs d'application des autorisations requis par votre application.

5. Si vous avez sélectionné Externe comme type d'utilisateur, ajoutez des utilisateurs tests :
   1. Sous Utilisateurs de test, cliquez sur Ajouter des utilisateurs.
   2. Saisissez votre adresse e-mail et tout autre utilisateur de test autorisé, puis cliquez sur Enregistrer et continuer.
6. Examinez le récapitulatif de l'enregistrement de votre appli. Pour apporter des modifications, cliquez sur Modifier. Si l'enregistrement de l'application vous convient, cliquez sur Retour au tableau de bord.

Configurer le script

Pour configurer le script, vous allez utiliser un modèle, puis configurer votre projet Cloud dans Apps Script.

Créer le script à partir du modèle

1. Accédez à la page Premiers pas d'Apps Script.
2. Cliquez sur le modèle Application de chat. Vous devrez peut-être faire défiler la page vers le bas pour voir ce modèle.
3. Cliquez sur Projet sans titre, saisissez Quickstart app, puis cliquez sur Renommer.

Copier le numéro de projet Cloud

1. Accédez à votre projet Cloud dans la console Google Cloud.
2. Cliquez sur Paramètres et utilitaires > Paramètres du projet.
3. Copiez le numéro du projet.

Définir le projet Cloud du projet Apps Script

1. Dans le projet Apps Script de l'application Chat, cliquez sur Paramètres du projet .
2. Sous Projet Google Cloud Platform (GCP), cliquez sur Modifier le projet.
3. Dans Numéro de projet GCP, collez le numéro du projet Google Cloud.
4. Cliquez sur Définir le projet.

Vous disposez maintenant d'un code d'application opérationnel que vous pouvez tester (comme décrit dans les étapes suivantes), puis le personnaliser pour répondre à vos besoins.

Assurez-vous d'être connecté au bon compte Google lorsque vous ouvrez le modèle Apps Script. Le compte actuel peut parfois basculer sur votre compte par défaut sans que vous le remarquiez.

Créer un déploiement test

Vous avez besoin d'un ID de déploiement pour ce projet Apps Script, afin de pouvoir l'utiliser à l'étape suivante.

Pour obtenir l'ID de déploiement "head", procédez comme suit:

1. Dans le projet Apps Script de l'application Chat, cliquez sur Déployer > Tester les déploiements.
2. Copiez l'ID de déploiement Head afin de l'utiliser ultérieurement, puis cliquez sur OK.

Publier l'application Chat

Publiez l'application Chat depuis la console Google Cloud.

1. Dans la console Google Cloud, recherchez Google Chat API, puis cliquez sur API Google Chat.
2. Cliquez sur Gérer.

3. Cliquez sur Configuration et configurez l'application Chat:

   1. Dans le champ Nom de l'application, saisissez Quickstart app.
   2. Dans le champ URL de l'avatar, saisissez https://developers.google.com/chat/images/quickstart-app-avatar.png.
   3. Dans le champ Description, saisissez Quickstart app.
   4. Sous "Fonctionnalités", sélectionnez Recevoir des messages 1:1 et Rejoindre des espaces et des conversations de groupe.
   5. Sous "Paramètres de connexion", sélectionnez Projet Apps Script et collez l'ID de déploiement dans le champ.
   6. Sous "Autorisations", sélectionnez Personnes et groupes spécifiques dans votre domaine, puis saisissez votre adresse e-mail.

4. Cliquez sur Enregistrer et actualisez la page.

5. Sur la page de configuration, sous État de l'application, définissez l'état sur Disponible pour les utilisateurs.

6. Cliquez sur Enregistrer.

L'application Chat est prête à répondre aux messages.

Exécuter le script

1. Ouvrez Chat.
2. Envoyez un nouveau message privé à l'application en cliquant sur Démarrer un chat > Rechercher des applications.
3. Sur la page "Rechercher des applications", recherchez Quickstart App.
4. À côté de Démarrage rapide - Application, cliquez sur Chat.
5. Dans le nouveau message privé contenant l'application, saisissez Hello et appuyez sur enter.

L'application vous remercie de l'avoir ajoutée et fait écho à votre message.

Étapes suivantes

• Créer des fiches interactives : les messages des fiches acceptent une mise en page définie, des éléments interactifs de l'interface utilisateur comme les boutons et des images rich media comme les images. Utilisez les messages de la fiche pour présenter des informations détaillées, recueillir des informations auprès des utilisateurs et les inciter à passer à l'étape suivante.
• Utiliser les commandes à barre oblique : les commandes à barre oblique vous permettent d'enregistrer et de promouvoir des commandes spécifiques que les utilisateurs peuvent fournir à votre application en saisissant une commande commençant par une barre oblique (/), comme /help.
• Lancer les boîtes de dialogue : les boîtes de dialogue sont des interfaces fenêtrées, basées sur des fiches, que votre application peut ouvrir pour interagir avec un utilisateur. Il est possible d'associer plusieurs cartes de manière séquentielle, ce qui aide les utilisateurs à effectuer des processus en plusieurs étapes, comme remplir des données de formulaire.