Développer avec Google Chat

Cette page présente un aperçu de l'API Google Chat et des applications Google Chat.

Présentation de l'API Google Chat

L'API Chat se compose de services gRPC ou de ressources et de 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 d'espace 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 emplacements 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 privées 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 emplacements persistants où les utilisateurs envoient des messages, partagent des fichiers et collaborent.

Référence de la ressource :

Un exemple d'utilisation se trouve ci-dessous :

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 :

Un exemple d'utilisation se trouve ci-dessous :

Messages

Les messages incluent les communications textuelles et les 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 :

Un exemple d'utilisation se trouve ci-dessous :

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 :

Un exemple d'utilisation se trouve ci-dessous :

Emoji personnalisés

Les emoji personnalisés représentent les emoji personnalisés créés et partagés au sein de l'organisation dans Google Chat. Les emoji personnalisés peuvent être inclus dans le contenu d'un message ou utilisés pour réagir à un message.

Référence de la ressource :

Un exemple d'utilisation se trouve ci-dessous :

Sections

Les sections permettent aux utilisateurs de regrouper leurs conversations et de personnaliser la liste des espaces affichés dans le panneau de navigation Google Chat. Il existe des sections système prédéfinies et des sections personnalisées définies par l'utilisateur.

Référence de la ressource :

Un exemple d'utilisation se trouve ci-dessous :

Contenus multimédias et pièces jointes

Les contenus multimédias représentent 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 à des messages.

Référence de la ressource :

Un exemple d'utilisation se trouve ci-dessous :

Événements d'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 :

Un exemple d'utilisation se trouve ci-dessous :

É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 d'un utilisateur spécifié dans un espace Google Chat ou un fil de discussion.

Référence de la ressource d'état de lecture d'un espace :

Référence de la ressource d'état de lecture d'un fil de discussion :

Un exemple d'utilisation se trouve ci-dessous :

Paramètres de notification d'espace utilisateur

Les paramètres de notification d'espace utilisateur sont des ressources singleton qui représentent les paramètres de notification d'un utilisateur spécifié 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 au nom 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 de l'utilisateur et l'authentification de l'application.

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

Bibliothèques clientes

Pour la plupart des développeurs, le moyen recommandé d'appeler l'API Google Chat consiste à utiliser nos bibliothèques clientes Cloud officiellement compatibles avec 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 vos ressources directement dans Google Chat. Vous pouvez créer des applications Chat pour effectuer les opérations suivantes :

  • Récupérer des informations en fonction de requêtes textuelles structurées ou libres 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 plusieurs styles d'architecture différents, y compris les suivants :

  • Applications interactives : répondez à l'interaction de l'utilisateur, par exemple aux @mentions ou aux commandes à barre oblique, et présentez des informations ou guidez les utilisateurs dans un workflow à l'aide de fiches et de boîtes de dialogue.
  • Applications de ligne de commande ou webhooks : envoyez des messages proactifs, tels que des alarmes ou des notifications, d'un autre système vers un espace. Les utilisateurs ne peuvent pas interagir directement avec ce type d'application.
  • Applications basées sur des événements : abonnez-vous à l'activité d'un espace Chat et réagissez-y, 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 contenant des conseils, astuces et des informations sur les dernières fonctionnalités.