Atualizar um conjunto de dados

Para atualizar informações sobre um conjunto de dados, envie uma solicitação HTTP PATCH ao endpoint patch dataset, que 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 compatíveis especificados no corpo da solicitação, ou seja, displayName e description. No entanto, você também pode incluir o parâmetro de consulta updateMask na solicitação para especificar explicitamente os campos no corpo da solicitação que serão atualizados.

Use updateMask para especificar uma lista separada por vírgulas de nomes totalmente qualificados de campos 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 atualizar todos os campos compatíveis especificados no corpo da solicitação.