Method: photos.batchUpdate

Poz, yer ilişkilendirmesi, bağlantılar gibi Photos meta verilerini günceller. Fotoğrafların piksellerinin değiştirilmesi desteklenmez.

photos.batchUpdate başarısız olursa kritik alanların eksik olduğunu veya bir kimlik doğrulama hatası olduğunu unutmayın. photos.batchUpdate başarılı olsa bile, gruptaki tek tek fotoğraflarda hata oluşabilir. Bu hatalar, BatchUpdatePhotosResponse.results içindeki her bir PhotoResponse.status içinde belirtilir. Her fotoğrafta oluşabilecek belirli hatalar için photo.update sayfasına bakın.

Yalnızca updateMask alanında belirtilen alanlar kullanılır. updateMask mevcut değilse güncelleme tüm alanlar için geçerli olur.

BatchUpdatePhotosRequest içindeki UpdatePhotoRequest mesajlarının sayısı 20'den fazla olmamalıdır.

Not: Pose.altitude alanının güncellenmesi için Pose.latLngPair alanının da doldurulması gerekir. Aksi takdirde istek başarısız olur.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi 
{
  "updatePhotoRequests": [
    {
      "photo": {
        object (Photo)
      },
      "updateMask": string
    }
  ]
}
Alanlar
updatePhotoRequests[]

object

Zorunlu. UpdatePhotoRequests listesi.
updatePhotoRequests[].photo

object (Photo)

Zorunlu. Yeni meta veriyi içeren Photo nesnesi.
updatePhotoRequests[].updateMask

string (FieldMask format)

Zorunlu. Fotoğraf meta verilerindeki güncellenecek alanları tanımlayan maske. Mevcut değilse bu istekte eski Photo meta verisi tamamen yeni Photo meta verisi ile değiştirilir. Geçersiz alanlar belirtilirse güncelleme başarısız olur. Virgülle ayrılmış bir listede birden çok alan belirtilebilir.

Şu alanlar geçerlidir:

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

Not: updateMask yinelenen alanlar içerdiğinde, yinelenen değer kümesinin tamamı yeni içeriklerle değiştirilir. Örneğin, updateMask değeri connections değerini içeriyorsa ve UpdatePhotoRequest.photo.connections boşsa tüm bağlantılar kaldırılır.

Yanıt gövdesi

Bir veya daha fazla Photos öğesinin meta verilerinin toplu güncellemesine verilen yanıt.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "results": [
    {
      object (PhotoResponse)
    }
  ]
}
Alanlar
results[]

object (PhotoResponse)

Her Photo için sonuçların listesi, istekle aynı sırada güncellenir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.