Method: users.spaces.threads.updateThreadReadState

Met à jour l'état de lecture d'un utilisateur dans un fil de discussion, utilisé pour identifier les messages lus et non lus. Pour obtenir un exemple, consultez Mettre à jour l'état de lecture d'un fil de discussion par un utilisateur.

Nécessite l'authentification de l'utilisateur avec le champ d'application d'autorisation :

  • https://www.googleapis.com/auth/chat.users.readstate

Requête HTTP

PATCH https://chat.googleapis.com/v1/{threadReadState.name=users/*/spaces/*/threads/*/threadReadState}

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
threadReadState.name

string

Nom de ressource de l'état de lecture du fil de discussion.

Format : users/{user}/spaces/{space}/threads/{thread}/threadReadState

Paramètres de requête

Paramètres
updateMask

string (FieldMask format)

Obligatoire. Chemins d'accès aux champs à mettre à jour. Chemins de champ actuellement acceptés :

  • lastReadTime

Lorsque lastReadTime est antérieur à l'heure de création du dernier message, le fil de discussion apparaît comme non lu dans l'interface utilisateur.

Pour marquer le fil de discussion comme lu, définissez lastReadTime sur un code temporel égal ou postérieur à l'heure de création du dernier message. Les codes temporels futurs sont forcés à l'heure de la requête actuelle. La définition d'un code temporel négatif (avant 1970-01-01T00:00:00Z) renvoie une erreur INVALID_ARGUMENT.

Corps de la requête

Le corps de la requête contient une instance de ThreadReadState.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de ThreadReadState.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/chat.users.readstate

Pour en savoir plus, consultez le guide d'autorisation.