Method: photos.batchUpdate

Aktualizuje metadane obiektu Photos, np. pozycję, powiązanie miejsca, połączenia itp. Zmienianie pikseli zdjęć nie jest obsługiwane.

Pamiętaj, że jeśli photos.batchUpdate nie powiedzie się, oznacza to, że brakuje kluczowych pól lub wystąpił błąd uwierzytelniania. Nawet jeśli photos.batchUpdate powiedzie się, poszczególne zdjęcia w serii mogą zawierać błędy. Te błędy są wymienione w każdym elemencie PhotoResponse.status w BatchUpdatePhotosResponse.results. Na stronie photo.update znajdziesz listę konkretnych błędów, które mogą wystąpić w przypadku poszczególnych zdjęć.

Użyte są tylko pola określone w polu updateMask. Jeśli pole updateMask nie jest podane, aktualizacja zostanie zastosowana do wszystkich pól.

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

Uwaga: aby zaktualizować pole Pose.altitude, musisz też wypełnić pole Pose.latLngPair. W przeciwnym razie prośba nie zostanie zrealizowana.

Żą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

To pole jest wymagane. Lista wartości UpdatePhotoRequests.
updatePhotoRequests[].photo

object (Photo)

To pole jest wymagane. Obiekt Photo zawierający nowe metadane.
updatePhotoRequests[].updateMask

string (FieldMask format)

To pole jest wymagane. Maska identyfikująca pola w metadanych zdjęcia, które mają zostać zaktualizowane. Jeśli ich nie ma, stare metadane Photo zostaną w tym żądaniu całkowicie zastąpione nowymi metadanymi Photo. Aktualizacja nie powiedzie się, jeśli podasz nieprawidłowe pola. Możesz podać wiele pól za pomocą listy rozdzielanej przecinkami.

Te pola są prawidłowe:

  • 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 zostanie zastąpiony nową treścią. Jeśli np. updateMask zawiera 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 użytkownika Photo została zaktualizowana w tej samej kolejności co żądanie.

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.