Actualiza un conjunto de datos

Actualiza la información sobre un conjunto de datos enviando 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 cualquiera de las propiedades displayName y description del conjunto de datos, o ambas.

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 que se actualizarán en el cuerpo de la solicitud.

Usa updateMask para especificar una lista separada por comas de los nombres de campos completamente calificados que se deben actualizar. 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 búsqueda updateMask es *, lo que significa que se actualizarán todos los campos admitidos especificados en el cuerpo de la solicitud.