Method: users.spaces.updateSpaceReadState

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

Nécessite l'authentification des utilisateurs avec le champ d'application d'autorisation:

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

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
spaceReadState.name

string

Nom de la ressource de l'état de lecture de l'espace.

Format : users/{user}/spaces/{space}/spaceReadState

Paramètres de requête

Paramètres
updateMask

string (FieldMask format)

Obligatoire. Chemins de champ à mettre à jour. Chemins de champ actuellement acceptés:

  • lastReadTime

Lorsque la date de création de l'lastReadTime est antérieure à celle du dernier message, l'espace apparaît comme non lu dans l'interface utilisateur.

Pour marquer l'espace comme lu, définissez lastReadTime sur une valeur ultérieure (supérieure) à la date de création du dernier message. lastReadTime est forcé à correspondre à la dernière heure de création du message. Notez que l'état de lecture de l'espace ne concerne que l'état de lecture des messages visibles dans la conversation de niveau supérieur de l'espace. Ce code temporel n'a aucune incidence sur les réponses dans les fils de discussion, qui dépendent plutôt de l'état de lecture du fil.

Corps de la requête

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

Corps de la réponse

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

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.