- 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ử!
Liệt kê thành viên trong một không gian. Để xem ví dụ, hãy xem bài viết Liệt kê người dùng và ứng dụng Google Chat trong một không gian. Trang thông tin thành viên có xác thực ứng dụng liệt kê thành viên trong những không gian mà ứng dụng Chat có quyền truy cập, nhưng không bao gồm tư cách thành viên của ứng dụng Chat, kể cả thành viên của không gian đó. Trang thông tin thành viên có Xác thực người dùng liệt kê thành viên trong các không gian mà người dùng đã xác thực có quyền truy cập.
Cần phải xác thực. Hỗ trợ xác thực ứng dụng và xác thực người dùng.
Yêu cầu HTTP
GET https://chat.googleapis.com/v1/{parent=spaces/*}/members
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số | |
---|---|
parent |
Bắt buộc. Tên tài nguyên của không gian cần tìm nạp danh sách thành viên. Định dạng: dấu cách/{space} |
Tham số truy vấn
Tham số | |
---|---|
pageSize |
Không bắt buộc. Số lượng hội viên tối đa cần trả lại. Dịch vụ có thể trả về ít hơn giá trị này. Nếu không chỉ định, hệ thống sẽ trả về tối đa 100 gói hội viên. Giá trị tối đa là 1000. Nếu bạn sử dụng một giá trị lớn hơn 1000 thì giá trị này sẽ tự động thay đổi thành 1000. Giá trị âm trả về lỗi |
pageToken |
Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi trước đó để liệt kê thành viên. Cung cấp tham số này để truy xuất trang tiếp theo. Khi phân trang, tất cả các thông số khác được cung cấp phải khớp với lệnh gọi đã cung cấp mã thông báo trang. Việc chuyển các giá trị khác nhau cho các tham số khác có thể dẫn đến kết quả không mong muốn. |
filter |
Không bắt buộc. Bộ lọc cụm từ tìm kiếm. Bạn có thể lọc gói thành viên theo vai trò của thành viên ( Để lọc theo vai trò, hãy đặt Để lọc theo loại, hãy đặt Để lọc theo cả vai trò và loại, hãy sử dụng toán tử Bạn cần phải có Ví dụ: các truy vấn sau đây là hợp lệ:
Các truy vấn sau không hợp lệ:
Các truy vấn không hợp lệ bị máy chủ từ chối, có lỗi |
showGroups |
Không bắt buộc. Khi |
showInvited |
Không bắt buộc. Khi Hiện tại, bạn cần phải xác thực người dùng. |
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 điện 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 phải có phạm vi OAuth 2.0 Việc đăng thông tin thành viên trong ứng dụng trong một không gian không được hỗ trợ khi sử dụng quyền quản trị. |
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Câu trả lời cho danh sách thành viên của không gian.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{
"memberships": [
{
object ( |
Trường | |
---|---|
memberships[] |
Danh sách không theo thứ tự. Danh sách thành viên trên trang được yêu cầu (hoặc đầu tiên). |
nextPageToken |
Mã thông báo mà bạn có thể gửi dưới dạng |
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau đây:
https://www.googleapis.com/auth/chat.admin.memberships
https://www.googleapis.com/auth/chat.admin.memberships.readonly
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.bot
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.readonly
Để biết thêm thông tin, hãy xem bài viết Hướng dẫn uỷ quyền.