Method: people.updateContact

Cập nhật dữ liệu liên hệ cho người liên hệ hiện tại. Mọi dữ liệu không có trong danh bạ sẽ không được sửa đổi. Mọi dữ liệu không liên hệ trong người cần cập nhật sẽ bị bỏ qua. Tất cả trường được chỉ định trong updateMask sẽ bị thay thế.

Máy chủ sẽ trả về lỗi 400 nếu person.metadata.sources không được chỉ định để cập nhật danh bạ hoặc nếu không có nguồn 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 địa chỉ liên hệ, cho biết địa chỉ liên hệ đã thay đổi kể từ khi dữ liệu của địa chỉ liên hệ được đọc. Khách hàng phải có được người mới nhất và hợp nhất các bản cập nhật của họ thành người mới nhất.

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 trên người.

Máy chủ trả về lỗi 400 nếu nhiều trường được chỉ định trên trường là singleton cho các nguồn liên hệ:

  • Tiểu sử
  • ngày sinh nhật
  • 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à tỷ lệ 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

Các tham số
person.resourceName

string

Tên tài nguyên cho người đó, do máy chủ chỉ định. Một chuỗi ASCII ở dạng people/{person_id}.

Tham số truy vấn

Các tham số
updatePersonFields

string (FieldMask format)

Bắt buộc. Một mặt nạ trường để hạn chế những 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 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à:

  • các địa chỉ
  • Tiểu sử
  • ngày sinh nhật
  • calendarUrl
  • Dữ liệu khách hàng
  • địa chỉ email
  • sự kiện
  • externalIds
  • giới tính
  • imClient
  • sở thích
  • ngôn ngữ
  • vị trí
  • của kênh
  • Từ khóa khác
  • tên
  • biệt hiệu
  • Nghề nghiệp
  • tổ chức
  • phoneNumbers
  • quan hệ
  • SipAddresses
  • url
  • do người dùng xác định
personFields

string (FieldMask format)

Không bắt buộc. Mặt nạ trường để hạn chế trường 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 bạn không đặt trường này. Các giá trị hợp lệ là:

  • các địa chỉ
  • Độ tuổi
  • Tiểu sử
  • ngày sinh nhật
  • calendarUrl
  • Dữ liệu khách hàng
  • ảnh bìa
  • địa chỉ email
  • sự kiện
  • externalIds
  • giới tính
  • imClient
  • sở thích
  • ngôn ngữ
  • vị trí
  • của kênh
  • siêu dữ liệu
  • Từ khóa khác
  • tên
  • biệt hiệu
  • Nghề nghiệp
  • tổ chức
  • phoneNumbers
  • ảnh
  • quan hệ
  • SipAddresses
  • kỹ năng
  • url
  • do người dùng xác định
sources[]

enum (ReadSourceType)

Không bắt buộc. Mặt nạ của các loại nguồn sẽ trả về. Giá trị mặc định là READ_SOURCE_TYPE_CONTACT và READ_SOURCE_TYPE_PROFILE nếu không được đặt.

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 cấp phép

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.