Cập nhật một loạt địa chỉ liên hệ và trả về bản đồ tên tài nguyên cho PersonResponses cho các địa chỉ liên hệ đã cập nhật.
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/people:batchUpdateContacts
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 |
---|
{ "contacts": { string: { object ( |
Trường | |
---|---|
contacts |
Bắt buộc. Liên kết tên tài nguyên với dữ liệu về người dùng sẽ được cập nhật. Cho phép tối đa 200 địa chỉ liên hệ trong một yêu cầu. Một đối tượng chứa danh sách các cặp |
updateMask |
Bắt buộc. Mặt nạ trường để hạn chế các trường trên người đượ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. Tất cả các trường được chỉ định sẽ bị thay thế hoặc xóa nếu để trống cho từng người. Các giá trị hợp lệ là:
|
readMask |
Bắt buộc. Mặt nạ trường để hạn chế các trường mà mỗi người dùng được trả về. 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. Nếu mặt nạ đọc bị để trống, thì post-mutate-get sẽ bị bỏ qua và không có dữ liệu nào được trả về trong phản hồi. Các giá trị hợp lệ là:
|
sources[] |
Không bắt buộc. Mặt nạ cho biết các loại nguồn cần trả về. Giá trị mặc định là |
Nội dung phản hồi
Nếu không thành công, hàm sẽ trả về BatchUpdateContactsErrorDetails
, một danh sách lỗi tương ứng với mỗi địa chỉ liên hệ.
Phản hồi cho yêu cầu cập nhật một loạt địa chỉ liên hệ.
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 |
---|
{
"updateResult": {
string: {
object ( |
Trường | |
---|---|
updateResult |
Ánh xạ tên tài nguyên đến danh bạ đã được cập nhật, trừ phi yêu cầu Một đối tượng chứa danh sách các cặp |
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.