Mettre à jour l'état de lecture d'un espace utilisateur

Ce guide explique comment utiliser la update() méthode sur la ressource SpaceReadState de l'API Google Chat pour marquer des espaces comme lus ou non lus.

La ressource SpaceReadState ressource est une ressource singleton qui représente des informations sur le dernier message lu d'un utilisateur spécifié dans un espace Chat Google.

Prérequis

Node.js

Mettre à jour l'état de lecture de l'espace de l'utilisateur appelant

Pour mettre à jour l'état de lecture d'un utilisateur dans un espace, incluez les éléments suivants dans votre requête :

  • Spécifiez le champ d'application d'autorisation chat.users.readstate.
  • Appelez la UpdateSpaceReadState() méthode.
  • Transmettez updateMask avec la valeur lastReadTime.
  • Transmettez spaceReadState en tant qu'instance de SpaceReadState avec les éléments suivants :
    • Le champ name défini sur l'état de lecture de l'espace à mettre à jour, qui inclut un ID utilisateur ou un alias et un ID d'espace. La mise à jour de l'état de lecture de l'espace ne permet de mettre à jour que 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. Par exemple, users/me/spaces/SPACE/spaceReadState.
      • L'adresse e-mail Workspace de l'utilisateur appelant. Par exemple, users/user@example.com/spaces/SPACE/spaceReadState.
      • L'ID utilisateur de l'utilisateur appelant. Par exemple, users/USER/spaces/SPACE/spaceReadState.
    • Le champ lastReadTime défini sur la valeur mise à jour de l'heure à laquelle l'état de lecture de l'espace de l'utilisateur a été mis à jour. En règle générale, cela correspond à l'horodatage du dernier message lu ou à un horodatage spécifié par l'utilisateur pour marquer la dernière position de lecture dans un espace. Lorsque lastReadTime est antérieur à l'heure de création 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) à l'heure de création du dernier message. lastReadTime est forcé pour correspondre à l'heure de création du dernier message. Notez que l'état de lecture de l'espace n'affecte que l'état de lecture des messages visibles dans la conversation de premier niveau de l'espace. Les réponses dans les fils de discussion ne sont pas affectées par cet horodatage et dépendent plutôt de l'état de lecture du fil de discussion.

L'exemple suivant met à jour l'état de lecture de l'espace de l'utilisateur appelant :

Node.js

chat/client-libraries/cloud/update-space-read-state-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = [
  'https://www.googleapis.com/auth/chat.users.readstate',
];

// This sample shows how to update a space read state for the calling user
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(
    USER_AUTH_OAUTH_SCOPES,
  );

  // Initialize request argument(s)
  const timestamp = new Date('2000-01-01').getTime();
  const request = {
    spaceReadState: {
      // Replace SPACE_NAME here
      name: 'users/me/spaces/SPACE_NAME/spaceReadState',
      lastReadTime: {
        seconds: Math.floor(timestamp / 1000),
        nanos: (timestamp % 1000) * 1000000,
      },
    },
    updateMask: {
      // The field paths to update.
      paths: ['last_read_time'],
    },
  };

  // Make the request
  const response = await chatClient.updateSpaceReadState(request);

  // Handle the response
  console.log(response);
}

await main();

Pour exécuter cet exemple, remplacez SPACE_NAME par l'ID de l'espace's name. Vous pouvez obtenir l'ID en appelant la ListSpaces() méthode ou à partir de l'URL de l'espace.

L'API Google Chat met à jour l'état de lecture de l'espace spécifié et renvoie une instance de SpaceReadState.