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

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