Dataset aktualisieren

Aktualisieren Sie Informationen zu einem Dataset, indem Sie eine HTTP-PATCH-Anfrage an den Dataset patchen, enthält auch die ID des Datasets:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID

Du kannst eine oder beide Properties displayName und description aktualisieren des Datasets.

Beispiel:

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"

Die Anfrage gibt Informationen über das aktualisierte Dataset zurück:

{
  "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"
  }
}

Feldmaske angeben

Standardmäßig werden bei der Aktualisierung alle unterstützten Felder geändert, die im Hauptteil angegeben sind. der Anfrage, d. h. sowohl displayName als auch description. Sie können jedoch enthalten auch die updateMask in der Anfrage verwenden, um die Felder in der zu aktualisierender Anfragetext.

Verwenden Sie updateMask, um eine durch Kommas getrennte Liste mit vollständig qualifizierten Namen für Felder, die aktualisiert werden sollen. So aktualisieren Sie beispielsweise nur das Feld 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"

Der Standardwert des Abfrageparameters updateMask ist *. Dies bedeutet, Alle unterstützten Felder aktualisieren, die im Anfragetext angegeben sind.