Cette section explique comment une application Google Chat peut appeler L'API Chat, qui permet aux applications Chat d'effectuer les opérations suivantes : créer un espace, y ajouter des personnes et publier un message sans ê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 La méthode de l'API Chat requiert authentification utilisateur (pour effectuer des actions ou accéder données au nom d'un utilisateur) ou authentification des applications (pour effectuer des actions ou accéder aux données en tant qu'application Chat). Un peu prennent en charge à la fois l'authentification des utilisateurs et l'authentification des applications.
Pour en savoir plus sur l'authentification dans Chat, consultez Présentation de l'authentification
Ressources et méthodes de l'API
Les ressources et méthodes REST accordent un accès asynchrone à Chat les espaces, les membres de l'espace, les messages, les réactions aux messages et les pièces jointes aux messages.
- Espaces
Les espaces sont des endroits où les utilisateurs et les applications peuvent discuter et partager des fichiers. Il y plusieurs types d'espaces. Les messages privés (MP) sont des conversations individuelles entre deux utilisateurs ou un utilisateur et une application Chat. Groupe les chats sont des conversations entre trois utilisateurs ou plus et Applications de chat Les espaces nommés sont des emplacements persistants des messages, de partager des fichiers et de collaborer.
La Ressource
spaces
représente un espace.Les espaces acceptent les méthodes suivantes:
- créer un espace ; un endroit où les utilisateurs et les applications peuvent discuter et partager des fichiers.
- Configurer un espace pour créer l'espace, et y ajouter des personnes et des applications Chat l'espace de stockage.
- Obtenir un espace pour en savoir plus sur un espace.
- Lister les espaces pour afficher une liste paginée et filtrable d'espaces.
- Modifier un espace pour modifier les attributs d'un espace, comme son nom à afficher visible par l'utilisateur, une description et des directives.
- Supprimer un espace lorsque vous n'en avez plus besoin.
- Rechercher un message privé (MP) pour renvoyer un MP entre deux utilisateurs, ou un MP entre un utilisateur et l'appelant Applications de chat
- Membres
Les membres sont les utilisateurs et les applications Chat qui ont rejoint le groupe ou qui sont invité à un espace.
La Ressource
spaces.members
représente un membre.Les membres acceptent les méthodes suivantes:
- Créer un abonnement pour ajouter un utilisateur ou une application à un espace.
- Souscrire un abonnement pour en savoir plus sur l'abonnement.
- Adhésions aux listes pour afficher une liste paginée et filtrable des membres d'un espace.
- Modifier un abonnement pour modifier les attributs d'un membre, comme attribuer gestionnaire de l'espace, ou la désignation d'un gestionnaire de l'espace en membre de l'espace.
- Supprimer un abonnement pour exclure un utilisateur ou une application d'un espace.
- Messages
Éléments inclus dans la section Messages texte et carte communications publiées dans les espaces. Les messages peuvent être associés à 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:
- Créer un message pour publier un texte ou fiche. Vous pouvez également démarrer un fil de discussion ou y répondre.
- Recevoir un message pour obtenir des informations sur un message, comme sa date d'envoi ou ce qu'il contient.
- Lister les messages pour afficher une liste paginée et filtrable des messages d'un espace.
- Modifier un message pour modifier les attributs d'un message, par exemple ce qu'il dit. Vous pouvez également ajouter du texte à un message sous forme de fiche, ou une carte à un SMS.
- Supprimer un message lorsque vous n'en avez plus besoin.
- Réactions
Les réactions représentent les emoji que les utilisateurs utilisent pour réagir à un message, par exemple 👍, Migrez et 🌴.
La Ressource
spaces.messages.reactions
représente une réaction.Les réactions sont compatibles avec les méthodes suivantes:
- Créer une réaction pour ajouter un emoji à un message.
- Lister les réactions pour afficher une liste paginée et filtrable des réactions à un message.
- Supprimer une réaction pour supprimer un emoji du message.
- Contenus multimédias et pièces jointes
Contenu multimédia : représente un fichier importé dans Google Chat, comme des images, des vidéos et documents.
La Ressource
media
représente les fichiers multimédias joints aux messages.Les pièces jointes sont des instances de contenus multimédias (fichiers) joints à des messages.
La Ressource
spaces.messages.attachments
représente une pièce jointe. La pièce jointe inclut le contenu multimédia et les fichiers des métadonnées associées à un message.Les fichiers multimédias et les pièces jointes sont compatibles avec les méthodes suivantes:
- Importer un contenu multimédia en tant que pièce jointe pour importer du contenu multimédia dans Google Chat, puis le joindre à un message.
- Télécharger du contenu multimédia en pièce jointe pour télécharger des contenus multimédias depuis Google Chat au format binaire.
- Obtenir une pièce jointe pour récupérer les métadonnées relatives à la pièce jointe d'un message.
- Événements de l'espace
Les événements d'espace représentent les modifications apportées à un espace ou à ses les ressources enfants, y compris ses membres, ses messages et ses réactions.
La ressource
spaces.spaceEvent
représente un événement spatial.Les événements d'espace sont compatibles avec les méthodes suivantes:
- Réserver un événement dans l'espace pour renvoyer les détails d'un événement qui s'est produit dans un espace.
- Répertorier les événements de l'espace pour obtenir la liste des événements qui se sont produits dans un espace.
- États de lecture par l'utilisateur
Les états de lecture de l'utilisateur sont des ressources singleton qui représentent les détails d'un le dernier message lu par l'utilisateur spécifié dans un espace Google Chat ou un message thread.
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 de l'utilisateur sont compatibles avec les méthodes suivantes:
- Obtenir l'état de lecture de l'espace pour renvoyer des détails sur l'état de lecture d'un utilisateur dans un espace.
- Mettre à jour l'état de lecture d'un espace pour mettre à jour l'état de lecture d'un utilisateur dans un espace.
- Obtenir l'état de lecture du fil de discussion pour renvoyer des détails sur l'état de lecture d'un utilisateur dans un thread.