Method: photo.update

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

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

Ta metoda zwraca następujące kody błędów:

Żądanie HTTP

PUT https://streetviewpublish.googleapis.com/v1/photo/{photo.photoId.id}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
photo.photoId.id

string

Unikalny identyfikator zdjęcia.

Parametry zapytania

Parametry
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ść żądania

Treść żądania zawiera wystąpienie elementu Photo.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Photo.

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.