Aggiorna le informazioni su un set di dati inviando una richiesta PATCH HTTP all'endpoint del set di dati patch che include anche l'ID del set di dati:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID
Puoi aggiornare una o entrambe le proprietà displayName e description del set di dati. Ad esempio:
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 richiesta restituisce informazioni sul set di dati aggiornato:
{
"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"
}
}
Specifica una maschera per il campo
Per impostazione predefinita, l'aggiornamento modifica tutti i campi supportati specificati nel corpo della richiesta, ovvero sia displayName che description. Tuttavia, puoi includere nella richiesta anche il parametro di query updateMask per specificare esplicitamente i campi da aggiornare nel corpo della richiesta.
Utilizza updateMask per specificare un elenco separato da virgole di nomi completi dei campi da aggiornare. Ad esempio, per aggiornare solo il 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
Il valore predefinito del parametro di query updateMask è *, che significa
aggiornare tutti i campi supportati specificati nel corpo della richiesta.