Method: photos.batchUpdate

Mise à jour des métadonnées de Photos, telles que la pose, l'association de lieu, les connexions, etc. Il n'est pas possible de modifier les pixels des photos.

Notez que si photos.batchUpdate échoue, cela signifie que des champs critiques sont manquants ou qu'il y a une erreur d'authentification. Même si photos.batchUpdate réussit, des échecs peuvent se produire pour des photos individuelles du lot. Ces échecs sont spécifiés dans chaque PhotoResponse.status de BatchUpdatePhotosResponse.results. Consultez photo.update pour connaître les échecs spécifiques qui peuvent se produire par photo.

Seuls les champs spécifiés dans le champ updateMask sont utilisés. Si updateMask n'est pas présent, la mise à jour s'applique à tous les champs.

Le nombre de messages UpdatePhotoRequest dans un BatchUpdatePhotosRequest ne doit pas dépasser 20.

Remarque : Pour mettre à jour Pose.altitude, Pose.latLngPair doit également être renseigné. À défaut, la requête échouera.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "updatePhotoRequests": [
    {
      "photo": {
        object (Photo)
      },
      "updateMask": string
    }
  ]
}
Champs
updatePhotoRequests[]

object

Obligatoire. Liste des UpdatePhotoRequests.
updatePhotoRequests[].photo

object (Photo)

Obligatoire. Objet Photo contenant les nouvelles métadonnées.
updatePhotoRequests[].updateMask

string (FieldMask format)

Obligatoire. Masque qui identifie les champs des métadonnées de la photo à mettre à jour. Si elle n'est pas présente, les anciennes métadonnées Photo sont entièrement remplacées par les nouvelles métadonnées Photo dans cette requête. La mise à jour échoue si des champs non valides sont spécifiés. Vous pouvez spécifier plusieurs champs dans une liste séparée par des virgules.

Les champs suivants sont valides :

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

Remarque : Lorsque updateMask contient des champs répétés, l'ensemble des valeurs répétées est remplacé par le nouveau contenu. Par exemple, si updateMask contient connections et que UpdatePhotoRequest.photo.connections est vide, toutes les connexions sont supprimées.

Corps de la réponse

Réponse à la mise à jour par lot des métadonnées d'un ou plusieurs Photos.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "results": [
    {
      object (PhotoResponse)
    }
  ]
}
Champs
results[]

object (PhotoResponse)

Liste des résultats pour chaque Photo mis à jour, dans le même ordre que la requête.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la OAuth 2.0 Overview.