Method: photos.batchUpdate

Aktualisiert die Metadaten von Photos, z. B. Pose, Ortszuordnung und Verbindungen. Das Ändern der Pixel von Fotos wird nicht unterstützt.

Wenn photos.batchUpdate fehlschlägt, fehlen entweder kritische Felder oder es liegt ein Authentifizierungsfehler vor. Auch wenn photos.batchUpdate erfolgreich ist, können bei einzelnen Fotos im Batch Fehler auftreten. Diese Fehler werden in jedem PhotoResponse.status in BatchUpdatePhotosResponse.results angegeben. Unter photo.update finden Sie Informationen zu spezifischen Fehlern, die pro Foto auftreten können.

Es werden nur die im Feld updateMask angegebenen Felder verwendet. Wenn updateMask nicht vorhanden ist, gilt die Aktualisierung für alle Felder.

Die Anzahl der UpdatePhotoRequest-Nachrichten in einem BatchUpdatePhotosRequest darf 20 nicht überschreiten.

Hinweis: Wenn Sie Pose.altitude aktualisieren möchten, muss auch Pose.latLngPair ausgefüllt sein. Andernfalls scheitert die Anfrage.

HTTP-Anfrage

POST https://streetviewpublish.googleapis.com/v1/photos:batchUpdate

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "updatePhotoRequests": [
    {
      "photo": {
        object (Photo)
      },
      "updateMask": string
    }
  ]
}
Felder
updatePhotoRequests[]

object

Erforderlich. Liste von UpdatePhotoRequests.
updatePhotoRequests[].photo

object (Photo)

Erforderlich. Photo-Objekt mit den neuen Metadaten.
updatePhotoRequests[].updateMask

string (FieldMask format)

Erforderlich. Maske, die Felder in den Fotometadaten angibt, die aktualisiert werden sollen. Wenn nicht vorhanden, werden die alten Photo-Metadaten in dieser Anfrage vollständig durch die neuen Photo-Metadaten ersetzt. Die Aktualisierung schlägt fehl, wenn ungültige Felder angegeben sind. Mehrere Felder können in einer durch Kommas getrennten Liste angegeben werden.

Die folgenden Felder sind gültig:

  • pose.heading
  • pose.lat_lng_pair
  • pose.pitch
  • pose.roll
  • pose.level
  • pose.altitude
  • connections
  • places

Hinweis: Wenn updateMask wiederholte Felder enthält, wird die gesamte Gruppe der wiederholten Werte durch den neuen Inhalt ersetzt. Wenn updateMask beispielsweise connections enthält und UpdatePhotoRequest.photo.connections leer ist, werden alle Verbindungen entfernt.

Antworttext

Antwort auf die Batch-Aktualisierung von Metadaten für ein oder mehrere Photos.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "results": [
    {
      object (PhotoResponse)
    }
  ]
}
Felder
results[]

object (PhotoResponse)

Liste der Ergebnisse für jede einzelne aktualisierte Photo in derselben Reihenfolge wie in der Anfrage.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/streetviewpublish

Weitere Informationen finden Sie unter OAuth 2.0 Overview.