Method: projects.assets.patch

Cập nhật một tài sản. Hoạt động cập nhật có một số quy tắc ràng buộc:

  • Bạn chỉ có thể cập nhật các trường title, description, startTime, endTimeproperties của tài sản.
  • Việc đặt tên "properties" trong updateMask sẽ khiến tất cả các thuộc tính do người dùng xác định của thành phần đượ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 đó trở thành trường chưa được đặt.
  • Bạn có thể cập nhật từng thuộc tính bằng cách đặt tên cho chúng 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 một NullValue.
  • Việc cung cấp một updateMask trống sẽ khiến dấu thời gian và thuộc tính 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 của tài sản. 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 với 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 tài sản.

asset.id

string

Mã nhận dạng của thành phần. Tương đương với name mà 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 dùng mã này làm dữ liệu đầu vào cho một thao tác 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 tài sản.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch 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 tài sản.

asset.startTime

string (Timestamp format)

Dấu thời gian được liên kết với thành phần, nếu có, ví dụ: thời điểm chụp ảnh vệ tinh. Đối với những tài sả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 của khoảng thời gian đó.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch 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 tài sả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 cuối khoảng thời gian đó (không bao gồm).

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch 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)

Phạm vi không gian được 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ề các dải dữ liệu của thành phần hình ảnh. Bị bỏ qua đối với thành phần không phải là hình ảnh.

asset.sizeBytes

string (int64 format)

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

asset.featureCount

string (int64 format)

Số lượng đặc điểm trong tài sản (nếu có).

asset.quota

object (FolderQuota)

Thông tin về hạn mức liên kết với tài sản thư mục (nếu 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 nhóm ô hỗ trợ hình ảnh này. Chỉ xuất hiện đối với hình ảnh bên ngoài, có các pixel được truy xuất từ bộ nhớ không thuộc quyền 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 tài sản cần cập nhật.

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

Thông tin về vị trí và cách lưu trữ các ô raster. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
asset.cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

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

asset.featureViewAssetLocation

object (FeatureViewLocation)

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

Kết thúc các trường xung khắc.

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 thực thể 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.