- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- Hãy làm thử!
Cập nhật dữ liệu liên hệ cho một người liên hệ hiện có. Mọi dữ liệu không phải dữ liệu liên hệ sẽ không bị sửa đổi. Mọi dữ liệu không phải thông tin liên hệ trong người cần cập nhật sẽ bị bỏ qua. Tất cả các trường được chỉ định trong updateMask
sẽ được thay thế.
Máy chủ sẽ trả về lỗi 400 nếu bạn không chỉ định person.metadata.sources
cho người liên hệ cần cập nhật hoặc nếu không có nguồn người liên hệ.
Máy chủ trả về lỗi 400 với lý do "failedPrecondition"
nếu person.metadata.sources.etag
khác với etag của người liên hệ, cho biết người liên hệ đã thay đổi kể từ khi dữ liệu của người liên hệ được đọc. Ứng dụng khách nên lấy người mới nhất và hợp nhất nội dung cập nhật của họ vào người mới nhất. Nếu cập nhật tuần tự cho cùng một người, bạn nên sử dụng etag từ phản hồi updateContact
để tránh lỗi.
Máy chủ sẽ trả về lỗi 400 nếu memberships
đang được cập nhật và không có thành viên nào trong nhóm liên hệ được chỉ định cho người đó.
Máy chủ sẽ trả về lỗi 400 nếu bạn chỉ định nhiều trường trên một trường là singleton cho nguồn liên hệ:
- tiểu sử
- ngày sinh
- giới tính
- tên
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à số lần lỗi.
Yêu cầu HTTP
PATCH https://people.googleapis.com/v1/{person.resourceName=people/*}:updateContact
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Thông số | |
---|---|
person.resourceName |
Tên tài nguyên của người dùng do máy chủ chỉ định. Một chuỗi ASCII ở dạng |
Tham số truy vấn
Thông số | |
---|---|
updatePersonFields |
Bắt buộc. Mặt nạ trường để hạn chế những trường nào trên người dùng được cập nhật. Bạn có thể chỉ định nhiều trường bằng cách phân tách các trường đó bằng dấu phẩy. Tất cả các trường đã cập nhật sẽ được thay thế. Các giá trị hợp lệ là:
|
personFields |
Không bắt buộc. Mặt nạ trường để hạn chế những trường nào trên mỗi người được trả về. Bạn có thể chỉ định nhiều trường bằng cách phân tách các trường đó bằng dấu phẩy. Mặc định là tất cả các trường nếu không được đặt. Các giá trị hợp lệ là:
|
sources[] |
Không bắt buộc. Mặt nạ của các loại nguồn cần trả về. Mặc định là |
Nội dung yêu cầu
Nội dung yêu cầu chứa một bản sao của Person
.
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 Person
.
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.