Atualize as informações sobre um conjunto de dados enviando uma solicitação PATCH
HTTP para o
um endpoint do conjunto de dados de patch
também inclui o ID do conjunto de dados:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID
É possível atualizar uma ou ambas as propriedades displayName
e description
do conjunto de dados.
Exemplo:
curl -X PATCH -d '{ "displayName": "My Updated Dataset", "description": "This is an updated description" }' \ -H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $TOKEN" \ "https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46"
A solicitação retorna informações sobre o conjunto de dados atualizado:
{ "name": "projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46", "displayName": "My Updated Dataset", "description": "This is an updated description", "versionId": "5fb3b84e-1405-4ecd-8f81-9183631f1c07", "usage": [ "USAGE_DATA_DRIVEN_STYLING" ], "gcsSource": { "inputUri": "gs://mybucket/my.csv", "fileFormat": "FILE_FORMAT_CSV" }, "createTime": "2023-03-24T14:47:37.308977Z", "updateTime": "2023-03-28T15:17:17.919351Z", "versionCreateTime": "2023-03-24T14:48:05.053114Z", "status": { "state": "STATE_COMPLETED" } }
Especificar uma máscara de campo
Por padrão, a atualização modifica todos os campos permitidos especificados no corpo
da solicitação, ou seja, displayName
e description
. No entanto, é possível
também incluem
updateMask
parâmetro de consulta na solicitação para especificar explicitamente os campos na
corpo da solicitação a ser atualizado.
Use updateMask
para especificar uma lista separada por vírgulas de nomes totalmente qualificados de
a serem atualizados. Por exemplo, para atualizar apenas o campo displayName
:
curl -X PATCH -d '{ "displayName": "My Updated Dataset", "description": "This is an updated description" }' \ -H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $TOKEN" \ "https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46?updateMask=displayName"
O valor padrão do parâmetro de consulta updateMask
é *
, o que significa
atualiza todos os campos aceitos especificados no corpo da solicitação.