Cập nhật thông tin về một tập dữ liệu bằng cách gửi một yêu cầu HTTP PATCH
đến điểm cuối bản vá tập dữ liệu cũng bao gồm mã nhận dạng của tập dữ liệu:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID
Bạn có thể cập nhật một hoặc cả hai thuộc tính displayName
và description
của tập dữ liệu.
Ví dụ:
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
Yêu cầu này sẽ trả về thông tin về tập dữ liệu đã cập nhật:
{ "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" } }
Chỉ định mặt nạ trường
Theo mặc định, bản cập nhật này sẽ sửa đổi mọi trường được hỗ trợ được chỉ định trong phần nội dung của yêu cầu, nghĩa là cả displayName
và description
. Tuy nhiên, bạn cũng có thể đưa tham số truy vấn updateMask
vào yêu cầu để chỉ định rõ ràng các trường trong nội dung yêu cầu cần cập nhật.
Sử dụng updateMask
để chỉ định một danh sách được phân tách bằng dấu phẩy gồm các tên trường đủ điều kiện cần cập nhật. Ví dụ: để chỉ cập nhật trường 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
Giá trị mặc định của tham số truy vấn updateMask
là *
, nghĩa là cập nhật tất cả các trường được hỗ trợ đã chỉ định trong nội dung yêu cầu.