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

يمكنك تعديل معلومات عن مجموعة بيانات من خلال إرسال طلب PATCH HTTP إلى نقطة نهاية تعديل مجموعة البيانات التي تضم أيضًا معرّف مجموعة البيانات:

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