Получение подробной информации о состоянии чтения потока пользователя.

В этом руководстве объясняется, как использовать метод get() ресурса ThreadReadState API Google Chat для получения сведений о состоянии чтения сообщения пользователем в потоке сообщений. Чтобы получить сведения о состоянии чтения сообщения в чат-группе, см . раздел Получение сведений о состоянии чтения сообщения в чат-группе пользователя .

Ресурс ThreadReadState — это одноэлементный ресурс, который представляет сведения о последнем прочитанном сообщении указанного пользователя в ветке сообщений Google Chat.

Предпосылки

Node.js

Получить состояние чтения потока вызывающего пользователя

Чтобы получить сведения о состоянии прочтения сообщения пользователем в цепочке сообщений, включите в свой запрос следующее:

  • Укажите область авторизации chat.users.readstate или chat.users.readstate.readonly .
  • Вызовите метод GetThreadReadState() , передав name состояния чтения потока, которое нужно получить, включая идентификатор пользователя или псевдоним и идентификатор пространства. Получение состояния чтения потока поддерживает только получение состояния чтения вызывающего пользователя, которое можно указать, установив один из следующих параметров:
    • Псевдоним me . Например, users/me/spaces/ SPACE /threads/ THREAD /threadReadState .
    • Адрес электронной почты Workspace вызывающего пользователя. Например, users/user@example.com/spaces/ SPACE /threads/ THREAD /threadReadState .
    • Идентификатор вызывающего пользователя. Например, users/ USER /spaces/ SPACE /threads/ THREAD /threadReadState .

В следующем примере получается состояние чтения потока вызывающего пользователя:

Node.js

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

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

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

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME and THREAD_NAME here
    name: 'users/me/spaces/SPACE_NAME/threads/THREAD_NAME/threadReadState',
  };

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

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

main().catch(console.error);

Чтобы запустить этот пример, замените следующее:

  • SPACE_NAME : идентификатор из name пространства. Идентификатор можно получить, вызвав метод ListSpaces() или указав URL пространства.
  • THREAD_NAME : идентификатор из name потока. Идентификатор можно получить из тела ответа, возвращаемого после асинхронного создания сообщения с помощью API чата, или с помощью пользовательского имени, назначенного сообщению при его создании.

API Google Chat получает указанное состояние чтения потока и возвращает экземпляр ThreadReadState .