Method: photos.batchUpdate

Actualiza los metadatos de Photos, como la posición, la asociación de lugares, las conexiones, etcétera. No se admite el cambio de los píxeles de las fotos.

Ten en cuenta que, si falla photos.batchUpdate, faltan campos críticos o hay un error de autenticación. Incluso si photos.batchUpdate se ejecuta correctamente, es posible que algunas fotos individuales del lote tengan errores. Estas fallas se especifican en cada PhotoResponse.status en BatchUpdatePhotosResponse.results. Consulta photo.update para ver los errores específicos que pueden ocurrir por foto.

Solo se usan los campos especificados en el campo updateMask. Si updateMask no está presente, la actualización se aplica a todos los campos.

La cantidad de mensajes UpdatePhotoRequest en un BatchUpdatePhotosRequest no debe superar los 20.

Nota: Para actualizar Pose.altitude, también se debe completar Pose.latLngPair. De lo contrario, la solicitud fallará.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación de gRPC.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "updatePhotoRequests": [
    {
      "photo": {
        object (Photo)
      },
      "updateMask": string
    }
  ]
}
Campos
updatePhotoRequests[]

object

Obligatorio. Es una lista de UpdatePhotoRequests.
updatePhotoRequests[].photo

object (Photo)

Obligatorio. Objeto Photo que contiene los metadatos nuevos.
updatePhotoRequests[].updateMask

string (FieldMask format)

Obligatorio. Máscara que identifica los campos de los metadatos de la foto que se actualizarán. Si no está presente, los metadatos Photo anteriores se reemplazan por completo con los nuevos metadatos Photo en esta solicitud. La actualización falla si se especifican campos no válidos. Se pueden especificar varios campos en una lista delimitada por comas.

Los siguientes campos son válidos:

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

Nota: Cuando updateMask contiene campos repetidos, todo el conjunto de valores repetidos se reemplaza por el contenido nuevo. Por ejemplo, si updateMask contiene connections y UpdatePhotoRequest.photo.connections está vacío, se quitarán todas las conexiones.

Cuerpo de la respuesta

Es la respuesta a la actualización por lotes de los metadatos de uno o más Photos.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "results": [
    {
      object (PhotoResponse)
    }
  ]
}
Campos
results[]

object (PhotoResponse)

Es la lista de resultados para cada Photo individual actualizado, en el mismo orden que en la solicitud.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.