Method: projects.assets.patch

یک دارایی را به‌روزرسانی می‌کند. تعدادی محدودیت در عملیات به‌روزرسانی وجود دارد:

  • فقط فیلدهای title ، description ، startTime ، endTime و properties مربوط به دارایی می‌توانند به‌روزرسانی شوند.
  • نامگذاری "properties" در updateMask منجر به جایگزینی تمام ویژگی‌های تعریف‌شده توسط کاربر از asset با ویژگی‌های موجود در asset می‌شود.
  • نامگذاری "title" ، "description" ، "startTime" یا "endTime" در updateMask و عدم ارائه مقداری در asset منجر به تنظیم نشدن آن فیلد می‌شود.
  • می‌توان ویژگی‌های منفرد را با نامگذاری آنها در updateMask ، مانند "properties.my_property_name" به‌روزرسانی کرد. مقدار ویژگی روی مقدار متناظر از asset.properties تنظیم می‌شود. اگر مقدار متناظری در asset.properties وجود نداشته باشد، یا اگر مقداری وجود داشته باشد اما NullValue باشد، ویژگی از دارایی حذف می‌شود.
  • ویژگی‌ها را می‌توان فقط با مقادیر رشته‌ای یا عددی تنظیم کرد، یا با تعیین NullValue را حذف کرد.
  • ارائه یک updateMask خالی منجر به جایگزینی برچسب‌های زمانی و ویژگی‌های دارایی با مقادیر موجود در asset می‌شود.

درخواست HTTP

PATCH https://earthengine.googleapis.com/v1/{asset.name=projects/*/assets/**}

این URL از سینتکس Transcoding در 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)

آخرین زمان اصلاح دارایی.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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)

مهر زمانی مرتبط با دارایی، در صورت وجود، مثلاً زمانی که یک تصویر ماهواره‌ای گرفته شده است. برای دارایی‌هایی که مربوط به یک بازه زمانی هستند، مانند مقادیر میانگین در طول یک ماه یا سال، این مهر زمانی مربوط به شروع آن بازه زمانی است.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

asset.endTime

string ( Timestamp format)

برای دارایی‌هایی که مربوط به یک بازه زمانی هستند، مانند میانگین مقادیر در طول یک ماه یا سال، این مهر زمانی مربوط به پایان آن بازه زمانی است (به طور انحصاری).

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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" .

location فیلد Union. اطلاعاتی در مورد محل و نحوه ذخیره کاشی‌های شطرنجی. location می‌تواند فقط یکی از موارد زیر باشد:
asset.cloudStorageLocation
(deprecated)

object ( CloudStorageLocation )

منسوخ شده. به جای آن ImportExternalImage استفاده کنید. برای جزئیات بیشتر به https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff مراجعه کنید.

asset.featureViewAssetLocation

object ( FeatureViewLocation )

محل قرارگیری این FeatureView در EE.

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ شامل نمونه‌ای از EarthEngineAsset است.

دامنه‌های مجوز

به یکی از حوزه‌های OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .