با ارسال درخواست HTTP PATCH به نقطه پایانی مجموعه داده وصله که شامل شناسه مجموعه داده نیز میشود، اطلاعات مربوط به مجموعه داده را بهروز کنید:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID
میتوانید یک یا هر دو دارایی displayName و description را
مجموعه داده بهروز کنید.
برای مثال:
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"درخواست اطلاعات مربوط به مجموعه داده بهروزشده را برمیگرداند:
{
"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"
}
}
پوشش فیلد را مشخص کنید
بهطور پیشفرض، بهروزرسانی همه فیلدهای پشتیبانیشده مشخصشده در بدنه درخواست را اصلاح میکند، یعنی هم displayName و هم description. بااینحال، میتوانید
پارامتر پُرسمان
updateMask
را نیز در درخواست بگنجانید تا فیلدهای موجود در
بدنه درخواست را برای بهروزرسانی بهطور صریح مشخص کنید.
از updateMask برای مشخص کردن فهرست جداشده با کاما از نامهای کاملاً واجدشرایط
فیلدها برای بهروزرسانی استفاده کنید. برای مثال، برای بهروز کردن فقط فیلد 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"مقدار پیشفرض پارامتر پُرسمان updateMask * است، یعنی
همه فیلدهای پشتیبانیشده مشخصشده در بدنه درخواست بهروزرسانی شوند.