- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- Hãy làm thử!
Tạo gói thành viên thủ công hoặc gói thành viên trong ứng dụng cho ứng dụng gọi. Không hỗ trợ tạo gói thành viên cho các ứng dụng khác. Ví dụ: hãy xem bài viết Mời hoặc thêm người dùng hoặc ứng dụng Google Chat vào một không gian. Khi tạo thành viên, nếu thành viên được chỉ định đã tắt chính sách tự động chấp nhận, thì họ sẽ được mời và phải chấp nhận lời mời tham gia không gian. Nếu không, khi tạo một thành viên, thành viên đó sẽ được thêm trực tiếp vào không gian được chỉ định. Yêu cầu xác thực người dùng.
Để chỉ định thành viên cần thêm, hãy đặt membership.member.name
cho thành viên trong ứng dụng hoặc thành viên khác, hoặc đặt membership.group_member.name
cho thành viên nhóm.
Để thêm ứng dụng gọi điện vào một không gian hoặc tin nhắn trực tiếp giữa 2 người dùng, hãy sử dụng
users/app
. Không thể thêm các ứng dụng khác vào không gian.Để thêm người dùng là người thật, hãy sử dụng
users/{user}
, trong đó{user}
có thể là địa chỉ email của người dùng đó. Đối với người dùng trong cùng một tổ chức Workspace,{user}
cũng có thể làid
đối với người dùng trong API Mọi người hoặcid
đối với người dùng trong API Thư mục. Ví dụ: nếu Mã hồ sơ cá nhân API Mọi người chouser@example.com
là123456789
, bạn có thể thêm người dùng vào không gian bằng cách đặtmembership.member.name
thànhusers/user@example.com
hoặcusers/123456789
.Để thêm hoặc mời một nhóm trên Google Groups trong không gian được đặt tên, hãy sử dụng
groups/{group}
, trong đó{group}
làid
cho nhóm theo API Cloud Identity Groups. Ví dụ: bạn có thể sử dụng API tra cứu nhóm trên Cloud Identity để truy xuất mã123456789
cho email nhómgroup@example.com
, sau đó thêm hoặc mời nhóm vào một không gian được đặt tên bằng cách đặtmembership.group_member.name
thànhgroups/123456789
. Email nhóm không được hỗ trợ và bạn chỉ có thể thêm nhóm trên Google làm thành viên trong các không gian được đặt tên.
Yêu cầu HTTP
POST https://chat.googleapis.com/v1/{parent=spaces/*}/members
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Thông số | |
---|---|
parent |
Bắt buộc. Tên tài nguyên của không gian để tạo thành viên. Định dạng: dấu cách/{space} |
Tham số truy vấn
Thông số | |
---|---|
useAdminAccess |
true , phương thức này sẽ chạy bằng đặc quyền của quản trị viên Google Workspace của người dùng.Người dùng gọi phải là quản trị viên Google Workspace có đặc quyền quản lý cuộc trò chuyện và không gian trên Chat. Yêu cầu Quyền quản trị không hỗ trợ tính năng tạo thành viên trong ứng dụng hoặc tạo thành viên cho người dùng bên ngoài tổ chức Google Workspace của quản trị viên. |
Nội dung yêu cầu
Nội dung yêu cầu chứa một bản sao của Membership
.
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một thực thể mới tạo của Membership
.
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau:
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
Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.