Method: spaces.members.create

為通話應用程式建立一般成員或應用程式成員資格。系統不支援為其他應用程式建立會員資格。如需範例，請參閱「邀請/在聊天室中邀請/新增使用者或 Google Chat 應用程式」。建立成員時，如果指定成員關閉了自動接受政策，系統會向他們發出邀請，且必須先接受邀請才能加入。否則，當您建立成員資格時，系統會將成員直接新增至指定聊天室。需要使用者驗證。

如要指定要新增的成員，請設定人類或應用程式成員的 membership.member.name，或為群組成員設定 membership.group_member.name。

  • 如要將呼叫應用程式新增至聊天室，或兩位真人使用者之間的即時訊息，請使用 users/app。無法將其他應用程式新增至聊天室。

  • 如要新增真人使用者，請使用 users/{user}，其中 {user} 可以是使用者的電子郵件地址。對於同一個 Workspace 機構 ({user}) 中的使用者，您也可以為 People API 中的使用者設定 id，或是在 Directory API 中為使用者設定 id。舉例來說，如果 user@example.com 的 People API 個人資料 ID 為 123456789，您可以將 membership.member.name 設為 users/user@example.com 或 users/123456789，將使用者新增至聊天室。

  • 如要在已命名聊天室中新增或邀請 Google 群組，請使用 groups/{group}，其中 {group} 是 Cloud Identity Groups API 中的群組 id。舉例來說，您可以使用 Cloud Identity Groups lookup API 擷取群組電子郵件地址 group@example.com 的 ID 123456789，然後將 membership.group_member.name 設為 groups/123456789，藉此新增或邀請群組加入已命名的聊天室。系統不支援群組電子郵件，而且您只能在已命名的聊天室中將 Google 群組新增為成員。

HTTP 要求

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

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

路徑參數

參數
parent

string

必要欄位。要建立成員資格的聊天室資源名稱。

格式：space/{space}

查詢參數

參數
useAdminAccess

boolean

為 true 時，此方法會使用使用者的 Google Workspace 管理員權限執行。

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

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

系統不支援使用管理員存取權為非管理員 Google Workspace 機構的使用者建立應用程式成員資格，或是為這類使用者建立成員資格。

要求主體

要求主體包含 Membership 的例項。

回應主體

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

授權範圍

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

  • 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

詳情請參閱授權指南。