Method: photos.batchUpdate
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Aggiorna i metadati di Photos
, ad esempio posa, associazione del luogo, connessioni e così via. La modifica dei pixel delle foto non è supportata.
Tieni presente che se photos.batchUpdate
non riesce, mancano campi critici o si è verificato un errore di autenticazione. Anche se l'operazione photos.batchUpdate
va a buon fine, è possibile che le singole foto del batch presentino errori. Questi errori sono specificati in ogni PhotoResponse.status
in BatchUpdatePhotosResponse.results
. Consulta photo.update
per gli errori specifici che possono verificarsi per ciascuna foto.
Vengono utilizzati solo i campi specificati nel campo updateMask
. Se updateMask
non è presente, l'aggiornamento si applica a tutti i campi.
Il numero di messaggi UpdatePhotoRequest
in un BatchUpdatePhotosRequest
non deve essere maggiore di 20.
Nota: per aggiornare Pose.altitude
, è necessario compilare anche Pose.latLngPair
. In caso contrario, la richiesta non andrà a buon fine.
Richiesta HTTP
POST https://streetviewpublish.googleapis.com/v1/photos:batchUpdate
L'URL utilizza la sintassi di transcodifica gRPC.
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
{
"updatePhotoRequests": [
{
"photo": {
object (Photo )
},
"updateMask": string
}
]
} |
Campi |
updatePhotoRequests[] |
object
Obbligatorio. Elenco di UpdatePhotoRequests .
|
updatePhotoRequests[].photo |
object (Photo )
Obbligatorio. Oggetto Photo contenente i nuovi metadati.
|
updatePhotoRequests[].updateMask |
string (FieldMask format)
Obbligatorio. Maschera che identifica i campi sui metadati della foto da aggiornare. Se non presenti, i vecchi metadati Photo vengono completamente sostituiti con i nuovi metadati Photo in questa richiesta. Se vengono specificati campi non validi, l'aggiornamento non va a buon fine. È possibile specificare più campi in un elenco delimitato da virgole. I seguenti campi sono validi:
pose.heading
pose.lat_lng_pair
pose.pitch
pose.roll
pose.level
pose.altitude
connections
places
Nota: quando updateMask contiene campi ripetuti, l'intero insieme di valori ripetuti viene sostituito con i nuovi contenuti. Ad esempio, se updateMask contiene connections e UpdatePhotoRequest.photo.connections è vuoto, tutte le connessioni vengono rimosse.
|
Corpo della risposta
Risposta all'aggiornamento collettivo dei metadati di uno o più Photos
.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
{
"results": [
{
object (PhotoResponse )
}
]
} |
Campi |
results[] |
object (PhotoResponse )
Elenco di risultati per ogni singolo Photo aggiornato, nello stesso ordine della richiesta.
|
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/streetviewpublish
Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-09-10 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2024-09-10 UTC."],[[["The API updates metadata of photos, such as pose, connections, and place association, but does not change pixel data."],["Requests are submitted as a batch of up to 20 `UpdatePhotoRequest` messages specifying the photo and fields to update."],["If the `updateMask` is not provided, all fields of the Photo resource will be updated with the values provided in the request."],["When updating `Pose.altitude`, `Pose.latLngPair` must also be specified, or the request will fail."],["This API requires the `https://www.googleapis.com/auth/streetviewpublish` OAuth scope for authorization."]]],["This document details the process of updating photo metadata via the `photos:batchUpdate` method. It outlines that you can update fields like pose, place association, and connections, but not photo pixels. The request involves sending `UpdatePhotoRequests` within a `BatchUpdatePhotosRequest` to `POST https://streetviewpublish.googleapis.com/v1/photos:batchUpdate`. An `updateMask` specifies which fields to modify. The response contains a list of `PhotoResponse` objects, indicating the success or failure of each photo update. A maximum of 20 `UpdatePhotoRequest` messages are allowed.\n"]]