Method: photos.batchUpdate

Actualiza los metadatos de Photos, como la pose, la asociación del lugar, las conexiones, etc. No se pueden cambiar los píxeles de las fotos.

Ten en cuenta que, si falla photos.batchUpdate, significa que faltan campos críticos o que hay un error de autenticación. Incluso si photos.batchUpdate funciona correctamente, las fotos individuales del lote pueden tener errores. Estas fallas se especifican en cada PhotoResponse.status de BatchUpdatePhotosResponse.results. Consulta photo.update para conocer las fallas específicas 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 una BatchUpdatePhotosRequest no debe ser superior a 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 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. Lista de UpdatePhotoRequests.
updatePhotoRequests[].photo

object (Photo)

Obligatorio. Un 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án presentes, los metadatos Photo anteriores se reemplazan por completo con los metadatos nuevos de Photo en esta solicitud. La actualización falla si se especifican campos no válidos. Se pueden especificar varios campos en una lista de valores delimitados con 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

Respuesta a la actualización por lotes de 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)

Se actualizó la lista de resultados de cada Photo individual, en el mismo orden que la solicitud.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la Descripción general de OAuth 2.0.