Method: photos.batchUpdate

Aktualizuje metadane Photos, takie jak pozycja, powiązanie z miejscem, połączenia itp. Zmiana pikseli zdjęć nie jest obsługiwana.

Pamiętaj, że jeśli photos.batchUpdate się nie powiedzie, oznacza to, że brakuje pól krytycznych lub wystąpił błąd uwierzytelniania. Nawet jeśli photos.batchUpdate się powiedzie, poszczególne zdjęcia w partii mogą się nie udać. Te błędy są wyszczególnione w każdym elemencie PhotoResponse.status w elemencie BatchUpdatePhotosResponse.results. W artykule 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 pole updateMask nie występuje, aktualizacja dotyczy wszystkich pól.

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

Uwaga: aby zaktualizować pole Pose.altitude, musisz też wypełnić pole Pose.latLngPair. W przeciwnym razie żądanie nie zostanie zrealizowane.

Żą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. Obiekt Photo zawierający nowe metadane.
updatePhotoRequests[].updateMask

string (FieldMask format)

Wymagane. Maska, która identyfikuje pola w metadanych zdjęcia do zaktualizowania. Jeśli nie jest obecny, stare metadane Photo zostaną w tej prośbie całkowicie zastąpione nowymi metadanymi Photo. Jeśli podasz nieprawidłowe pola, aktualizacja się nie powiedzie. Możesz podać wiele pól na liście rozdzielonej przecinkami.

Te pola są prawidłowe:

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

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

Treść odpowiedzi

Odpowiedź na zbiorczą aktualizację metadanych co najmniej 1 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 Photo 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 sekcji OAuth 2.0 Overview.