Senden Sie eine HTTP-PATCH
-Anfrage an den Endpunkt Patch-Dataset, um Informationen zu einem Dataset zu aktualisieren. Die Anfrage muss auch die ID des Datasets enthalten:
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
Bei der Aktualisierung werden standardmäßig 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.
Mit updateMask
können Sie eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen angeben, 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 *
. Das bedeutet, dass alle unterstützten Felder aktualisiert werden, die im Anfragetext angegeben sind.