Configurer l'API Google Chat

Chaque application Google Chat que vous créez nécessite son propre projet Google Cloud avec l'API Chat activée et configurée. Cette page vous explique comment configurer l'API Chat.

Prérequis

Configurer l'API Chat

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

    Accéder à l'API Chat

  2. Cliquez sur l'onglet Configuration, puis saisissez les informations requises suivantes:

    • Nom de l'application: nom que les utilisateurs utilisent lorsqu'ils interagissent avec votre application Chat.
    • URL de l'avatar: URL HTTPS pointant vers une image graphique carrée (par exemple, PNG ou JPEG), au moins 128 x 128, qui apparaît en tant qu'avatar de votre application Chat.
    • Description: description de la finalité de l'application Chat qui s'affiche sous le nom de votre application Chat.

  3. Pour activer les fonctionnalités interactives, cliquez sur le bouton Activer les fonctionnalités interactives qui permet aux utilisateurs d'interagir avec votre application Chat et utilisez le tableau suivant pour terminer la configuration:

    Champ Description
    Fonctionnalité Ensemble de champs qui déterminent la manière dont l'application Chat peut interagir avec les utilisateurs:
    • Recevoir des messages privés : les utilisateurs peuvent trouver l'application Chat et lui envoyer des messages directement dans Google Chat.
    • Rejoindre des espaces et des conversations de groupe: les utilisateurs peuvent ajouter l'application Chat aux espaces et aux conversations de groupe.
    Paramètres de connexion Le point de terminaison de l'application Chat, qui est l'un des éléments suivants:
    • URL de l'application: point de terminaison HTTPS qui héberge l'implémentation de l'application Chat.
    • Projet Apps Script: ID de déploiement d'un projet Apps Script mettant en œuvre une application Chat.
    • Nom du sujet Cloud Pub/Sub: un sujet Pub/Sub auquel l'application Chat s'abonne en tant que point de terminaison.
    • Dialogflow: enregistre l'application Chat avec une intégration Dialogflow. Pour en savoir plus, consultez l'article Créer une application Google Chat Dialogflow qui comprend le langage naturel.
    Commandes à barre oblique Commandes qui peuvent être présentées aux utilisateurs dans Google Chat. Permet aux utilisateurs de voir les actions principales de votre application Chat dans Google Chat et de choisir une action spécifique avec laquelle ils souhaitent interagir. Pour en savoir plus, consultez Répondre aux commandes à barre oblique en tant qu'application Chat.
    Aperçus de liens Formats d'URL reconnus par l'application Chat qui fournissent du contenu supplémentaire lorsque les utilisateurs envoient des liens. Pour en savoir plus, consultez Prévisualiser les liens.
    Visibilité Jusqu'à cinq personnes ou un ou plusieurs groupes Google autorisés à consulter et à installer votre application Chat. Utilisez ce champ pour tester votre application Chat ou la partager avec votre équipe. Pour en savoir plus, consultez Paramètres de visibilité et de publication de votre application Chat.

  4. Pour consigner les erreurs dans Cloud Logging chaque fois que l'application Chat renvoie une erreur, cochez la case Consigner les erreurs dans Logging. Pour en savoir plus, consultez la section Interroger les journaux d'erreurs pour les applications Chat.

  5. Cliquez sur Enregistrer. Lorsque vous enregistrez la configuration de l'application Chat, celle-ci devient disponible pour les utilisateurs spécifiés de votre organisation Google Workspace.

Autoriser d'autres utilisateurs à configurer une application Chat

Vous pouvez accorder à des utilisateurs spécifiques l'accès à la page de configuration de l'application Chat. Utilisez les rôles IAM Propriétaire des applications Chat et Lecteur d'applications Chat. Les utilisateurs disposant de ces rôles ne peuvent pas accéder à la page de configuration des applications Chat à l'aide du tableau de bord API et services, mais peuvent y accéder en accédant à la console Google Cloud pour le projet Cloud hôte de l'application Chat comme suit:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

Où PROJECT_ID correspond à l'ID du projet Google Cloud hébergeant l'application Chat.