Method: projects.assets.patch

Memperbarui aset. Ada sejumlah batasan pada operasi update:

  • Hanya kolom title, description, startTime, endTime, dan properties aset yang dapat diperbarui.
  • Penamaan "properties" di updateMask akan menyebabkan semua properti aset yang ditentukan pengguna diganti dengan properti di asset.
  • Menamai "title", "description", "startTime", atau "endTime" di updateMask dan tidak memberikan nilai di asset akan menyebabkan kolom tersebut tidak ditetapkan.
  • Anda dapat memperbarui setiap properti dengan menamainya di updateMask, seperti "properties.my_property_name". Nilai properti akan ditetapkan ke nilai yang sesuai dari asset.properties. Jika tidak ada nilai yang sesuai di asset.properties, atau jika ada nilai tetapi berupa NullValue, properti akan dihapus dari aset.
  • Properti hanya dapat disetel ke nilai string atau angka, atau dihapus dengan menentukan NullValue.
  • Jika updateMask kosong, stempel waktu dan properti aset akan diganti dengan nilai di asset.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
asset.name

string

Nama aset. name memiliki format "projects/*/assets/**" (misalnya, "projects/earthengine-legacy/assets/users//").

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi 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
}
Kolom
asset.type

enum (Type)

Jenis aset.

asset.id

string

ID aset. Setara dengan name tanpa awalan "projects/*/assets/" (misalnya, "users//"). Perhatikan bahwa ini hanya dimaksudkan untuk tujuan tampilan. Tidak boleh digunakan sebagai input untuk operasi lain. Sebagai gantinya, gunakan name.

asset.updateTime

string (Timestamp format)

Waktu terakhir diubahnya aset.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

asset.title
(deprecated)

string

Judul aset.

asset.description
(deprecated)

string

Deskripsi aset.

asset.properties

object (Struct format)

Properti nilai/kunci yang terkait dengan aset.

asset.startTime

string (Timestamp format)

Stempel waktu yang terkait dengan aset, jika ada, misalnya waktu saat gambar satelit diambil. Untuk aset yang sesuai dengan interval waktu, seperti nilai rata-rata selama sebulan atau setahun, stempel waktu ini sesuai dengan awal interval tersebut.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

asset.endTime

string (Timestamp format)

Untuk aset yang sesuai dengan interval waktu, seperti nilai rata-rata selama sebulan atau setahun, stempel waktu ini sesuai dengan akhir interval tersebut (eksklusif).

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

asset.geometry

object (Struct format)

Cakupan spasial yang terkait dengan aset, jika ada, sebagai objek geometri GeoJSON (lihat RFC 7946).

asset.bands[]

object (ImageBand)

Informasi tentang band data aset gambar. Dihilangkan untuk aset non-gambar.

asset.sizeBytes

string (int64 format)

Ukuran aset leaf (misalnya, gambar) dalam byte.

asset.featureCount

string (int64 format)

Jumlah fitur dalam aset, jika ada.

asset.quota

object (FolderQuota)

Informasi kuota yang terkait dengan aset folder, jika ada. Ditampilkan untuk aset folder milik pengguna tingkat teratas (misalnya, "users/*" atau "projects/*").

asset.tilesets[]

object (Tileset)

Tileset yang mendukung gambar ini. Hanya ada untuk gambar eksternal, yang pikselnya diambil dari penyimpanan yang tidak dimiliki oleh Earth Engine.

updateMask

string (FieldMask format)

Mask update yang menentukan kolom aset yang akan diperbarui.

Ini adalah comma-separated list berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".

Informasi tentang tempat dan cara penyimpanan petak raster. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
asset.cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

Tidak digunakan lagi. Sebagai gantinya, gunakan ImportExternalImage. Lihat https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff untuk mengetahui detail selengkapnya.

asset.gcsLocation
(deprecated)

object (GcsLocation)

Tidak digunakan lagi. Sebagai gantinya, gunakan ImportExternalImage. Lihat https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff untuk mengetahui detail selengkapnya.

asset.featureViewAssetLocation

object (FeatureViewLocation)

Lokasi FeatureView ini di EE.

Akhir kolom yang saling eksklusif.

Isi respons

Jika berhasil, isi respons memuat instance EarthEngineAsset.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.