Method: contactGroups.batchGet

Lấy danh sách các nhóm địa chỉ liên hệ do người dùng đã xác thực sở hữu bằng cách chỉ định danh sách tên tài nguyên nhóm địa chỉ liên hệ.

Yêu cầu HTTP

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

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

Tham số truy vấn

Tham số
resourceNames[]

string

Bắt buộc. Tên tài nguyên của nhóm liên hệ cần tải.

Bạn chỉ được thêm tối đa 200 tên tài nguyên.
maxMembers

integer

Không bắt buộc. Chỉ định số lượng thành viên tối đa cần trả về cho mỗi nhóm. Giá trị mặc định là 0 nếu không được đặt. Giá trị này sẽ trả về 0 thành viên.
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 một yêu cầu nhận nhóm địa chỉ liên hệ hàng loạt.

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 
{
  "responses": [
    {
      object (ContactGroupResponse)
    }
  ]
}
Trường
responses[]

object (ContactGroupResponse)

Danh sách phản hồi cho mỗi tài nguyên nhóm liên hệ được yêu cầu.

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.

ContactGroupResponse

Câu trả lời cho một nhóm người liên hệ cụ thể.

Biểu diễn dưới dạng JSON 
{
  "requestedResourceName": string,
  "status": {
    object (Status)
  },
  "contactGroup": {
    object (ContactGroup)
  }
}
Trường
requestedResourceName

string

Tên tài nguyên được yêu cầu ban đầu.
status

object (Status)

Trạng thái của phản hồi.
contactGroup

object (ContactGroup)

Nhóm người liên hệ.