Présentation de l'API Google Chat

Cette section explique comment une application Google Chat peut appeler l'API Chat, ce qui permet aux applications Chat de créer un espace, d'y ajouter des personnes et de publier un message sans y être invité par un événement d'interaction avec l'application Chat.

Authentification

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

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

Ressources et méthodes de l'API

Les ressources et méthodes REST accordent un accès asynchrone aux espaces Chat et aux membres d'un espace, ainsi qu'aux messages, aux réactions aux messages et aux pièces jointes aux messages.

Espaces

Les espaces sont des endroits 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 1:1 entre deux utilisateurs, ou un utilisateur, et une application Chat. Les chats de groupe sont des conversations entre trois utilisateurs ou plus et des applications Chat. Les espaces nommés sont des espaces persistants où les utilisateurs envoient des messages, partagent des fichiers et collaborent.

La ressource spaces représente un espace.

Les espaces sont compatibles avec les méthodes suivantes:

Membres

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

La ressource spaces.members représente un membre.

Les membres acceptent les méthodes suivantes:

Messages

Les messages incluent des communications textuelles et par cartes publiées dans les espaces. Les messages peuvent être joints à des fichiers. Les utilisateurs peuvent réagir aux messages en y ajoutant des emoji.

La ressource spaces.messages représente un message.

Les messages sont compatibles avec les méthodes suivantes:

Réactions

Les réactions représentent les emoji utilisés par les internautes pour réagir à un message, par exemple 👍, 💌 et 😂.

La ressource spaces.messages.reactions représente une réaction.

Les réactions sont compatibles avec les méthodes suivantes:

Contenus multimédias et pièces jointes

Le terme contenu multimédia désigne un fichier importé dans Google Chat, par exemple des images, des vidéos et des documents.

La ressource media représente le contenu multimédia joint aux messages.

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

La ressource spaces.messages.attachments représente un rattachement. Une pièce jointe inclut le contenu multimédia et les métadonnées associées associées à un message.

Les éléments multimédias et les pièces jointes sont compatibles avec les méthodes suivantes:

Événements d'espaces

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.

La ressource spaces.spaceEvent représente un événement d'espace.

Les événements d'espace sont compatibles avec les méthodes suivantes:

États de lecture des utilisateurs (preview développeur)

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

La ressource users.spaces représente l'état de lecture d'un utilisateur dans un espace.

La ressource users.spaces.threads représente l'état de lecture d'un utilisateur dans un fil de discussion.

Les états de lecture utilisateur sont compatibles avec les méthodes suivantes: