Veri kümesi güncelleme

Veri kümesi düzeltme uç noktasına bir HTTP PATCH isteği göndererek veri kümesiyle ilgili bilgileri güncelleyin. Bu istek, veri kümesinin kimliğini de içerir:

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

Veri kümesinin displayName ve description özelliklerinden birini veya ikisini birden güncelleyebilirsiniz.

Örneğin:

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"

İstek, güncellenmiş veri kümesiyle ilgili bilgileri döndürür:

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

Alan maskesi belirtme

Güncelleme, varsayılan olarak istek gövdesinde belirtilen tüm desteklenen alanları (yani hem displayName hem de description) değiştirir. Ancak, istek gövdesinde güncellenecek alanları açıkça belirtmek için isteğe updateMask sorgu parametresini de ekleyebilirsiniz.

Güncellenecek alanların tam nitelikli adlarının virgülle ayrılmış listesini belirtmek için updateMask öğesini kullanın. Örneğin, yalnızca displayName alanını güncellemek için:

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"

updateMask sorgu parametresinin varsayılan değeri *'dir. Bu değer, istek gövdesinde belirtilen tüm desteklenen alanları güncelle anlamına gelir.