किसी ऐसेट को अपडेट करता है. अपडेट करने की प्रोसेस में कई सीमाएं होती हैं:
- एसेट के सिर्फ़
title,description,startTime,endTime, औरpropertiesफ़ील्ड अपडेट किए जा सकते हैं. updateMaskमें"properties"का नाम देने पर, एसेट की सभी उपयोगकर्ता-परिभाषित प्रॉपर्टी,assetमें मौजूद प्रॉपर्टी से बदल जाती हैं.updateMaskमें"title","description","startTime"या"endTime"का नाम देकर,assetमें कोई वैल्यू न देने पर, उस फ़ील्ड की वैल्यू सेट नहीं होती.- अलग-अलग प्रॉपर्टी को अपडेट करने के लिए, उन्हें
updateMaskमें नाम दें, जैसे कि"properties.my_property_name". प्रॉपर्टी की वैल्यू,asset.propertiesकी उसी वैल्यू पर सेट हो जाएगी. अगरasset.propertiesमें कोई मिलती-जुलती वैल्यू नहीं है या कोई वैल्यू है, लेकिन वहNullValueहै, तो प्रॉपर्टी को एसेट से मिटा दिया जाएगा. - प्रॉपर्टी को सिर्फ़ स्ट्रिंग या संख्या वाली वैल्यू पर सेट किया जा सकता है. इसके अलावा,
NullValueकी वैल्यू डालकर भी प्रॉपर्टी को मिटाया जा सकता है. - खाली
updateMaskदेने पर, ऐसेट के टाइमस्टैंप और प्रॉपर्टी,assetमें मौजूद वैल्यू से बदल जाएंगी.
एचटीटीपी अनुरोध
PATCH https://earthengine.googleapis.com/v1alpha/{asset.name=projects/*/assets/**}
यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.
पाथ पैरामीटर
| पैरामीटर | |
|---|---|
asset.name |
ऐसेट का नाम. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:
| JSON के काेड में दिखाना |
|---|
{ "asset": { "cloudStorageLocation": { "uris": [ string ] }, "gcsLocation": { "uris": [ string ] }, "featureViewAssetLocation": { "assetOptions": { object ( |
| फ़ील्ड | |
|---|---|
asset.type |
ऐसेट का टाइप. |
asset.id |
एसेट का आईडी. "projects/*/assets/" प्रीफ़िक्स के बिना |
asset.updateTime |
एसेट में पिछली बार बदलाव करने का समय. आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
asset.title |
ऐसेट का टाइटल. |
asset.description |
एसेट की जानकारी. |
asset.properties |
ऐसेट से जुड़ी की/वैल्यू प्रॉपर्टी. |
asset.startTime |
अगर एसेट से जुड़ा कोई टाइमस्टैंप है, तो वह. उदाहरण के लिए, सैटलाइट इमेज लेने का समय. किसी समयावधि से जुड़ी एसेट के लिए, यह टाइमस्टैंप उस समयावधि की शुरुआत से जुड़ा होता है. जैसे, किसी महीने या साल की औसत वैल्यू. आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
asset.endTime |
किसी समयावधि से जुड़ी ऐसेट के लिए, यह टाइमस्टैंप उस समयावधि के खत्म होने का होता है. जैसे, एक महीने या साल की औसत वैल्यू. आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
asset.geometry |
अगर ऐसेट से जुड़ा कोई स्पेस फ़ुटप्रिंट है, तो उसे GeoJSON ज्यामिति ऑब्जेक्ट के तौर पर दिखाएं (RFC 7946 देखें). |
asset.bands[] |
इमेज ऐसेट के डेटा बैंड के बारे में जानकारी. इमेज ऐसेट के लिए नहीं दिखाया जाता. |
asset.sizeBytes |
किसी लीफ़ ऐसेट (जैसे, इमेज) का साइज़, बाइट में. |
asset.featureCount |
अगर लागू हो, तो ऐसेट में मौजूद सुविधाओं की संख्या. |
asset.quota |
फ़ोल्डर ऐसेट से जुड़ा कोटा, अगर कोई है. यह वैल्यू, उपयोगकर्ता के मालिकाना हक वाली टॉप-लेवल फ़ोल्डर एसेट (जैसे, "users/*" या "projects/*") के लिए दिखती है. |
asset.tilesets[] |
इस इमेज के बैकग्राउंड में इस्तेमाल होने वाले टाइलसेट. यह सिर्फ़ उन बाहरी इमेज के लिए मौजूद होता है जिनके पिक्सल, Earth Engine के मालिकाना हक वाले स्टोरेज से नहीं लिए जाते. |
updateMask |
अपडेट मास्क, जो बताता है कि ऐसेट के किन फ़ील्ड को अपडेट करना है. यह फ़ील्ड के पूरी तरह से क्वालिफ़ाइड नामों की सूची है. इसमें नामों को कॉमा लगाकर अलग किया गया है. उदाहरण: |
यूनियन फ़ील्ड location. रेस्टर टाइल कहां और कैसे सेव की जाती हैं, इस बारे में जानकारी. location इनमें से कोई एक हो सकता है: |
|
asset.cloudStorageLocation |
समर्थन नहीं होना या रुकना. इसके बजाय, |
asset.gcsLocation |
समर्थन नहीं होना या रुकना. इसके बजाय, |
asset.featureViewAssetLocation |
एस्टोनिया में इस FeatureView की जगह. |
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में EarthEngineAsset का एक इंस्टेंस शामिल किया जाता है.
अनुमति के दायरे
इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/earthenginehttps://www.googleapis.com/auth/cloud-platform
ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.