Tạo một nhóm liên hệ mới thuộc sở hữu của người dùng đã xác thực.
Tên nhóm liên hệ đã tạo phải là tên riêng biệt đối với các 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 phải gửi 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 ( |
Trường | |
---|---|
contactGroup |
Bắt buộc. Nhóm người liên hệ cần tạo. |
readGroupFields |
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à
|
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 bài viết Hướng dẫn uỷ quyền.