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, pembaruan akan 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 secara eksplisit dalam isi permintaan yang akan diperbarui.

Gunakan updateMask untuk menentukan daftar yang dipisahkan koma dari nama kolom yang sepenuhnya memenuhi syarat untuk 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.