Cette section explique comment une application Google Chat peut appeler l'API Chat, qui permet aux applications Chat d'effectuer des actions telles que créer un espace, y ajouter des personnes et publier un message.
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 aux données au nom d'un utilisateur) ou une 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.
Bibliothèques clientes
La plupart des développeurs appellent l'API Google Chat à l'aide de 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.
Concepts de l'API Google Chat
Les services gRPC ou les ressources et méthodes REST accordent l'accès aux espaces Chat, aux membres des espaces, aux messages, aux réactions aux messages, aux pièces jointes aux messages, aux événements des espaces et aux états de lecture des utilisateurs.
- Espaces
Les espaces sont des lieux où les utilisateurs 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 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 peuvent envoyer des messages, partager des fichiers et collaborer.
Référence de la ressource:
Pour voir un exemple d'utilisation, consultez les articles suivants:
- Membres
Les membres sont les utilisateurs et les applications Chat qui ont rejoint un espace ou y ont été invités.
Référence de la ressource:
Pour voir un exemple d'utilisation, consultez les articles suivants:
- Messages
Les messages incluent les communications par texte et fiche publiées dans les espaces. Vous pouvez joindre des fichiers aux messages. Les utilisateurs peuvent réagir aux messages en y ajoutant des emoji.
Référence de la ressource:
Pour voir un exemple d'utilisation, consultez les articles suivants:
- 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 voir un exemple d'utilisation, consultez les articles suivants:
- Emoji personnalisés (version Preview développeur)
Les emoji personnalisés sont des 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:
- Contenu multimédia et pièces jointes
Multimé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 les RPC):
Les pièces jointes sont des instances de contenus multimédias (fichiers) joints aux messages.
Référence de la ressource:
Pour voir un exemple d'utilisation, consultez les articles suivants:
- Événements spatiaux
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 voir un exemple d'utilisation, consultez les articles suivants:
- États de lecture des utilisateurs
Les états de lecture de l'utilisateur 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.
Référence de la ressource d'état de lecture de l'espace:
Référence de la ressource d'état de lecture du thread:
Pour voir un exemple d'utilisation, consultez les articles suivants:
- Paramètres de notification de l'espace utilisateur (version Preview développeur)
Les paramètres de notification de l'espace utilisateur sont des ressources singleton qui représentent des paramètres de notification utilisateur spécifiés dans un espace Google Chat.
Référence de la ressource:
Articles associés
- Explorez les exemples d'applications Google Chat pour commencer à utiliser l'API Chat.
En plus d'appeler l'API Chat, les applications Chat peuvent également:
- Recevoir et répondre aux événements d'interaction de l'application Chat, comme les messages envoyés à l'application Google Chat, en temps réel.
- Abonnez-vous aux événements Google Chat pour prendre des mesures ou répondre lorsque certaines activités ou modifications se produisent dans Chat, comme de nouveaux messages et des modifications de membres.