Method: photos.batchUpdate

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

Xin lưu ý rằng nếu photos.batchUpdate không thành công thì có nghĩa là sẽ thiếu các trường quan trọng hoặc đã xảy ra lỗi xác thực. Ngay cả khi photos.batchUpdate thành công, các ảnh riêng lẻ trong lô vẫn có thể gặp lỗi. Những lỗi này được chỉ định trong từng PhotoResponse.status trong BatchUpdatePhotosResponse.results. Hãy xem photo.update để biết những lỗi cụ thể có thể xảy ra với mỗi ảnh.

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

Số lượng thông báo UpdatePhotoRequest trong BatchUpdatePhotosRequest không được vượt quá 20.

Lưu ý: Để cập nhật Pose.altitude, bạn cũng phải điền Pose.latLngPair. Nếu không, yêu cầu sẽ không thành công.

Yêu cầu HTTP

POST https://streetviewpublish.googleapis.com/v1/photos:batchUpdate

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

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 
{
  "updatePhotoRequests": [
    {
      "photo": {
        object (Photo)
      },
      "updateMask": string
    }
  ]
}
Trường
updatePhotoRequests[]

object

Bắt buộc. Danh sách UpdatePhotoRequests.
updatePhotoRequests[].photo

object (Photo)

Bắt buộc. Đối tượng Photo chứa siêu dữ liệu mới.
updatePhotoRequests[].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. Không cập nhật được 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 danh sách được phân tách bằng dấu phẩy.

Sau đây là các trường 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 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 là trống thì mọi kết nối đều bị xoá.

Nội dung phản hồi

Phản hồi cho yêu cầu cập nhật hàng loạt siêu dữ liệu của một hoặc nhiều Photos.

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 
{
  "results": [
    {
      object (PhotoResponse)
    }
  ]
}
Trường
results[]

object (PhotoResponse)

Danh sách kết quả cho từng Photo được cập nhật, theo cùng thứ tự như yêu cầu.

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 bài viết Tổng quan về OAuth 2.0.