Bir veri kümesiyle ilgili bilgileri güncellemek için veri kümesinin kimliğini de içeren patch dataset uç noktasına bir HTTP PATCH
isteği gönderin:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID
Veri kümesinin displayName
ve description
özelliklerinden birini veya her ikisini de 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üncellenen 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
Varsayılan olarak güncelleme, isteğin 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
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, istek gövdesinde belirtilen desteklenen tüm alanların güncelleneceği anlamına gelir.