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