Method: photos.batchUpdate

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

Perhatikan bahwa jika photos.batchUpdate gagal, kolom penting tidak ada atau terjadi error autentikasi. Meskipun photos.batchUpdate berhasil, setiap foto di batch mungkin akan gagal. Kegagalan ini ditentukan dalam setiap PhotoResponse.status pada 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, update akan diterapkan ke semua kolom.

Jumlah pesan UpdatePhotoRequest dalam BatchUpdatePhotosRequest tidak boleh lebih dari 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 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 diisi. Daftar UpdatePhotoRequests.

updatePhotoRequests[].photo

object (Photo)

Wajib diisi. Objek Photo yang berisi metadata baru.

updatePhotoRequests[].updateMask

string (FieldMask format)

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

Kolom berikut valid:

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

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

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Respons terhadap update batch metadata dari satu atau beberapa Photos.

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 ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.