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 中的值取代。

HTTP 要求

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

資產的 ID。等同於 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"。
有關點陣圖塊的儲存位置和方式。以下列出互斥的欄位。回應中最多只會設定一個欄位：
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。