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

В этом руководстве объясняется, как использовать метод 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/[email protected]/spaces/ SPACE /threads/ THREAD /threadReadState .
    • Идентификатор пользователя вызывающего пользователя. Например, users/ USER /spaces/ SPACE /threads/ THREAD /threadReadState .

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

Node.js

чат/клиент-библиотеки/облако/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 потока. Вы можете получить идентификатор из тела ответа, возвращенного после асинхронного создания сообщения с помощью Chat API, или с помощью пользовательского имени, назначенного сообщению при создании.

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