Method: projects.assets.patch

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

  • فقط قسمت‌های title ، description ، startTime ، endTime ، و properties دارایی را می‌توان به‌روزرسانی کرد.
  • نامگذاری "properties" در updateMask باعث می‌شود که همه ویژگی‌های دارایی تعریف‌شده توسط کاربر با ویژگی‌های 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/v1beta/{asset.name=projects/*/assets/**}

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
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 نرمال می شود و از 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)

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

از RFC 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)

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

از RFC 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" .

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

object ( CloudStorageLocation )

منسوخ شده است. به جای آن از image.importExternal استفاده کنید. برای جزئیات بیشتر به 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 .