Method: people.updateContactPhoto

Cập nhật ảnh của một người liên hệ.

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

PATCH https://people.googleapis.com/v1/{resourceName=people/*}:updateContactPhoto

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
resourceName

string

Bắt buộc. Tên tài nguyên cá nhân

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 
{
  "photoBytes": string,
  "personFields": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
Trường
photoBytes

string (bytes format)

Bắt buộc. Số byte ảnh thô

Một chuỗi được mã hoá base64.
personFields

string (FieldMask format)

Không bắt buộc. Mặt nạ trường (field mask) để hạn chế những trường trên người đượ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. Giá trị mặc định là trống nếu không được đặt, điều này sẽ bỏ qua việc nhận biến đổi bài đăng. Các giá trị hợp lệ là:

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

enum (ReadSourceType)

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à READ_SOURCE_TYPE_CONTACT và READ_SOURCE_TYPE_PROFILE nếu không được đặt.

Nội dung phản hồi

Phản hồi cho việc cập nhật ảnh của một người 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 
{
  "person": {
    object (Person)
  }
}
Trường
person

object (Person)

Người được cập nhật sẽ không được đặt nếu personFields được đặt trong UpdateContactPhotosRequest; nếu không, giá trị này sẽ không được đặt.

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.