获取有关 Google Chat 聊天室活动的详细信息

本指南介绍了如何对 Google Chat API 的 SpaceEvent 资源使用 get() 方法，从 Google Chat 聊天室获取有关事件的详细信息。

通过 SpaceEvent 资源 表示对聊天室或其子资源（例如消息、 回应和会员功能如需了解支持的事件类型，请参阅 SpaceEvent 资源的 eventType 字段参考文档。

您最多可以比请求时间提前 28 天请求活动。该事件包含发生更改的资源的最新版本。例如，如果您请求有关新消息的事件，但该消息后来被更新了，服务器会在事件载荷中返回更新后的 Message 资源。

如需调用此方法，您必须使用用户身份验证。如需获取事件，经过身份验证的用户必须是发生事件的聊天室的成员。

前提条件

Node.js

<ph type="x-smartling-placeholder">

获取有关聊天室活动的详细信息

如需在 Google Chat 中获取有关聊天室活动的详细信息，请将以下内容传递给 请求：

  • 在请求中指定支持相应事件类型的授权范围。最佳做法是，选择仍然允许您的 才能正常运行。
  • 调用 GetSpaceEvent() 方法，传递要获取的空间事件的 name。

以下示例获取了一个聊天室事件：

Node.js

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

// Replace SCOPE_NAME here with an authorization scope based on the event type
const USER_AUTH_OAUTH_SCOPES = ['SCOPE_NAME'];

// This sample shows how to get space event with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME and SPACE_EVENT_NAME here
    name: 'spaces/SPACE_NAME/spaceEvents/SPACE_EVENT_NAME'
  };

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

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

main().catch(console.error);

如需运行此示例，请替换以下内容：

  • SCOPE_NAME：基于 事件类型。例如，如果您要接收聊天室活动 有关新成员资格，请使用 chat.memberships.readonly 范围， 格式为 https://www.googleapis.com/auth/chat.memberships.readonly。 您可以从 ListSpaceEvents() 方法。如需了解如何使用此方法，请参阅 列出聊天室中的活动。
  • SPACE_NAME：聊天室的 ID name。 可通过调用 ListSpaces() 方法或聊天室的网址来执行此操作。
  • SPACE_EVENT_NAME：聊天室活动的 ID name。 您可以从 ListSpaceEvents() 方法。如需了解如何使用此方法，请参阅 列出聊天室中的活动。

Chat API 会返回 SpaceEvent 活动详情