Method: photos.batchUpdate

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

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

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

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

Hinweis: Zum Aktualisieren von Pose.altitude muss auch Pose.latLngPair ausgefüllt werden. 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 mit UpdatePhotoRequests.
updatePhotoRequests[].photo

object (Photo)

Erforderlich. Photo-Objekt, das die neuen Metadaten enthält.
updatePhotoRequests[].updateMask

string (FieldMask format)

Erforderlich. Maske, die Felder in den Fotometadaten identifiziert, die aktualisiert werden sollen. Falls 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 werden. In einer durch Kommas getrennten Liste können mehrere Felder 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 wiederkehrende Felder enthält, wird der gesamte Satz wiederkehrender Werte durch den neuen Inhalt ersetzt. Wenn beispielsweise updateMask connections enthält und UpdatePhotoRequest.photo.connections leer ist, werden alle Verbindungen entfernt.

Antworttext

Antwort auf die Batch-Aktualisierung von Metadaten von einem oder mehreren 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 in der Übersicht über OAuth 2.0.