Configurer l'API Google Chat

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

Conditions préalables

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:

    • App name (Nom de l'application) : nom utilisé par les utilisateurs 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 comme l'avatar de votre application Chat.
    • Description: description de l'objectif prévu de l'application Chat, qui apparaît 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étermine la manière dont l'application Chat peut interagir avec les utilisateurs:
    • Recevoir des messages privés : les utilisateurs peuvent rechercher 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 Point de terminaison de l'application Chat, qui correspond à l'un des points suivants:
    • URL de l'application: point de terminaison HTTPS qui héberge la mise en œuvre 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: 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 la page 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 d'afficher les actions principales de votre application Chat dans Google Chat et de choisir l'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 et comprenant du contenu supplémentaire pour l'envoi de liens par les utilisateurs Pour en savoir plus, consultez Liens d'aperçu.
    Visibilité Jusqu'à cinq personnes ou un ou plusieurs groupes Google qui peuvent voir et installer votre application Chat. Utilisez ce champ pour tester votre application Chat ou pour la partager avec votre équipe. Pour en savoir plus, consultez Paramètres de visibilité et de publication pour votre application Chat.

  4. Pour consigner des 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 Journaux d'erreurs de requête pour les applications Chat.

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

Autoriser d'autres personnes à 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 des 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.