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

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