تعديل مجموعة بيانات

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