Développer avec Google Chat

Cette page présente l'API Google Chat et les applications Google Chat.

Présentation de l'API Google Chat

L'API Chat se compose de services gRPC ou de ressources et méthodes REST qui permettent d'accéder à Chat, y compris aux espaces, aux membres des espaces, aux messages, aux réactions aux messages, aux pièces jointes des messages, aux événements des espaces et aux états de lecture des utilisateurs.

Concepts

La section suivante définit les services, les ressources et les méthodes de l'API Chat :

Espaces

Les espaces sont des lieux où les personnes et les applications peuvent discuter et partager des fichiers. Il existe plusieurs types d'espaces. Les messages privés (MP) sont des conversations individuelles entre deux utilisateurs ou entre un utilisateur et une application Chat. Les discussions de groupe sont des conversations entre trois utilisateurs ou plus et des applications Chat. Les espaces nommés sont des lieux persistants où les utilisateurs peuvent envoyer des messages, partager des fichiers et collaborer.

Référence de la ressource :

Pour obtenir un exemple d'utilisation, consultez :

Membres

Les membres sont des utilisateurs et des applications Chat qui ont rejoint un espace ou qui y ont été invités.

Référence de la ressource :

Pour obtenir un exemple d'utilisation, consultez :

Messages

Les messages incluent les communications textuelles et les communications sous forme de fiches publiées dans les espaces. Des fichiers peuvent être joints aux messages. Les utilisateurs peuvent réagir aux messages en y ajoutant des emoji.

Référence de la ressource :

Pour obtenir un exemple d'utilisation, consultez :

Réactions

Les réactions représentent les emoji que les utilisateurs utilisent pour réagir à un message, comme 👍, 🚲 et 🌞.

Référence de la ressource :

Pour obtenir un exemple d'utilisation, consultez :

Emoji personnalisés

Les emoji personnalisés représentent les emoji créés et partagés au sein de l'organisation dans Google Chat. Vous pouvez inclure des emoji personnalisés dans le contenu d'un message ou les utiliser pour réagir à un message.

Référence de la ressource :

Fichiers multimédias et pièces jointes

Média représente un fichier importé dans Google Chat, comme des images, des vidéos et des documents.

Référence de la ressource multimédia (non disponible dans RPC) :

Les pièces jointes sont des instances de contenus multimédias (fichiers) joints aux messages.

Référence de la ressource :

Pour obtenir un exemple d'utilisation, consultez :

Événements dans l'espace

Les événements d'espace représentent les modifications apportées à un espace ou à ses ressources enfants, y compris ses membres, ses messages et ses réactions.

Référence de la ressource :

Pour obtenir un exemple d'utilisation, consultez :

États de lecture des utilisateurs

Les états de lecture des utilisateurs sont des ressources singleton qui représentent des informations sur le dernier message lu par un utilisateur spécifié dans un espace Google Chat ou un fil de discussion.

Documentation de référence sur la ressource d'état de lecture de l'espace :

Documentation de référence sur la ressource d'état de lecture du thread :

Pour obtenir un exemple d'utilisation, consultez :

Paramètres de notification de l'espace utilisateur

Les paramètres de notification d'un espace utilisateur sont des ressources singleton qui représentent les paramètres de notification d'un utilisateur spécifique dans un espace Google Chat.

Référence de la ressource :

Authentification

L'appel de l'API Chat nécessite une authentification. Chaque méthode de l'API Chat nécessite une authentification de l'utilisateur (pour effectuer des actions ou accéder à des données pour le compte d'un utilisateur) ou une authentification de l'application (pour effectuer des actions ou accéder à des données en tant qu'application Chat). Certaines méthodes sont compatibles avec l'authentification des utilisateurs et des applications.

Pour en savoir plus sur l'authentification dans Chat, consultez Présentation de l'authentification.

Bibliothèques clientes

Pour la plupart des développeurs, la méthode recommandée pour appeler l'API Google Chat consiste à utiliser nos bibliothèques clientes Cloud officiellement compatibles pour le langage de votre choix, comme Python, Java ou Node.js.

Si vous codez avec Google Apps Script, utilisez le service Chat avancé au lieu d'installer une bibliothèque cliente.

Créer des applications Chat

L'API Chat vous permet de créer des applications Google Chat qui fournissent vos services et ressources directement dans Google Chat. Vous pouvez créer des applications Chat pour effectuer les opérations suivantes :

  • Récupérez des informations en fonction des requêtes structurées ou en texte libre saisies par l'utilisateur.
  • Générer des rapports d'incident ou d'autres artefacts à l'aide des informations fournies par l'utilisateur.
  • Améliorer la collaboration en équipe, par exemple en fournissant une "mémoire d'équipe" ou en planifiant des ressources.

Vous pouvez concevoir votre application Chat à l'aide de différents styles d'architecture, y compris les suivants :

  • Applications interactives : elles répondent aux interactions des utilisateurs, comme les @mentions ou les commandes à barre oblique, et présentent des informations ou guident les utilisateurs tout au long d'un workflow à l'aide de fiches et de boîtes de dialogue.
  • Applications en ligne de commande ou Webhooks : envoyez des messages proactifs, tels que des alarmes ou des notifications, depuis un autre système vers un espace. Les utilisateurs ne peuvent pas interagir directement avec ce type d'application.
  • Applications événementielles : abonnez-vous à l'activité d'un espace Chat et réagissez à celle-ci, par exemple lorsqu'un nouveau membre rejoint l'espace. En réponse à un événement, l'application peut envoyer un message ou effectuer une autre action.

Pour en savoir plus sur la conception de votre application Chat, consultez Choisir une architecture d'application Google Chat.

Vous souhaitez voir l'API Google Chat en action ?
La chaîne YouTube Google Workspace Developers propose des vidéos sur des conseils, des astuces et les dernières fonctionnalités.