Method: photo.update
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2023-12-01 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2023-12-01 UTC."],[[["Updates a Photo's metadata, such as pose, connections, and places, but not the image pixels themselves."],["Uses an `updateMask` to specify which fields to update; if omitted, all fields are updated."],["Requires the `https://www.googleapis.com/auth/streetviewpublish` OAuth scope for authorization."],["Returns the updated Photo object if successful."],["May return errors if permissions are lacking, the request is invalid, the Photo doesn't exist, or is still being indexed."]]],["This describes how to update a photo's metadata using the Street View Publish API. It uses a `PUT` request to a specific URL with a photo ID in the path. The `updateMask` query parameter specifies which metadata fields to modify. The request body contains the new metadata, and the response body returns the updated photo. Key metadata includes pose, connections, and places. Authorization requires a specific OAuth scope. Possible errors include permission, invalid argument, not found, or unavailability.\n"]]