Method: photos.batchUpdate
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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:
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.
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: 2024-09-10 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Brak potrzebnych mi informacji"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Zbyt skomplikowane / zbyt wiele czynności do wykonania"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Nieaktualne treści"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problem z tłumaczeniem"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Problem z przykładami/kodem"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Inne"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Łatwo zrozumieć"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Rozwiązało to mój problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Inne"
}]
{"lastModified": "Ostatnia aktualizacja: 2024-09-10 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: 2024-09-10 UTC."]]