Dataset aktualisieren

Sie können Informationen zu einem Datensatz aktualisieren, indem Sie eine HTTP-PATCH-Anfrage an den Endpunkt patch dataset senden, die auch die ID des Datensatzes enthält:

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

Sie können entweder die displayName- oder die description-Eigenschaft oder beide Eigenschaften des Datensatzes 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 Datensatz 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 Anfragetext angegeben sind, also sowohl displayName als auch description. Sie können jedoch auch den Abfrageparameter updateMask in die Anfrage aufnehmen, um die zu aktualisierenden Felder im Anfragetext 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 im Anfragetext aktualisiert werden.