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

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