Method: projects.assets.patch

इस तरीके का इस्तेमाल करके, किसी ऐसेट को अपडेट किया जा सकता है. अपडेट करने की कार्रवाई से जुड़ी कई पाबंदियां हैं:

  • ऐसेट के सिर्फ़ 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/v1/{asset.name=projects/*/assets/**}

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
asset.name

string

ऐसेट का नाम. name का फ़ॉर्मैट "projects/*/assets/**" है. उदाहरण के लिए, "projects/earthengine-legacy/assets/users//".

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना
{
  "asset": {
    "cloudStorageLocation": {
      "uris": [
        string
      ]
    },
    "featureViewAssetLocation": {
      "assetOptions": {
        object (FeatureViewOptions)
      }
    },
    "type": enum (Type),
    "name": string,
    "id": string,
    "updateTime": string,
    "properties": {
      "fields": {
        string: value,
        ...
      }
    },
    "startTime": string,
    "endTime": string,
    "geometry": {
      "fields": {
        string: value,
        ...
      }
    },
    "bands": [
      {
        "id": string,
        "dataType": {
          object (PixelDataType)
        },
        "grid": {
          object (PixelGrid)
        },
        "pyramidingPolicy": enum (PyramidingPolicy),
        "missingData": {
          object (MissingData)
        }
      }
    ],
    "sizeBytes": string,
    "featureCount": string,
    "quota": {
      "sizeBytes": string,
      "maxSizeBytes": string,
      "assetCount": string,
      "maxAssets": string
    },
    "tilesets": [
      {
        "id": string,
        "sources": [
          {
            object (ImageSource)
          }
        ],
        "dataType": enum (DataType),
        "crs": string
      }
    ]
  },
  "updateMask": string
}
फ़ील्ड
asset.type

enum (Type)

ऐसेट का टाइप.

asset.id

string

एसेट का आईडी. यह name के बराबर है.हालांकि, इसमें "projects/*/assets/" प्रीफ़िक्स नहीं होता. उदाहरण के लिए, "users//". ध्यान दें कि यह सिर्फ़ दिखाने के लिए है. इसका इस्तेमाल किसी दूसरी कार्रवाई के लिए इनपुट के तौर पर नहीं किया जाना चाहिए. इसके बजाय, name का इस्तेमाल करें.

asset.updateTime

string (Timestamp format)

ऐसेट में पिछली बार बदलाव किए जाने का समय.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

asset.properties

object (Struct format)

ऐसेट से जुड़ी मुख्य/वैल्यू प्रॉपर्टी.

asset.startTime

string (Timestamp format)

अगर ऐसेट से जुड़ा कोई टाइमस्टैंप है, तो वह. उदाहरण के लिए, सैटलाइट इमेज लिए जाने का समय. जिन ऐसेट के लिए समय का इंटरवल तय किया जाता है उनके लिए यह टाइमस्टैंप, उस इंटरवल की शुरुआत के समय का होता है. जैसे, एक महीने या साल की औसत वैल्यू.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

asset.endTime

string (Timestamp format)

जिन ऐसेट के लिए समयसीमा तय होती है उनके लिए यह टाइमस्टैंप, उस समयसीमा के खत्म होने का समय होता है. जैसे, एक महीने या एक साल की औसत वैल्यू.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

asset.geometry

object (Struct format)

अगर ऐसेट से जुड़ा कोई स्पैटियल फ़ुटप्रिंट है, तो उसे GeoJSON ज्यामिति ऑब्जेक्ट के तौर पर दिखाया जाता है. इसके बारे में ज़्यादा जानने के लिए, RFC 7946 देखें.

asset.bands[]

object (ImageBand)

इमेज ऐसेट के डेटा बैंड के बारे में जानकारी. इमेज के अलावा अन्य ऐसेट के लिए, इसे शामिल नहीं किया जाता.

asset.sizeBytes

string (int64 format)

पत्ती वाली ऐसेट (जैसे, इमेज) का साइज़, बाइट में.

asset.featureCount

string (int64 format)

अगर लागू हो, तो ऐसेट में मौजूद सुविधाओं की संख्या.

asset.quota

object (FolderQuota)

फ़ोल्डर ऐसेट से जुड़ा कोटा, अगर कोई है. यह कोड, उपयोगकर्ता के मालिकाना हक वाली टॉप-लेवल की फ़ोल्डर ऐसेट के लिए दिखाया जाता है. जैसे, "users/*" या "projects/*".

asset.tilesets[]

object (Tileset)

इस इमेज के साथ काम करने वाले टाइलसेट. यह सिर्फ़ बाहरी इमेज के लिए मौजूद होता है. इनके पिक्सल, Earth Engine के मालिकाना हक वाले स्टोरेज से नहीं लिए जाते हैं.

updateMask

string (FieldMask format)

अपडेट मास्क, यह तय करता है कि ऐसेट के किन फ़ील्ड को अपडेट करना है.

यह फ़ील्ड के पूरी तरह क्वालिफ़ाइड नामों की कॉमा लगाकर अलग की गई लिस्ट है. उदाहरण: "user.displayName,photo".

रास्टर टाइल कहां और कैसे सेव की जाती हैं, इस बारे में जानकारी. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
asset.cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

समर्थन नहीं होना या रुकना. इसके बजाय, ImportExternalImage का इस्तेमाल करें. ज़्यादा जानकारी के लिए, https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff पर जाएं.

asset.featureViewAssetLocation

object (FeatureViewLocation)

EE में इस FeatureView की जगह.

एक-दूसरे से अलग फ़ील्ड के आखिर में.

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में EarthEngineAsset का एक इंस्टेंस शामिल किया जाता है.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/cloud-platform

ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.