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

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