Actualiza un conjunto de datos

Para actualizar la información de un conjunto de datos, envía una solicitud HTTP PATCH al extremo patch dataset que también incluya 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 muestra 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"
  }
}

Especifica 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, displayName y description. Sin embargo, también puedes incluir el parámetro de consulta updateMask en la solicitud para especificar de forma explícita los campos en el cuerpo de la solicitud que deseas actualizar.

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 actualizan todos los campos compatibles especificados en el cuerpo de la solicitud.