Memperbarui set data

Perbarui informasi tentang set data dengan mengirim permintaan PATCH HTTP ke endpoint patch dataset 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 dari 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 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, pembaruan mengubah semua kolom yang didukung yang ditentukan dalam isi permintaan, yang berarti displayName dan description. Namun, Anda juga dapat menyertakan parameter kueri updateMask dalam permintaan untuk menentukan kolom dalam isi permintaan yang akan diperbarui secara eksplisit.

Gunakan updateMask untuk menentukan daftar yang dipisahkan koma dari nama-nama kolom yang sepenuhnya memenuhi syarat untuk diperbarui. Misalnya, untuk memperbarui hanya kolom 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"

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