Para actualizar la información de un conjunto de datos, envía una solicitud HTTP PATCH
al extremo del conjunto de datos de parches 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 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 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 que se actualizarán en el cuerpo de la solicitud.
Usa updateMask
para especificar una lista separada por comas de 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 deben actualizar todos los campos admitidos especificados en el cuerpo de la solicitud.