Method: photos.batchUpdate

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

Se photos.batchUpdate falhar, isso significa que campos críticos estão faltando 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 no campo 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 um 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 os campos nos metadados da foto a serem atualizados. Se não estiver presente, os metadados Photo antigos serão totalmente substituídos pelos novos metadados Photo nesta solicitação. A atualização falha se campos inválidos forem especificados. É possível especificar vários campos 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 contém campos repetidos, todo o conjunto de valores repetidos é 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 para cada Photo atualizado, 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 OAuth 2.0 Overview.