Method: photos.batchUpdate

Met à jour les métadonnées de Photos, telles que la pose, l'association de lieu, les connexions, etc. La modification des pixels des photos n'est pas acceptée.

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 défaillances. Ces échecs sont spécifiés dans chaque PhotoResponse.status du fichier BatchUpdatePhotosResponse.results. Consultez la section photo.update pour connaître les défaillances spécifiques qui peuvent se produire 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, 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 des métadonnées de photo à mettre à jour. Si elles ne sont pas présentes, 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 à la mise à jour par lot des métadonnées d'un ou de 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 en savoir plus, consultez la Présentation d'OAuth 2.0.