Configurer l'API Google Chat

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

Prérequis

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

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

Champ Description Format
Nom de l'application Nom à afficher de l'application Chat. Jusqu'à 25 caractères alphanumériques
URL de l'avatar L'image qui s'affiche dans l'image de votre application Chat avatar. 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 Une brève description que l'objectif Application Chat Jusqu'à 40 caractères alphanumériques

Le nom, l'avatar et la description de l'application Chat sont visibles par les utilisateurs dans l'interface utilisateur de Chat. Pour certaines API Chat de requête d'écriture, Chat utilise ces informations pour attribuer actions effectuées par une application Chat dans Chat.

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

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

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

  • Appelez l'application Chat en mentionnant son nom (@mention).
  • Recherchez et démarrez un message privé avec l'application Chat. Dans le menu Applications, les messages privés affichent le Nom et avatar de l'application Chat.
  • Dans la barre de rédaction, 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 les détails de votre application Chat, ouvrez votre Cloud et configurez l'API Chat:

  1. Dans la console Google Cloud, accédez à la page de l'API Chat et cliquez sur l'icône Page Configuration:

    Accéder à la page "Configuration de l'API Chat"

  2. Sous Application info (Informations sur l'application), renseignez le champ App name (Nom de l'application), Avatar URL (URL de l'avatar), et Description.

  3. Sous "Fonctionnalités interactives", cliquez sur le bouton Activer les fonctionnalités interactives. pour désactiver les fonctionnalités interactives Application Chat Vous pourrez le faire plus tard. Pour en savoir plus la configuration et la création de fonctionnalités interactives, consultez recevoir les interactions des utilisateurs et y répondre.

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

  5. Cliquez sur Enregistrer.

Autoriser d'autres personnes à configurer une application Chat

Vous pouvez accorder l'accès à des utilisateurs spécifiques à la page de configuration de l'application Chat. Utilisez les IAM Propriétaire des applications Chat et Lecteur d'applications Chat de rôles. Les utilisateurs disposant de ces rôles ne peuvent pas accéder aux applications Chat de configuration à l'aide du module API et des services, mais peut accédez à la page de configuration en accédant à la console Google Cloud pour 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

PROJECT_ID est l'ID du projet Projet Google Cloud hébergeant l'application Chat.

<ph type="x-smartling-placeholder">