Method: people.updateContact

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

string

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 people/{person_id}.

Tham số truy vấn

Thông số
updatePersonFields

string (FieldMask format)

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à:

  • địa chỉ
  • tiểu sử
  • ngày sinh
  • calendarUrls
  • clientData
  • emailAddresses
  • sự kiện
  • externalIds
  • giới tính
  • imClients
  • sở thích
  • ngôn ngữ
  • vị trí
  • của kênh
  • miscKeywords
  • tên
  • biệt hiệu
  • nghề nghiệp
  • tổ chức
  • phoneNumbers
  • quan hệ
  • sipAddresses
  • url
  • userDefined
personFields

string (FieldMask format)

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à:

  • địa chỉ
  • ageRanges
  • tiểu sử
  • ngày sinh
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • sự kiện
  • externalIds
  • giới tính
  • imClients
  • sở thích
  • ngôn ngữ
  • vị trí
  • của kênh
  • siêu dữ liệu
  • miscKeywords
  • tên
  • biệt hiệu
  • nghề nghiệp
  • tổ chức
  • phoneNumbers
  • ảnh
  • quan hệ
  • sipAddresses
  • kỹ năng
  • url
  • userDefined
sources[]

enum (ReadSourceType)

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à READ_SOURCE_TYPE_CONTACTREAD_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 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.