Method: photos.batchUpdate

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

Ten en cuenta que, si photos.batchUpdate falla, significa que faltan campos críticos o hay un error de autenticación. Incluso si photos.batchUpdate se realiza correctamente, es posible que las fotos individuales del lote tengan errores. Estas fallas se especifican en cada PhotoResponse.status de BatchUpdatePhotosResponse.results. Consulta photo.update para ver 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 campos en los metadatos de la foto que se actualizarán. Si no están presentes, 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 de valores delimitados con coma.

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, se reemplaza todo el conjunto de valores repetidos 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 para cada Photo individual, en el mismo orden que la solicitud.

Alcances 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.