Method: photos.batchUpdate

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.