為通話應用程式建立使用者成員資格或應用程式成員資格。系統不支援為其他應用程式建立會員功能。如需範例,請參閱「邀請使用者或 Google Chat 應用程式加入聊天室」。建立成員資格時,如果指定成員已關閉自動接受政策,他們便會收到邀請,且必須接受聊天室邀請才能加入。否則,建立成員資格後,系統會將該成員直接加入指定聊天室。必須完成使用者驗證。
如要指定要新增的成員,請在 CreateMembershipRequest
中設定 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.com
或users/123456789
,將使用者新增至聊天室。
HTTP 要求
POST https://chat.googleapis.com/v1/{parent=spaces/*}/members
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
parent |
必要欄位。要建立成員的聊天室資源名稱。 格式:空格/{space} |
要求主體
要求主體包含 Membership
的例項。
回應主體
如果成功,回應主體會包含新建立的 Membership
例項。
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.app
詳情請參閱授權指南。