Actualiza un conjunto de datos

Para actualizar la información sobre un conjunto de datos, envía una solicitud HTTP PATCH al extremo patch dataset que también incluye el ID del conjunto de datos:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID

Puedes actualizar una o ambas propiedades displayName y description del conjunto de datos.

Por ejemplo:

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"

La solicitud devuelve información sobre el conjunto de datos actualizado:

{
  "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"
  }
}

Cómo especificar una máscara de campo

De forma predeterminada, la actualización modifica todos los campos admitidos especificados en el cuerpo de la solicitud, es decir, tanto displayName como description. Sin embargo, también puedes incluir el parámetro de consulta updateMask en la solicitud para especificar de forma explícita los campos del cuerpo de la solicitud que se actualizarán.

Usa updateMask para especificar una lista separada por comas de los nombres de campos completamente calificados que se actualizarán. Por ejemplo, para actualizar solo el campo displayName, haz lo siguiente:

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"

El valor predeterminado del parámetro de consulta updateMask es *, lo que significa que se actualizarán todos los campos admitidos especificados en el cuerpo de la solicitud.