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

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