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/v1beta/{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

ऐसेट का आईडी. यह "projects/*/assets/" प्रीफ़िक्स के बिना, name के बराबर है. जैसे, "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 ज्यामिति ऑब्जेक्ट के तौर पर होगा. इसके लिए, आरएफ़सी 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 देखें.