Actualiza un conjunto de datos

Para actualizar la información sobre un conjunto de datos, envía una solicitud PATCH HTTP al extremo de actualización del conjunto de datos 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 compatibles especificados en el cuerpo de la solicitud, lo que significa que se actualizan displayName y description. Sin embargo, también puedes incluir el updateMask parámetro de consulta 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 nombres de campos completamente calificados para actualizar. Por ejemplo, para actualizar solo el 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"

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