Method: photos.batchUpdate

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

Ten en cuenta que si photos.batchUpdate falla, falta algún campo crítico o hay un error de autenticación. Incluso si photos.batchUpdate tiene éxito, las fotos individuales en el lote pueden tener errores. Estas fallas se especifican en cada PhotoResponse.status de 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 ser superior a 20.

Nota: Para actualizar Pose.altitude, también debes 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. 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 deben actualizar. Si no están presentes, los metadatos Photo anteriores se reemplazan por los metadatos Photo nuevos en esta solicitud. La actualización fallará 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.latLngPair
  • 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 quitan todas las conexiones.

Cuerpo de la respuesta

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

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

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.

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