Method: photos.batchUpdate

Memperbarui metadata Photos, seperti pose, asosiasi tempat, koneksi, dll. Mengubah piksel foto tidak didukung.

Perhatikan bahwa jika photos.batchUpdate gagal, berarti kolom penting tidak ada atau terjadi error autentikasi. Meskipun photos.batchUpdate berhasil, foto satu per satu dalam batch mungkin mengalami kegagalan. Kegagalan ini ditentukan di setiap PhotoResponse.status dalam BatchUpdatePhotosResponse.results. Lihat photo.update untuk mengetahui kegagalan spesifik yang dapat terjadi per foto.

Hanya kolom yang ditentukan di kolom updateMask yang digunakan. Jika updateMask tidak ada, pembaruan berlaku untuk semua kolom.

Jumlah pesan UpdatePhotoRequest dalam BatchUpdatePhotosRequest tidak boleh melebihi 20.

Catatan: Untuk memperbarui Pose.altitude, Pose.latLngPair juga harus diisi. Jika tidak, permintaan akan gagal.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "updatePhotoRequests": [
    {
      "photo": {
        object (Photo)
      },
      "updateMask": string
    }
  ]
}
Kolom
updatePhotoRequests[]

object

Wajib. Daftar UpdatePhotoRequests.
updatePhotoRequests[].photo

object (Photo)

Wajib. Objek Photo yang berisi metadata baru.
updatePhotoRequests[].updateMask

string (FieldMask format)

Wajib. Masker yang mengidentifikasi kolom pada metadata foto yang akan diperbarui. Jika tidak ada, metadata Photo lama akan sepenuhnya diganti dengan metadata Photo baru dalam permintaan ini. Pembaruan akan gagal jika kolom yang tidak valid ditentukan. Beberapa kolom dapat ditentukan dalam daftar yang dibatasi koma.

Kolom berikut valid:

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

Catatan: Jika updateMask berisi kolom berulang, seluruh kumpulan nilai berulang akan diganti dengan konten baru. Misalnya, jika updateMask berisi connections dan UpdatePhotoRequest.photo.connections kosong, semua koneksi akan dihapus.

Isi respons

Respons terhadap update batch metadata satu atau beberapa Photos.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "results": [
    {
      object (PhotoResponse)
    }
  ]
}
Kolom
results[]

object (PhotoResponse)

Daftar hasil untuk setiap Photo yang diperbarui, dalam urutan yang sama dengan permintaan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.