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

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