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