يمكنك تعديل معلومات عن مجموعة بيانات من خلال إرسال طلب PATCH
HTTP إلى نقطة نهاية
تعديل مجموعة البيانات التي تضم
أيضًا معرّف مجموعة البيانات:
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
هي *
، ما يعني
تعديل جميع الحقول المتوافقة المحدّدة في نص الطلب.