Method: photos.batchUpdate

Aktualisiert die Metadaten von Photos, z. B. Pose, Ortsverknüpfung oder Verbindungen. 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. 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, wird die Aktualisierung auf alle Felder angewendet.

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

Hinweis: Zum Aktualisieren von Pose.altitude 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 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 sind. 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 wiederholter 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 eines oder mehrerer 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 jeden einzelnen Photo, der aktualisiert wurde, in derselben Reihenfolge wie die Anfrage.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.