Aggiorna un set di dati

Aggiorna le informazioni su un set di dati inviando una richiesta PATCH HTTP all'endpoint del set di dati delle 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"
  }
}

Specificare una maschera dei campi

Per impostazione predefinita, l'aggiornamento modifica tutti i campi supportati specificati nel corpo della richiesta, ovvero sia displayName sia description. Tuttavia, puoi anche includere il parametro di query updateMask nella richiesta 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 è *, il che significa che aggiorna tutti i campi supportati specificati nel corpo della richiesta.