किसी ऐसेट को अपडेट करता है. अपडेट करने की कार्रवाई पर कई पाबंदियां हैं:
- ऐसेट के सिर्फ़
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 ज्यामिति ऑब्जेक्ट के तौर पर होता है. इसके बारे में जानने के लिए, आरएफ़सी 7946 देखें. |
asset.bands[] |
इमेज ऐसेट के डेटा बैंड के बारे में जानकारी. इमेज के अलावा अन्य ऐसेट के लिए, इसे शामिल नहीं किया जाता. |
asset.sizeBytes |
किसी लीफ़ ऐसेट (जैसे, इमेज) का साइज़, बाइट में. |
asset.featureCount |
अगर लागू हो, तो ऐसेट में मौजूद सुविधाओं की संख्या. |
asset.quota |
फ़ोल्डर ऐसेट से जुड़ी कोटा की जानकारी. अगर कोई है, तो. यह उपयोगकर्ता के मालिकाना हक वाले टॉप-लेवल के फ़ोल्डर ऐसेट के लिए दिखाई जाती है. जैसे, "users/*" या "projects/*". |
asset.tilesets[] |
इस इमेज को बैकअप देने वाले टाइलसेट. यह सिर्फ़ बाहरी इमेज के लिए मौजूद होती है. इनके पिक्सल, Earth Engine के मालिकाना हक वाले स्टोरेज से नहीं लिए जाते. |
updateMask |
अपडेट मास्क. इससे यह तय किया जाता है कि ऐसेट के किन फ़ील्ड को अपडेट करना है. यह फ़ील्ड के पूरी तरह क्वालिफ़ाइड नामों की कॉमा लगाकर अलग की गई लिस्ट होती है. उदाहरण: |
| रास्टर टाइल कहां और कैसे सेव की जाती हैं, इस बारे में जानकारी. यहां एक-दूसरे से अलग फ़ील्ड की सूची दी गई है. जवाब में, इनमें से ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
asset.cloudStorageLocation |
समर्थन नहीं होना या रुकना. इसके बजाय, |
asset.gcsLocation |
समर्थन नहीं होना या रुकना. इसके बजाय, |
asset.featureViewAssetLocation |
EE में इस FeatureView की जगह. |
| एक-दूसरे से अलग फ़ील्ड खत्म. | |
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में EarthEngineAsset का एक इंस्टेंस शामिल किया जाता है.
अनुमति पाने के लिंक
इसके लिए, OAuth की इनमें से किसी एक अनुमति की ज़रूरत होती है:
https://www.googleapis.com/auth/earthenginehttps://www.googleapis.com/auth/cloud-platform
ज़्यादा जानकारी के लिए, देखें OAuth 2.0 Overview.