Dataset aktualisieren

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

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

Sie können die Attribute displayName und description des Datasets einzeln 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 zum aktualisierten 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 durch das Update 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 vollständig qualifizierter Feldnamen anzugeben, die aktualisiert werden sollen. Wenn Sie beispielsweise nur das Feld displayName aktualisieren möchten:

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.