為通話應用程式建立一般成員或應用程式成員資格。系統不支援為其他應用程式建立會員資格。如需範例,請參閱「邀請/在聊天室中邀請/新增使用者或 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
的 ID123456789
,然後將membership.group_member.name
設為groups/123456789
,藉此新增或邀請群組加入已命名的聊天室。系統不支援群組電子郵件,而且您只能在已命名的聊天室中將 Google 群組新增為成員。
HTTP 要求
POST https://chat.googleapis.com/v1/{parent=spaces/*}/members
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
parent |
必要欄位。要建立成員資格的聊天室資源名稱。 格式:space/{space} |
查詢參數
參數 | |
---|---|
useAdminAccess |
true 時,此方法會使用使用者的 Google Workspace 管理員權限執行。通話使用者必須是具備管理即時通訊和聊天室對話權限的 Google Workspace 管理員。 需要 系統不支援使用管理員存取權為非管理員 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
詳情請參閱授權指南。