Method: photos.batchUpdate

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

Lưu ý rằng nếu photos.batchUpdate không thành công thì tức là các trường quan trọng sẽ bị thiếu 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ô có thể vẫn không thành công. Những lỗi này được chỉ định cho 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 cho mỗi ảnh.

Hệ thống 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 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 có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "updatePhotoRequests": [
    {
      "photo": {
        object (Photo)
      },
      "updateMask": string
    }
  ]
}
Các 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ạ giúp xác định các trường trên siêu dữ liệu ảnh cần cập nhật. Nếu không có siêu dữ liệu Photo cũ, siêu dữ liệu 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ẽ không thành công 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 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ì mọi kết nối sẽ bị xoá.

Nội dung phản hồi

Phản hồi khi 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)
    }
  ]
}
Các trường
results[]

object (PhotoResponse)

Đã cập nhật danh sách kết quả cho từng Photo riêng lẻ, theo đú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 Tổng quan về OAuth 2.0.