Method: projects.assets.patch

Cập nhật một thành phần. Có một số quy tắc ràng buộc đối với thao tác cập nhật:

  • Bạn chỉ có thể cập nhật các trường title, description, startTime, endTimeproperties của thành phần.
  • Việc đặt tên "properties" trong updateMask sẽ dẫn đến việc tất cả thuộc tính do người dùng xác định của tài sản sẽ được thay thế bằng các thuộc tính trong asset.
  • Việc đặt tên "title", "description", "startTime" hoặc "endTime" trong updateMask và không cung cấp giá trị trong asset sẽ khiến trường đó bị huỷ thiết lập.
  • Bạn có thể cập nhật từng thuộc tính riêng lẻ bằng cách đặt tên cho các thuộc tính đó trong updateMask, chẳng hạn như "properties.my_property_name". Giá trị của thuộc tính sẽ được đặt thành giá trị tương ứng từ asset.properties. Nếu không có giá trị tương ứng trong asset.properties hoặc nếu có giá trị nhưng đó là NullValue, thì thuộc tính sẽ bị xoá khỏi thành phần.
  • Bạn chỉ có thể đặt thuộc tính thành giá trị chuỗi hoặc số hoặc xoá bằng cách chỉ định NullValue.
  • Việc cung cấp updateMask trống sẽ dẫn đến việc tất cả các thuộc tính và dấu thời gian của thành phần đều được thay thế bằng các giá trị trong asset.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
asset.name

string

Tên nội dung. name có định dạng "projects/*/assets/**" (ví dụ: "projects/earthengine-legacy/assets/users//").

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng 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
}
Trường
asset.type

enum (Type)

Loại thành phần.

asset.id

string

ID của nội dung. Tương đương với name không có tiền tố "projects/*/assets/" (ví dụ: "users//"). Xin lưu ý rằng thông tin này chỉ nhằm mục đích hiển thị. Bạn không nên sử dụng giá trị này làm dữ liệu đầu vào cho một phép toán khác. Thay vào đó, hãy sử dụng name.

asset.updateTime

string (Timestamp format)

Thời gian sửa đổi gần đây nhất của thành phần.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

asset.properties

object (Struct format)

Các thuộc tính khoá/giá trị được liên kết với thành phần.

asset.startTime

string (Timestamp format)

Dấu thời gian liên kết với thành phần (nếu có), ví dụ: thời gian chụp ảnh vệ tinh. Đối với những thành phần tương ứng với một khoảng thời gian, chẳng hạn như giá trị trung bình trong một tháng hoặc một năm, dấu thời gian này tương ứng với thời điểm bắt đầu khoảng thời gian đó.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

asset.endTime

string (Timestamp format)

Đối với những thành phần tương ứng với một khoảng thời gian, chẳng hạn như giá trị trung bình trong một tháng hoặc một năm, dấu thời gian này tương ứng với thời điểm kết thúc khoảng thời gian đó (không bao gồm).

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

asset.geometry

object (Struct format)

Dấu vết không gian liên kết với tài sản (nếu có) dưới dạng đối tượng hình học GeoJSON (xem RFC 7946).

asset.bands[]

object (ImageBand)

Thông tin về dải dữ liệu của thành phần hình ảnh. Bỏ qua đối với thành phần không phải hình ảnh.

asset.sizeBytes

string (int64 format)

Kích thước của một thành phần lá (ví dụ: hình ảnh) tính bằng byte.

asset.featureCount

string (int64 format)

Số lượng tính năng trong thành phần (nếu có).

asset.quota

object (FolderQuota)

Thông tin hạn mức liên kết với tài sản thư mục (nếu có). Được trả về cho các thành phần thư mục cấp cao nhất do người dùng sở hữu (ví dụ: "users/*" hoặc "projects/*").

asset.tilesets[]

object (Tileset)

Các tập hợp thẻ thông tin hỗ trợ hình ảnh này. Chỉ xuất hiện đối với hình ảnh bên ngoài, có pixel được truy xuất từ bộ nhớ không thuộc sở hữu của Earth Engine.

updateMask

string (FieldMask format)

Mặt nạ cập nhật chỉ định những trường của thành phần cần cập nhật.

Đây là danh sách tên trường đủ điều kiện được phân tách bằng dấu phẩy. Ví dụ: "user.displayName,photo"

Trường hợp hợp nhất location. Thông tin về vị trí và cách lưu trữ các ô đường quét. location chỉ có thể là một trong những giá trị sau:
asset.cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

Không dùng nữa. Thay vào đó, hãy sử dụng image.importExternal. Hãy xem https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff để biết thêm thông tin chi tiết.

asset.featureViewAssetLocation

object (FeatureViewLocation)

Vị trí của FeatureView này trong EE.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của EarthEngineAsset.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.