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

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