Method: photos.batchUpdate

Aggiorna i metadati di Photos, ad esempio posa, associazione di luoghi, connessioni e così via. La modifica dei pixel delle foto non è supportata.

Tieni presente che se photos.batchUpdate non va a buon fine, mancano campi critici o si è verificato un errore di autenticazione. Anche se photos.batchUpdate ha esito positivo, singole foto nel batch potrebbero non essere caricate. Questi errori sono specificati in ogni PhotoResponse.status in BatchUpdatePhotosResponse.results. Consulta photo.update per gli errori specifici che possono verificarsi per 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 superare 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 nei metadati della foto da aggiornare. Se non sono presenti, i vecchi metadati Photo vengono completamente sostituiti dai 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.

Sono validi i seguenti campi:

  • 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, vengono rimossi tutti i collegamenti.

Corpo della risposta

Risposta all'aggiornamento batch 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 OAuth 2.0 Overview.