Method: spaces.findGroupChats

Trả về tất cả các không gian có spaceType == GROUP_CHAT, trong đó thành viên là người dùng chứa chính xác người dùng gọi và những người dùng được chỉ định trong FindGroupChatsRequest.memberships.

Nếu người dùng gọi chặn hoặc bị một số người dùng chặn và không tìm thấy khoảng trống nào có toàn bộ nhóm người dùng được chỉ định, thì phương thức này sẽ trả về những khoảng trống không có người dùng bị chặn hoặc chặn.

Nhóm người dùng được chỉ định chỉ được chứa các thành viên là người dùng (không phải ứng dụng). Yêu cầu có chứa người dùng không phải là con người sẽ không trả về bất kỳ không gian nào.

Yêu cầu xác thực người dùng bằng một trong các phạm vi uỷ quyền sau đây:

  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.memberships

Yêu cầu HTTP

GET https://chat.googleapis.com/v1/spaces:findGroupChats

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số truy vấn

Thông số
user[]

string

Tên tài nguyên của tất cả người dùng là con người trong cuộc trò chuyện nhóm với người dùng gọi. Bạn không thể đưa các ứng dụng trò chuyện vào yêu cầu.

Định dạng: users/{user}, trong đó {user} là id cho người trong People API hoặc id cho người dùng trong Directory API. Ví dụ: để tìm tất cả cuộc trò chuyện nhóm có người dùng gọi và 2 người dùng khác, với mã hồ sơ People API là 123456789 và 987654321, bạn có thể sử dụng users/123456789 và users/987654321. Bạn cũng có thể sử dụng email này làm email đại diện cho {user}. Ví dụ: users/example@gmail.com, trong đó example@gmail.com là email của người dùng Google Chat.

Khi người dùng gọi là người dùng Google Workspace, tất cả người dùng được yêu cầu phải là thành viên của cùng một tổ chức Google Workspace với người dùng gọi.
pageSize

integer

Không bắt buộc. Số lượng không gian tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này.

Nếu bạn không chỉ định, hệ thống sẽ trả về tối đa 100 khoảng trống.

Giá trị tối đa là 1000. Nếu bạn sử dụng giá trị lớn hơn 1.000, giá trị đó sẽ tự động thay đổi thành 1.000.

Giá trị âm sẽ trả về lỗi INVALID_ARGUMENT.
pageToken

string

Không bắt buộc. Mã thông báo trang nhận được từ một lệnh gọi trước đó để tìm cuộc trò chuyện nhóm. Cung cấp thông số này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham 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. Việc truyền các giá trị khác nhau có thể dẫn đến kết quả không mong muốn.
spaceView

enum (SpaceView)

Loại khung hiển thị không gian được yêu cầu. Nếu bạn không đặt, giá trị mặc định sẽ là SPACE_VIEW_RESOURCE_NAME_ONLY. Các yêu cầu chỉ định SPACE_VIEW_EXPANDED phải bao gồm các phạm vi cho phép đọc dữ liệu về không gian, ví dụ: https://www.googleapis.com/auth/chat.spaces hoặc https://www.googleapis.com/auth/chat.spaces.readonly.

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

Phản hồi chứa các phòng trò chuyện nhóm có chính xác người dùng gọi và người dùng được yêu cầu.

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 
{
  "spaces": [
    {
      object (Space)
    }
  ],
  "nextPageToken": string
}
Trường
spaces[]

object (Space)

Danh sách các không gian trong trang được yêu cầu (hoặc trang đầu tiên).
nextPageToken

string

Một mã thông báo mà bạn có thể gửi dưới dạng pageToken để truy xuất trang kết quả tiếp theo. Nếu trống, tức là không có trang nào tiếp theo.

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.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.

SpaceView

Khung hiển thị chỉ định những trường cần được điền sẵn trên tài nguyên Space. Để đảm bảo khả năng tương thích với các bản phát hành trong tương lai, bạn nên sử dụng mã cho các giá trị bổ sung.

Enum
SPACE_VIEW_UNSPECIFIED Giá trị mặc định / chưa đặt.
SPACE_VIEW_RESOURCE_NAME_ONLY Chỉ điền tên tài nguyên Không gian.
SPACE_VIEW_EXPANDED Điền sẵn các trường tài nguyên Space. Lưu ý: trường permissionSettings sẽ không được điền sẵn. Các yêu cầu chỉ định SPACE_VIEW_EXPANDED phải bao gồm các phạm vi cho phép đọc dữ liệu về không gian, ví dụ: https://www.googleapis.com/auth/chat.spaces hoặc https://www.googleapis.com/auth/chat.spaces.readonly.