Method: photos.batchUpdate

Cập nhật siêu dữ liệu của Photos, 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.

Xin lưu ý rằng nếu photos.batchUpdate không thành công, thì có thể là do thiếu các trường quan trọng hoặc có lỗi xác thực. Ngay cả khi photos.batchUpdate thành công, từng bức ảnh trong lô có thể gặp lỗi. Các lỗi này được chỉ định trong mỗi PhotoResponse.status trong BatchUpdatePhotosResponse.results. Hãy xem photo.update để biết các lỗi cụ thể có thể xảy ra đối với mỗi bức ả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.

Số lượng thư UpdatePhotoRequest trong một 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 với 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. 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 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 riêng lẻ đượ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 OAuth 2.0 Overview.