Wenn Sie Informationen zu einem Dataset aktualisieren möchten, senden Sie 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 das Attribut displayName oder das Attribut description des Datasets oder beide 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 ändert das Update alle unterstützten Felder, die im Text der Anfrage angegeben sind, also sowohl displayName als auch description. Sie können jedoch auch den Abfrageparameter updateMask in die Anfrage einfügen, um explizit die Felder im Anfragetext anzugeben, die aktualisiert werden sollen.
Verwenden Sie updateMask, um eine durch Kommas getrennte Liste voll qualifizierter 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.