Method: contactGroups.list

Liệt kê tất cả các nhóm liên hệ do người dùng đã xác thực sở hữu. Các thành viên của nhóm địa chỉ liên hệ không được điền sẵn.

Yêu cầu HTTP

GET https://people.googleapis.com/v1/contactGroups

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

Tham số truy vấn

Tham số
pageToken

string

Không bắt buộc. Giá trị nextPageToken được trả về từ lệnh gọi trước đó đến contactGroups.list. Yêu cầu trang tài nguyên tiếp theo.
pageSize

integer

Không bắt buộc. Số lượng tài nguyên tối đa cần trả về. Các giá trị hợp lệ nằm trong khoảng từ 1 đến 1000. Giá trị mặc định là 30 nếu không được đặt hoặc được đặt thành 0.
syncToken

string

Không bắt buộc. Mã thông báo đồng bộ hoá, được lệnh gọi trước đó trả về cho contactgroups.list. Chỉ những tài nguyên được thay đổi kể từ khi mã thông báo đồng bộ hoá được tạo mới được trả về.
groupFields

string (FieldMask format)

Không bắt buộc. Một mặt nạ trường để hạn chế các trường trong nhóm được trả về. Giá trị mặc định là metadata, groupType, memberCount và name nếu không được đặt hoặc được đặt thành trống. Các trường hợp lệ là:

  • clientData
  • groupType
  • memberCount
  • siêu dữ liệu
  • tên

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 cho yêu cầu về danh sách liên hệ với nhóm.

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 
{
  "contactGroups": [
    {
      object (ContactGroup)
    }
  ],
  "totalItems": integer,
  "nextPageToken": string,
  "nextSyncToken": string
}
Trường
contactGroups[]

object (ContactGroup)

Danh sách các nhóm liên hệ. Các thành viên của nhóm địa chỉ liên hệ không được điền sẵn.
totalItems

integer

Tổng số mục trong danh sách không phân trang.
nextPageToken

string

Mã thông báo có thể dùng để truy xuất trang kết quả tiếp theo.
nextSyncToken

string

Mã thông báo có thể dùng để truy xuất các thay đổi kể từ lần yêu cầu gần đây nhất.

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

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