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