Aktualisieren Sie Informationen zu einem Dataset. Senden Sie dazu eine HTTP-PATCH-Anfrage an den Endpunkt des Patch-Datasets, die auch die ID des Datasets enthält:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID
Sie können eines oder beide Attribute displayName und description des Datasets aktualisieren.
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 Text der Anfrage angegeben sind, also sowohl displayName als auch description. Sie können aber auch den Abfrageparameter updateMask in die Anfrage einfügen, um die Felder im Anfragetext, die aktualisiert werden sollen, explizit anzugeben.
Verwenden Sie updateMask, um eine durch Kommas getrennte Liste mit vollständig qualifizierten Namen der zu aktualisierenden Felder anzugeben. 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 *. Das bedeutet, dass alle unterstützten Felder aktualisiert werden, die im Anfragetext angegeben sind.