Memperbarui set data

Memperbarui informasi tentang set data dengan mengirim permintaan PATCH HTTP ke patch set data yang juga menyertakan ID {i>dataset<i}:

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

Anda dapat memperbarui salah satu atau kedua properti displayName dan description tentang suatu {i>dataset.<i}

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 mengubah semua kolom yang didukung yang ditentukan dalam isi permintaan, yang berarti displayName dan description. Namun, Anda dapat juga menyertakan updateMask dalam permintaan untuk menentukan kolom secara eksplisit dalam isi permintaan untuk diperbarui.

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