Memperbarui set data

Perbarui informasi tentang set data dengan mengirimkan permintaan PATCH HTTP ke endpoint set data patch yang juga menyertakan ID set data:

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

Anda dapat memperbarui salah satu atau kedua properti displayName dan description set data. Contoh:

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

Permintaan tersebut menampilkan informasi tentang set data yang diperbarui:

{
  "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"
  }
}

Menentukan mask kolom

Secara default, update akan mengubah semua kolom didukung yang ditentukan dalam isi permintaan, yang berarti displayName dan description. Namun, Anda juga dapat menyertakan parameter kueri updateMask dalam permintaan untuk secara eksplisit menentukan kolom dalam isi permintaan yang akan diperbarui.

Gunakan updateMask untuk menentukan daftar yang dipisahkan koma yang berisi nama kolom yang sepenuhnya memenuhi syarat yang akan diperbarui. Misalnya, untuk memperbarui kolom displayName saja:

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

Nilai default parameter kueri updateMask adalah *, yang berarti memperbarui semua kolom yang didukung yang ditentukan dalam isi permintaan.