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

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