Method: spaces.members.create

為通話應用程式建立使用者成員資格或應用程式成員資格。系統不支援為其他應用程式建立會員功能。如需範例,請參閱「邀請使用者或 Google Chat 應用程式加入聊天室」。建立成員資格時,如果指定成員已關閉自動接受政策,他們便會收到邀請,且必須接受聊天室邀請才能加入。否則,建立成員資格後,系統會將該成員直接加入指定聊天室。必須完成使用者驗證

如要指定要新增的成員,請為人員或應用程式成員設定 membership.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.comusers/123456789,將使用者新增至聊天室。

HTTP 要求

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

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

路徑參數

參數
parent

string

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

格式:空格/{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

詳情請參閱授權指南