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

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