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

Choisir un nom à afficher, un avatar et une description pour votre application Chat

Pour appeler l'API Chat, vous devez configurer une application Google Chat avec les informations suivantes:

Champ Description Format
Nom de l'application Nom à afficher de l'application Chat. 25 caractères alphanumériques maximum
URL de l'avatar Image qui s'affiche comme avatar de votre application Chat. URL HTTPS pointant vers une image graphique carrée (PNG ou JPEG). La taille recommandée est de 256 x 256 pixels ou plus.
Description Brève description de l'objectif de l'application Chat. 40 caractères alphanumériques maximum

Le nom, l'avatar et la description de l'application Chat sont présentés aux utilisateurs dans l'interface utilisateur de Chat. Pour certaines requêtes d'écriture de l'API Chat, Chat utilise ces informations pour attribuer les actions qu'une application Chat effectue dans Chat.

Par exemple, si vous appelez la méthode spaces.create(), Chat inclut le nom de l'application Chat dans la description de l'utilisateur ayant créé l'espace, comme illustré dans l'image suivante:

L'application Google Chat crée un espace pour un utilisateur.
Figure 1. Message d'attribution affiché par Chat lorsque la méthode spaces.create() est utilisée pour créer un espace au nom d'un utilisateur.

Pour interagir avec les applications Chat, les utilisateurs peuvent également voir ou utiliser ces informations de différentes manières:

  • Appelez l'application Chat en mentionnant son nom.
  • Recherchez et lancez un message privé avec l'application Chat. Dans le menu Applications, les messages privés affichent le nom et l'avatar de l'application Chat.
  • Dans la barre de composition, les utilisateurs peuvent parcourir les applications Chat et voir leur nom, leur avatar et leur description.

Configurer votre application Chat dans la console Google Cloud

Une fois que vous avez obtenu les informations sur votre application Chat, ouvrez votre projet Cloud et configurez l'API Chat:

  1. Dans la console Google Cloud, accédez à la page de l'API Chat, puis cliquez sur Configuration:

    Accéder à la page de configuration de l'API Chat

  2. Sous Informations sur l'application, remplissez les champs Nom de l'application, URL de l'avatar et Description.

  3. Sous "Fonctionnalités interactives", cliquez sur le bouton Activer les fonctionnalités interactives pour le désactiver. Vous pourrez le configurer ultérieurement. Pour en savoir plus sur la configuration et la création de fonctionnalités interactives, consultez la section Recevoir et répondre aux interactions utilisateur.

  4. Facultatif: sous Journaux, cochez la case Enregistrer les erreurs dans Logging pour utiliser Google Cloud Logging. Pour en savoir plus, consultez la section Journaux d'erreurs de requête pour les applications Chat.

  5. Cliquez sur Enregistrer.

Accorder à d'autres utilisateurs l'autorisation de configurer l'API Chat

Vous pouvez accorder l'accès à des utilisateurs spécifiques à la page de configuration de l'application Chat en leur attribuant le rôle IAM (Identity and Access Management) Google Cloud Propriétaire des applications Chat ou 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 accéder à la page de configuration en accédant à la console Google Cloud du 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.