Method: photos.batchUpdate

Atualiza os metadados de Photos, como pose, associação de lugares, conexões etc. Não é possível alterar os pixels das fotos.

Se photos.batchUpdate falhar, os campos críticos vão estar ausentes ou haverá um erro de autenticação. Mesmo que photos.batchUpdate seja bem-sucedido, as fotos individuais no lote podem ter falhas. Essas falhas são especificadas em cada PhotoResponse.status em BatchUpdatePhotosResponse.results. Consulte photo.update para conferir falhas específicas que podem ocorrer por foto.

Somente os campos especificados em updateMask são usados. Se updateMask não estiver presente, a atualização será aplicada a todos os campos.

O número de mensagens UpdatePhotoRequest em uma BatchUpdatePhotosRequest não pode exceder 20.

Observação: para atualizar Pose.altitude, Pose.latLngPair também precisa ser preenchido. Caso contrário, a solicitação falhará.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "updatePhotoRequests": [
    {
      "photo": {
        object (Photo)
      },
      "updateMask": string
    }
  ]
}
Campos
updatePhotoRequests[]

object

Obrigatório. Lista de UpdatePhotoRequests.

updatePhotoRequests[].photo

object (Photo)

Obrigatório. Objeto Photo que contém os novos metadados.

updatePhotoRequests[].updateMask

string (FieldMask format)

Obrigatório. Máscara que identifica campos nos metadados da foto a serem atualizados. Se não estiverem presentes, os metadados Photo antigos serão completamente substituídos pelos novos metadados Photo na solicitação. A atualização falhará se campos inválidos forem especificados. Vários campos podem ser especificados em uma lista delimitada por vírgulas.

Os seguintes campos são válidos:

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

Observação: quando updateMask tiver campos repetidos, todo o conjunto de valores repetidos será substituído pelo novo conteúdo. Por exemplo, se updateMask contiver connections e UpdatePhotoRequest.photo.connections estiver vazio, todas as conexões serão removidas.

Corpo da resposta

Resposta à atualização em lote de metadados de um ou mais Photos.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "results": [
    {
      object (PhotoResponse)
    }
  ]
}
Campos
results[]

object (PhotoResponse)

Lista de resultados atualizada para cada Photo individual, na mesma ordem da solicitação.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.