Method: photos.batchUpdate

Met à jour les métadonnées de Photos, telles que la pose, le lieu associé, les liens, etc. Il n'est pas possible de modifier les pixels des photos.

Notez que si photos.batchUpdate échoue, des champs critiques sont manquants ou une erreur d'authentification se produit. Même si photos.batchUpdate réussit, des photos individuelles du lot peuvent présenter des échecs. Ces échecs sont spécifiés dans chaque PhotoResponse.status de BatchUpdatePhotosResponse.results. Consultez photo.update pour connaître les échecs spécifiques pouvant survenir pour chaque 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 une BatchUpdatePhotosRequest ne doit pas dépasser 20.

Remarque: Pour mettre à jour Pose.altitude, le champ 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 de 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 à mettre à jour dans les métadonnées de la photo. Si elles sont absentes, 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 d'éléments séparés par une virgule.

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 à une mise à jour groupée des métadonnées d'un ou de plusieurs éléments 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 individuel mis à jour, dans le même ordre que celui de la requête.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la présentation d'OAuth 2.0.