Ce guide explique comment utiliser le
get()
sur la ressource ThreadReadState
de l'API Google Chat pour obtenir des détails
sur l'état de lecture d'un utilisateur
dans une conversation. Pour obtenir l'état de lecture d'un
message dans un espace, consultez
Obtenez des détails sur l'état de lecture d'un espace utilisateur.
La
Ressource ThreadReadState
est une ressource singleton qui représente les détails d'une
le dernier message lu par l'utilisateur spécifié dans un fil de discussion Google Chat.
Prérequis
Node.js
- Une entreprise Un compte Google Workspace ayant accès à Google Chat :
- Configurez votre environnement :
- Créez un projet Google Cloud.
- Configurez l'écran de consentement OAuth.
- Activez et configurez l'API Google Chat avec un nom, une icône et une description pour votre application Chat.
- Installez la bibliothèque cliente Cloud Node.js.
- Créez des identifiants d'ID client OAuth pour une application de bureau. Pour exécuter l'exemple
enregistrez les identifiants dans un fichier JSON nommé
client_secrets.json
dans votre fichier dans votre répertoire local.
- <ph type="x-smartling-placeholder"></ph> Choisissez un niveau d'autorisation compatible avec l'authentification des utilisateurs.
Obtenir l'état de lecture du thread de l'utilisateur appelant
Pour obtenir des informations sur l'état de lecture d'un utilisateur dans une conversation, incluez le paramètre dans votre demande:
- Spécifiez le champ d'application d'autorisation
chat.users.readstate
ouchat.users.readstate.readonly
. - Appelez la méthode
GetThreadReadState()
, en transmettant lename
de l'état de lecture du thread à récupérer, qui inclut un un identifiant d'utilisateur ou un alias et un identifiant d'espace. L'obtention de l'état de lecture du thread n'est compatible qu'avec l'obtention de l'état de lecture de l'utilisateur appelant, qui peut être spécifié en définissant l'un des éléments suivants :- L'alias
me
. Exemple :users/me/spaces/SPACE/threads/THREAD/threadReadState
. - Adresse e-mail Workspace de l'utilisateur appelant. Par exemple :
users/user@example.com/spaces/SPACE/threads/THREAD/threadReadState
. - ID utilisateur de l'utilisateur appelant. Par exemple :
users/USER/spaces/SPACE/threads/THREAD/threadReadState
.
- L'alias
L'exemple suivant récupère l'état de lecture du thread de l'utilisateur appelant:
Node.js
Pour exécuter cet exemple, remplacez les éléments suivants :
SPACE_NAME
: ID du tagname
Vous pouvez obtenir l'ID en appelant la méthodeListSpaces()
ou à partir de l'URL de l'espace.THREAD_NAME
: ID de l'name
du thread. Vous pouvez obtenir l'ID à partir du corps de la réponse renvoyé après avoir créé une de manière asynchrone avec l'API Chat ou avec le nom personnalisé attribué au message lors de sa création.
L'API Google Chat obtient l'état de lecture du thread spécifié et renvoie
une instance de
ThreadReadState
Articles associés
- Mettez à jour l'état de lecture de l'espace de l'utilisateur appelant.
- Obtenez l'état de lecture de l'espace de l'utilisateur appelant.