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/v1alpha/{asset.name=projects/*/assets/**}

网址采用 gRPC 转码语法。

路径参数

参数
asset.name

string

资产的名称。name 的格式为“projects/*/assets/**”（例如“projects/earthengine-legacy/assets/users//”）。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "asset": {
    "cloudStorageLocation": {
      "uris": [
        string
      ]
    },
    "gcsLocation": {
      "uris": [
        string
      ]
    },
    "featureViewAssetLocation": {
      "assetOptions": {
        object (FeatureViewOptions)
      }
    },
    "type": enum (Type),
    "name": string,
    "id": string,
    "updateTime": string,
    "title": string,
    "description": 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,
      "maxAssetCount": 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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.title
(deprecated)

string

资源的标题。
asset.description
(deprecated)

string

相应资产的说明。
asset.properties

object (Struct format)

与相应素材资源相关联的键/值属性。
asset.startTime

string (Timestamp format)

与相应资产相关联的时间戳（如果有），例如拍摄卫星图像的时间。对于与时间间隔对应的资产（例如一个月或一年的平均值），此时间戳对应于该时间间隔的开始时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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.gcsLocation
(deprecated)

object (GcsLocation)

已弃用。请改用 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。