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

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

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