Method: photos.batchUpdate

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

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

Hanya kolom yang ditentukan dalam kolom updateMask yang digunakan. Jika updateMask tidak ada, update berlaku untuk semua kolom.

Jumlah UpdatePhotoRequest pesan di dalam BatchUpdatePhotosRequest tidak boleh lebih dari 20.

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

Permintaan HTTP

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

URL 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. Mask yang mengidentifikasi kolom pada metadata foto yang akan diperbarui. Jika tidak ada, metadata Photo lama akan sepenuhnya diganti dengan metadata Photo yang baru dalam permintaan ini. Update gagal jika kolom yang tidak valid ditentukan. Beberapa kolom dapat ditentukan dalam daftar yang dipisahkan 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 untuk 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 informasi selengkapnya, lihat Ringkasan OAuth 2.0.