Method: photos.batchUpdate

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

Se photos.batchUpdate falhar, significa que campos críticos estão ausentes ou há 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 ver 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 vai 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, também é necessário preencher Pose.latLngPair. 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 totalmente substituídos pelos novos 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 para 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 de cada Photo individual atualizada, 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.