Method: photos.batchUpdate
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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.headingpose.lat_lng_pairpose.pitchpose.rollpose.levelpose.altitudeconnectionsplaces
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:
| 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.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-09-10 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2024-09-10 UTC."],[[["The API updates metadata of photos, such as pose, connections, and place association, but does not change pixel data."],["Requests are submitted as a batch of up to 20 `UpdatePhotoRequest` messages specifying the photo and fields to update."],["If the `updateMask` is not provided, all fields of the Photo resource will be updated with the values provided in the request."],["When updating `Pose.altitude`, `Pose.latLngPair` must also be specified, or the request will fail."],["This API requires the `https://www.googleapis.com/auth/streetviewpublish` OAuth scope for authorization."]]],["This document details the process of updating photo metadata via the `photos:batchUpdate` method. It outlines that you can update fields like pose, place association, and connections, but not photo pixels. The request involves sending `UpdatePhotoRequests` within a `BatchUpdatePhotosRequest` to `POST https://streetviewpublish.googleapis.com/v1/photos:batchUpdate`. An `updateMask` specifies which fields to modify. The response contains a list of `PhotoResponse` objects, indicating the success or failure of each photo update. A maximum of 20 `UpdatePhotoRequest` messages are allowed.\n"]]
