Method: photos.batchUpdate

Consente di aggiornare 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 va a buon fine, i campi critici sono mancanti o è presente un errore di autenticazione. Anche se l'operazione photos.batchUpdate ha esito positivo, le singole foto del batch potrebbero presentare errori. Questi errori sono specificati in ogni PhotoResponse.status in BatchUpdatePhotosResponse.results. Visita la pagina photo.update per conoscere 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 BatchUpdatePhotosRequest non deve essere maggiore di 20.

Nota: per aggiornare Pose.altitude, è necessario compilare anche il campo Pose.latLngPair. In caso contrario, la richiesta avrà esito negativo.

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. Photo contenente i nuovi metadati.
updatePhotoRequests[].updateMask

string (FieldMask format)

Obbligatorio. Maschera che identifica i campi nei metadati della foto da aggiornare. Se non sono presenti, i vecchi metadati Photo vengono completamente sostituiti con i nuovi metadati Photo in questa richiesta. L'aggiornamento non riesce se vengono specificati campi non validi. È 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 dei 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.