عدِّل معلومات عن مجموعة بيانات عن طريق إرسال طلب 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
هي *
، ما يعني تعديل جميع الحقول المتوافقة والمحددة في نص الطلب.