此页面由 Cloud Translation API 翻译。

更新用户聊天室的读取状态

本指南介绍了如何对 Google Chat API 的 SpaceReadState 资源使用 update() 方法将聊天室标记为已读或未读。

通过 SpaceReadState 资源是一种单例资源，指定用户最近在 Google Chat 聊天室中阅读的消息。

前提条件

Node.js

拥有对 Google Chat 访问权限的商务版或企业版 Google Workspace 账号。

设置环境：
- 创建 Google Cloud 项目。
- 配置 OAuth 同意屏幕。
- 启用和配置 Google Chat API，为 Chat 应用提供名称、图标和说明。
- 安装 Node.js Cloud 客户端库。
- 为桌面应用创建 OAuth 客户端 ID 凭据。为了运行此示例中的示例，指南中，将凭据保存为名为 client_secrets.json 的 JSON 文件，本地目录中。
如需相关指导，请完成此快速入门中关于设置环境的步骤。
<ph type="x-smartling-placeholder"></ph> 选择支持用户身份验证的授权范围。

更新发起调用的用户的聊天室读取状态

如需在聊天室中更新用户的读取状态，请将以下代码添加到您的请求：

指定 chat.users.readstate 授权范围。
调用 UpdateSpaceReadState() 方法。
传递值为 lastReadTime 的 updateMask。
将 spaceReadState 作为 SpaceReadState 替换为以下内容：
- 将 name 字段设置为要更新的聊天室读取状态，其中包含用户 ID 或别名和聊天室 ID。仅支持更新聊天室读取状态更新发起调用的用户的读取状态，这可以通过设置以下任一选项： <ph type="x-smartling-placeholder">
  - me 别名。例如 users/me/spaces/SPACE/spaceReadState。
  - 发起调用的用户的 Workspace 电子邮件地址。例如，users/user@example.com/spaces/SPACE/spaceReadState。
  - 发起调用的用户的用户 ID。例如，users/USER/spaces/SPACE/spaceReadState。
- lastReadTime 字段设置为更新用户聊天室读取状态的时间的更新值。通常，此值与上次读取的消息的时间戳相对应，或者是用户指定的时间戳，用于标记聊天室中上次读取的位置。如果 lastReadTime 早于最新消息的创建时间，聊天室会在界面中显示为未读。如需将聊天室标记为已读，请将 lastReadTime 设置为晚于（大于）最新消息创建时间的任何值。系统会强制将 lastReadTime 设为与最新消息创建时间一致。请注意，聊天室读取状态只会影响聊天室顶级对话中显示的消息的读取状态。会话中的回复不会受此时间戳影响，而是取决于会话读取状态。

以下示例会更新发起调用的用户的空间读取状态：

Node.js

chat/client-libraries/cloud/update-space-read-state-user-cred.js

在 GitHub 上查看

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);
}

main().catch(console.error);

如需运行此示例，请将 SPACE_NAME 替换为聊天室的 name 中的 ID。可通过调用 ListSpaces() 方法或聊天室的网址来执行此操作。

Google Chat API 会更新指定的聊天室读取状态并返回实例 SpaceReadState。

更新用户聊天室的读取状态

前提条件

Node.js

更新发起调用的用户的聊天室读取状态

Node.js

相关主题