Method: photos.batchUpdate

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

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

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

Jumlah pesan UpdatePhotoRequest di 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. 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 sepenuhnya akan diganti dengan metadata Photo baru dalam permintaan ini. Update akan 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 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 individu 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.