Method: contactGroups.batchGet

Nhận danh sách nhóm 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 của nhóm 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

Thông số
resourceNames[]

string

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

Tài nguyên có tối đa 200 tên.

maxMembers

integer

Không bắt buộc. Chỉ định số lượng thành viên tối đa cần trả lại 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 nạ trường (field mask) để hạn chế những trường trong nhóm được trả về. Giá trị mặc định là metadata, groupType, memberCountname nếu không được đặt hoặ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 nhận nhóm liên hệ theo lô.

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 từng tài nguyên của nhóm người 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 đây:

  • https://www.googleapis.com/auth/contacts
  • https://www.googleapis.com/auth/contacts.readonly

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

ContactGroupResponse

Phản hồ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ệ.