取得 Google Chat 聊天室活動的詳細資料

本指南將說明如何使用 get() 方法,SpaceEventGoogle Chat API 資源中的 方法,以取得詳細資訊 找出 Google Chat 聊天室中的活動。

SpaceEvent 項資源 代表聊天室或其子項資源 (例如訊息) 的變更 回應及會員資格如要瞭解支援的事件類型,請參閱 SpaceEvent 資源的 eventType 欄位 參考文件

您最早可以在要求時間的 28 天前要求事件。事件 包含已變更資源的最新版本。舉例來說,如果您要求有關新訊息的事件,但該訊息稍後已更新,伺服器會在事件酬載中傳回已更新的 Message 資源。

如要呼叫這個方法,您必須使用 使用者驗證。若要取得 已驗證的使用者必須是活動聊天室成員 。

必要條件

Node.js

取得聊天室活動的詳細資料

如要取得 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:聊天室 name 的 ID。您可以呼叫 ListSpaces() 方法,或從空間的網址取得 ID。
  • SPACE_EVENT_NAME:聊天室事件的 ID name。 您可以從 ListSpaceEvents() 方法取得 ID。如要瞭解如何使用這個方法,請參閱「列出聊天室中的事件」。

Chat API 會傳回 SpaceEvent 並附上活動詳情