Method: photo.update

Cập nhật siêu dữ liệu của một Photo, chẳng hạn như tư thế, mối liên kết với địa điểm, các mối kết nối, v.v. Không hỗ trợ việc thay đổi các pixel của ảnh.

Chỉ những trường được chỉ định trong trường updateMask mới được sử dụng. Nếu không có updateMask, bản cập nhật sẽ áp dụng cho tất cả các trường.

Phương thức này trả về các mã lỗi sau:

Yêu cầu HTTP

PUT https://streetviewpublish.googleapis.com/v1/photo/{photo.photoId.id}

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

Tham số đường dẫn

Thông số
photo.photoId.id

string

Giá trị nhận dạng riêng biệt của một bức ảnh.

Tham số truy vấn

Thông số
updateMask

string (FieldMask format)

Bắt buộc. Mặt nạ xác định các trường trong siêu dữ liệu ảnh cần cập nhật. Nếu không có, siêu dữ liệu Photo cũ sẽ được thay thế hoàn toàn bằng siêu dữ liệu Photo mới trong yêu cầu này. Quá trình cập nhật sẽ thất bại nếu bạn chỉ định các trường không hợp lệ. Bạn có thể chỉ định nhiều trường trong một danh sách được phân tách bằng dấu phẩy.

Các trường sau đây hợp lệ:

  • pose.heading
  • pose.lat_lng_pair
  • pose.pitch
  • pose.roll
  • pose.level
  • pose.altitude
  • connections
  • places

Lưu ý: Khi updateMask chứa các trường lặp lại, toàn bộ tập hợp các giá trị lặp lại sẽ được thay thế bằng nội dung mới. Ví dụ: nếu updateMask chứa connections và UpdatePhotoRequest.photo.connections trống, thì tất cả các kết nối sẽ bị xoá.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của Photo.

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 thực thể của Photo.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/streetviewpublish

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.