Method: photos.batchUpdate

Aktualizuje metadane elementu Photos, takie jak pozowanie, powiązanie miejsc, połączenia itp. Zmiana pikseli zdjęć nie jest obsługiwana.

Jeśli nie uda się wykonać żądania photos.batchUpdate, oznacza to, że brakuje pól krytycznych lub występuje błąd uwierzytelniania. Nawet jeśli proces photos.batchUpdate się powiedzie, poszczególne zdjęcia w grupie mogą zawierać błędy. Te błędy są wyszczególnione na każdym PhotoResponse.status w BatchUpdatePhotosResponse.results. Na stronie photo.update znajdziesz informacje o konkretnych błędach, które mogą wystąpić w przypadku poszczególnych zdjęć.

Używane są tylko pola określone w polu updateMask. Jeśli wartość updateMask nie jest podana, aktualizacja zostanie zastosowana do wszystkich pól.

Liczba wiadomości UpdatePhotoRequest w BatchUpdatePhotosRequest nie może przekraczać 20.

Uwaga: aby zaktualizować pole Pose.altitude, musisz też podać pole Pose.latLngPair. W przeciwnym razie żądanie się nie powiedzie.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

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

object

Wymagane. Lista: UpdatePhotoRequests.
updatePhotoRequests[].photo

object (Photo)

Wymagane. Photo obiekt zawierający nowe metadane.
updatePhotoRequests[].updateMask

string (FieldMask format)

Wymagane. Maska identyfikująca pola w metadanych zdjęcia, które mają być aktualizowane. Jeśli ich nie ma, stare metadane Photo zostaną w tym żądaniu całkowicie zastąpione nowymi metadanymi Photo. Aktualizacja się nie uda, jeśli podasz nieprawidłowe pola. Na liście rozdzielanej przecinkami można podać wiele pól.

Prawidłowe są te pola:

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

Uwaga: gdy updateMask zawiera pola powtarzane, cały zestaw powtarzających się wartości jest zastępowany nową zawartością. Jeśli na przykład updateMask zawiera ciąg connections, a pole UpdatePhotoRequest.photo.connections jest puste, wszystkie połączenia zostaną usunięte.

Treść odpowiedzi

Odpowiedź na zbiorczą aktualizację metadanych co najmniej 1 elementu Photos.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "results": [
    {
      object (PhotoResponse)
    }
  ]
}
Pola
results[]

object (PhotoResponse)

Lista wyników dla każdego elementu Photo została zaktualizowana, w takiej samej kolejności jak w żądaniu.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.