Method: spaces.members.create

為通話 Chat 應用程式、使用者或 Google 群組建立成員資格。目前不支援為其他 Chat 應用程式建立成員資格。建立成員時，如果指定成員關閉了自動接受政策，系統會傳送邀請給對方，且對方必須接受邀請才能加入。否則，建立成員資格會直接將成員新增至指定聊天室。

支援下列類型的驗證：

  • 應用程式驗證 (須經管理員核准)，授權範圍如下：

    • https://www.googleapis.com/auth/chat.app.memberships

  • 使用者驗證，並使用下列其中一個授權範圍：

    • https://www.googleapis.com/auth/chat.memberships
    • https://www.googleapis.com/auth/chat.memberships.app (將通話應用程式加入聊天室)
    • https://www.googleapis.com/auth/chat.import (僅限匯入模式聊天室)
    • 使用者驗證會在管理員帳戶通過驗證時授予管理員權限，useAdminAccess 為 true，且使用下列授權範圍：
      • https://www.googleapis.com/auth/chat.admin.memberships

應用程式驗證不支援下列用途：

  • 邀請不屬於聊天室所屬 Workspace 機構的使用者。
  • 將 Google 群組新增至聊天室。
  • 將 Chat 應用程式新增至聊天室。

如需使用範例，請參閱：

HTTP 要求

POST https://chat.googleapis.com/v1/{parent=spaces/*}/members

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

必要欄位。要建立成員的空間資源名稱。

格式：spaces/{space}

查詢參數

參數
useAdminAccess

boolean

(選用步驟) 時，這個方法會使用使用者的 Google Workspace 管理員權限執行。true

通話使用者必須是具備「管理即時通訊和聊天室對話」權限的 Google Workspace 管理員。

需要 chat.admin.memberships OAuth 2.0 範圍。

管理員無法使用管理員存取權，為應用程式建立成員資格，或為管理員 Google Workspace 機構以外的使用者建立成員資格。

要求主體

要求主體包含 Membership 的例項。

回應主體

如果成功，回應主體會包含新建立的 Membership 例項。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.app

詳情請參閱授權指南。