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

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