Créer une application Google Chat à l'aide de Google Apps Script

Créez une application Google Chat à laquelle vous pouvez envoyer des messages directement répond en récapitulant vos messages.

Le schéma suivant illustre l'architecture et le modèle de messagerie:

Architecture d'une application Chat implémentée avec Apps Script.

Dans le schéma précédent, un utilisateur interagissant avec un script Apps Script. L'application Chat comporte le flux d'informations suivant:

  1. Un utilisateur envoie un message à une application Chat, dans une par message privé ou dans un espace Chat.
  2. La logique de l'application Chat implémentée dans Apps Script, qui est hébergé dans Google Cloud, reçoit et traite le message.
  3. La logique de l'application Chat peut éventuellement s'intégrer à aux services Google Workspace, comme Agenda ou Sheets ou d'autres services Google, tels que Google Maps ou YouTube.
  4. La logique de l'application Chat renvoie une réponse au Service d'application Chat dans Chat
  5. La réponse est envoyée à l'utilisateur.

Objectifs

  • configurer votre environnement ;
  • Configurez le script.
  • Publiez l'application Chat.
  • Testez l'application Chat.

Prérequis

Configurer votre environnement

Ouvrir votre projet Cloud dans la console Google Cloud

S'il n'est pas déjà ouvert, ouvrez le projet Cloud que vous prévoyez d'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 le 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

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

  1. Dans la console Google Cloud, accédez au menu . > API et Services > Écran de consentement OAuth.

    Accéder à l'écran de consentement OAuth

  2. Pour Type d'utilisateur, sélectionnez Interne, puis cliquez sur Créer.
  3. Remplissez le formulaire d'inscription de l'application, puis cliquez sur Enregistrer et continuer.
  4. Pour l'instant, vous pouvez ignorer l'ajout de champs d'application et cliquer sur Enregistrer et continuer. Par la suite, lorsque vous créerez une application à utiliser en dehors de votre d'une organisation Google Workspace, vous devez remplacer le Type d'utilisateur par Externe, puis : ajouter les niveaux d'autorisation requis par votre application.

  5. Consultez le récapitulatif d'enregistrement de votre application. Pour y apporter des modifications, cliquez sur Modifier. Si l'application l'inscription vous semble correcte, cliquez sur Retour au tableau de bord.

Configurer le script

Pour configurer le script, utilisez un modèle, puis définissez votre Google Cloud dans Apps Script.

Créer le script à partir du modèle

  1. Accédez au Page Premiers pas d'Apps Script
  2. Cliquez sur le modèle Application de chat. Vous devrez peut-être faire défiler 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. Dans la console Google Cloud, accédez au menu . > IAM et Administrateur > Paramètres.

    Accéder à la page Paramètres de la section IAM et administration

  2. Dans le champ Numéro du projet, copiez la valeur.

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 Icône des paramètres du projet.
  2. Sous Projet Google Cloud Platform (GCP), cliquez sur Changer de projet.
  3. Dans Numéro de projet GCP, collez le numéro de projet Google Cloud.
  4. Cliquez sur Définir un projet.

Vous disposez à présent d'un code d'application fonctionnel que vous pouvez essayer (comme décrit dans le les étapes suivantes), puis les personnaliser en fonction de vos besoins.

Assurez-vous d'être connecté au bon compte Google lorsque vous ouvrez l'application Modèle Apps Script. Le compte actuel peut parfois passer à 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 que : vous pourrez 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", car vous en aurez besoin lors d'une prochaine étape, 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 App name (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 privés, puis Rejoindre des espaces et des conversations de groupe
    5. Sous "Connection settings" (Paramètres de connexion), sélectionnez Apps Script project (Projet Apps Script).
    6. Dans le champ Deployment ID (ID de déploiement), collez l'ID de déploiement "Head" que vous précédemment copiées.
    7. Sous "Visibilité", sélectionnez Utilisateurs 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.

Tester l'application Chat

Pour tester votre application Chat, ouvrez un espace de message privé avec l'application Chat et envoyez un message:

  1. Ouvrez Google Chat à l'aide du compte Google Workspace que vous fourni lorsque vous vous êtes ajouté en tant que testeur de confiance.

    Accéder à Google Chat

  2. Cliquez sur Nouveau chat.
  3. Dans le champ Ajouter une ou plusieurs personnes, saisissez le nom de votre Application Chat
  4. Sélectionnez votre application Chat dans les résultats. Un direct message s'ouvre.

  5. Dans le nouveau message privé avec l'application, saisissez Hello et appuyez sur enter.

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

Pour ajouter des testeurs de confiance et en savoir plus sur le test des fonctionnalités interactives, consultez Testez les fonctionnalités interactives pour Applications Google Chat

Résoudre les problèmes

Lorsqu'une application ou card renvoie une erreur, la L'interface Chat affiche le message "Une erreur s'est produite". ou "Impossible de traiter votre demande." Parfois, l'interface utilisateur de Chat n'affiche aucun message d'erreur, mais que l'application ou la carte produit un résultat inattendu. Par exemple, un message de fiche peut ne pas s'affichent.

Même s'il est possible qu'aucun message d'erreur ne s'affiche dans l'interface utilisateur de Chat, Des messages d'erreur descriptifs et des données de journaux sont disponibles pour vous aider à corriger les erreurs. Lorsque la journalisation des erreurs est activée pour les applications Chat. Pour obtenir de l'aide, le débogage et la correction des erreurs, consultez Résoudre les problèmes liés à Google Chat

Effectuer un nettoyage

Afin d'éviter que des frais ne soient facturés sur votre compte Google Cloud pour utilisées dans ce tutoriel, nous vous recommandons de supprimer Google Cloud.

  1. Dans la console Google Cloud, accédez à la page Gérer les ressources. Cliquez sur Menu > IAM et Administrateur > Gérer les ressources.

    <ph type="x-smartling-placeholder"></ph> Accéder au gestionnaire de ressources

  2. Dans la liste des projets, sélectionnez celui que vous souhaitez supprimer, puis cliquez sur Supprimez .
  3. Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour le supprimer. le projet.

Étapes suivantes

  • Créer des fiches interactives – Fiche les messages prennent en charge une mise en page définie, des éléments interactifs de l'interface utilisateur tels que des boutons et du rich media, comme des images. Utilisez des messages de fiche pour présenter des informations détaillées, recueillir des informations auprès des utilisateurs et les guider vers l'étape suivante.
  • Prendre en charge les commandes à barre oblique : les commandes à barre oblique permettent vous enregistrez et faites la promotion de commandes spécifiques que les utilisateurs peuvent transmettre à votre application en saisissant une commande commençant par une barre oblique (/), comme /help.
  • Ouvrir les boîtes de dialogue : les boîtes de dialogue sont affichées sous forme de fenêtres et basées sur des fiches. que votre application peut ouvrir pour interagir avec un utilisateur. Plusieurs cartes peuvent être associés de manière séquentielle, ce qui permet aux utilisateurs d'effectuer plusieurs étapes processus, comme le remplissage de données de formulaire.
  • Atelier de programmation:vous êtes prêt à créer un Application de chat ? Voir les commentaires Application Chat de l'atelier de programmation Créer des applications Google Chat avec Gemini