Dataset aktualisieren

Senden Sie zum Aktualisieren von Informationen zu einem Dataset eine PATCH-HTTP-Anfrage an den Endpunkt für das Patch-Dataset. 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 die Eigenschaften 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 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 jedoch auch den updateMask Abfrageparameter in die Anfrage einfügen, um die Felder im Anfragetext explizit anzugeben, die aktualisiert werden sollen.

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, verwenden Sie Folgendes:

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.