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

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