Cập nhật tên của một nhóm liên hệ hiện có do người dùng đã xác thực sở hữu.
Tên nhóm liên hệ được cập nhật phải là duy nhất cho 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
PUT https://people.googleapis.com/v1/{contactGroup.resourceName=contactGroups/*}
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Thông số | |
---|---|
contactGroup.resourceName |
Tên tài nguyên cho nhóm người liên hệ do máy chủ chỉ định. Một chuỗi ASCII, dưới dạng |
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": {
"resourceName": string,
"etag": string,
"metadata": {
"updateTime": string,
"deleted": boolean
},
"groupType": enum ( |
Trường | |
---|---|
contactGroup.etag |
Thẻ thực thể HTTP của tài nguyên. Dùng để xác thực bộ nhớ đệm của web. |
contactGroup.metadata |
Chỉ có đầu ra. Siêu dữ liệu về nhóm người liên hệ. |
contactGroup.groupType |
Chỉ có đầu ra. Loại nhóm địa chỉ liên hệ. |
contactGroup.name |
Tên nhóm người liên hệ do chủ sở hữu nhóm đặt hoặc tên do hệ thống cung cấp cho nhóm hệ thống. Đối với |
contactGroup.formattedName |
Chỉ có đầu ra. Tên được dịch và định dạng theo ngôn ngữ trong tài khoản của người xem hoặc ngôn ngữ tiêu đề HTTP |
contactGroup.memberResourceNames[] |
Chỉ có đầu ra. Danh sách tên tài nguyên của người liên hệ là thành viên của nhóm người liên hệ. Trường này chỉ được điền cho các yêu cầu GET và sẽ chỉ trả về số lượng thành viên tối đa là |
contactGroup.memberCount |
Chỉ có đầu ra. Tổng số người liên hệ trong nhóm, bất kể số thành viên tối đa được chỉ định trong yêu cầu. |
contactGroup.clientData[] |
Dữ liệu khách hàng của nhóm. |
updateGroupFields |
Không bắt buộc. Mặt nạ trường (field mask) để hạn chế các trường trong nhóm này được cập nhật. Bạn có thể chỉ định nhiều trường bằng cách dùng dấu phẩy phân tách các trường. Giá trị mặc định là
|
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 phiên bản 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.