Aggiorna un set di dati

Aggiorna le informazioni su un set di dati inviando una richiesta PATCH HTTP al l'endpoint patch dataset 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, vale a dire sia displayName sia description. Tuttavia, puoi includono anche updateMask parametro di query nella richiesta per specificare esplicitamente i campi nel del corpo della richiesta di aggiornamento.

Utilizza updateMask per specificare un elenco separato da virgole di nomi completi di 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 aggiorna tutti i campi supportati specificati nel corpo della richiesta.