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
- Une entreprise Un compte Google Workspace ayant accès à Google Chat :
- Créez un projet Google Cloud.
- Configurer l'écran de consentement OAuth
- Activez l'API Google Chat.
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:
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:
Dans la console Google Cloud, accédez à la page de l'API Chat et cliquez sur l'icône Page Configuration:
Sous Application info (Informations sur l'application), renseignez le champ App name (Nom de l'application), Avatar URL (URL de l'avatar), et Description.
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.
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
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
Où PROJECT_ID est l'ID du projet
Projet Google Cloud hébergeant l'application Chat.
Articles associés
- Choisir une architecture d'application Chat
- Pour configurer votre application Chat pour les fonctionnalités interactives : Voir la section Recevoir des interactions utilisateur et y répondre