Method: contactGroups.create

Tạo một nhóm liên hệ mới do người dùng đã xác thực sở hữu.

Tên nhóm liên hệ được tạo phải là tên duy nhất cho nhóm liên hệ của người dùng. Việc cố gắng tạo một nhóm có tên trùng lặp sẽ trả về lỗi HTTP 409.

Bạn nên gửi các yêu cầu thay đổi cho cùng một người dùng theo tuần tự để tránh tăng độ trễ và lỗi.

Yêu cầu HTTP

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

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

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

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

object (ContactGroup)

Bắt buộc. Nhóm người liên hệ cần tạo.
readGroupFields

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 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
  • siêu dữ liệu
  • tên

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể mới tạo của ContactGroup.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

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