डेटासेट अपडेट करना

पैच डेटासेट के एंडपॉइंट पर एचटीटीपी 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 क्वेरी पैरामीटर की डिफ़ॉल्ट वैल्यू * है. इसका मतलब है कि अनुरोध के मुख्य हिस्से में दिए गए उन सभी फ़ील्ड को अपडेट करें जिन्हें इस्तेमाल किया जा सकता है.