Application Google Apps Script Chat

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Créez une application Google Chat à laquelle vous pouvez envoyer des messages directement et qui y répond en faisant écho à vos messages.

Objectifs

  • configurer votre environnement ;
  • Créez le script.
  • Publiez l'application.
  • Exécutez l'exemple.

Conditions préalables

Configurer votre environnement

Pour suivre ce guide de démarrage rapide, configurez votre environnement.

Activer l'API

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 Google Cloud Console, activez l'API Google Chat.

    Activer l'API

Toutes les applications utilisant OAuth 2.0 nécessitent une configuration d'écran de consentement. La configuration de l'écran d'autorisation OAuth de votre application définit ce qui est présenté aux utilisateurs et aux examinateurs. Elle enregistre votre application pour que vous puissiez la publier ultérieurement.

  1. Dans Google Cloud Console, accédez au menu > API et services > Écran de consentement 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. Si vous créez une application à utiliser en dehors de votre organisation Google Workspace, cliquez sur Ajouter ou supprimer des habilitations. Ajoutez et vérifiez les champs d'application d'autorisation requis par votre application, puis cliquez sur Enregistrer et continuer.

    Certains champs d'application nécessitent un examen supplémentaire de la part de Google. Pour les applications utilisées uniquement en interne par votre organisation Google Workspace, les niveaux d'accès ne sont pas répertoriés sur l'écran de consentement. L'utilisation de niveaux d'accès restreints ou sensibles ne nécessite pas un examen plus approfondi de la part de Google. Pour en savoir plus, consultez Choisir des habilitations pour votre application.

  5. Sous "Utilisateurs de test", cliquez sur Ajouter des utilisateurs.
  6. Saisissez votre adresse e-mail et tous les autres utilisateurs autorisés, puis cliquez sur Enregistrer et continuer.
  7. Consultez le récapitulatif de l'enregistrement de votre application. Pour apporter des modifications, cliquez sur Modifier. Si l'enregistrement de l'application semble correct, cliquez sur Retour au tableau de bord.

Créer le script

Pour créer le script, vous allez utiliser un modèle, puis définir 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 du projet Cloud

  1. Accédez à Google Cloud Console.
  2. Si nécessaire, ouvrez le projet Cloud que vous souhaitez utiliser pour ce guide de démarrage rapide :
    1. À côté de Google Cloud, cliquez sur la flèche vers le bas . Une boîte de dialogue répertoriant les projets en cours s'affiche.
    2. Sélectionnez votre projet et cliquez sur Ouvrir. La console ouvre votre projet.
  3. Cliquez sur Paramètres et utilitaires > Paramètres du projet.
  4. Copiez le numéro du projet.

Définir le projet Cloud Apps Script

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

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

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

Obtenir l'ID de déploiement

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

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

  1. Dans le projet Apps Script de l'application de chat, cliquez sur Déployer > New deployment (Déployer le nouveau déploiement).
  2. Sous "Sélectionner un type", cliquez sur Module complémentaire.
  3. Renseignez les options, puis cliquez sur Deploy (Déployer).
  4. Sous "Deployment ID" (ID de déploiement), cliquez sur Copy (Copier).

Publier l'application Chat

Publiez l'application Chat à partir de Google Cloud Console.

  1. Dans Google Cloud Console, 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é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 de votre domaine, puis saisissez votre adresse e-mail.
  4. Cliquez sur Enregistrer.

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

Exécuter l'exemple

  1. Ouvrez Chat.
  2. Envoyez un nouveau message privé à l'application en cliquant sur Démarrer une discussion > Rechercher des applications.
  3. Sur la page "Rechercher des applications", recherchez "Démarrage rapide".
  4. À côté de Démarrage rapide de l'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 renvoie votre message.

Étapes suivantes

  • Créer des fiches interactives Les messages de la fiche acceptent une mise en page définie, des éléments d'interface interactifs tels que des boutons, et des éléments rich media comme des images. Les fiches permettent de présenter des informations détaillées, de rassembler les informations des utilisateurs et de les guider vers l'étape suivante.
  • Compatibilité avec 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 des 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. Plusieurs fiches peuvent être jointes de manière séquentielle, ce qui permet aux utilisateurs d'effectuer des processus en plusieurs étapes, comme remplir des données de formulaire.