Method: projects.assets.patch

Memperbarui aset. Ada sejumlah batasan pada operasi update:

  • Hanya kolom title, description, startTime, endTime, dan properties aset yang dapat diperbarui.
  • Memberi nama "properties" di updateMask akan menyebabkan semua properti aset yang ditentukan pengguna diganti dengan properti di asset.
  • Penamaan "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 memberi nama 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 merupakan NullValue, properti akan dihapus dari aset.
  • Properti hanya dapat ditetapkan ke nilai string atau angka, atau dihapus dengan menentukan NullValue.
  • Menyediakan updateMask kosong akan menyebabkan stempel waktu dan properti aset semuanya diganti dengan nilai di asset.

Permintaan HTTP

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

URL 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
      ]
    },
    "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
}
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. Nilai ini tidak boleh digunakan sebagai input untuk operasi lain. Sebagai gantinya, gunakan name.

asset.updateTime

string (Timestamp format)

Waktu terakhir aset diubah.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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.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 pengambilan gambar satelit. 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, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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)

Jejak 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 daun (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)

Setel kartu 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 pembaruan yang menentukan kolom aset yang akan diperbarui.

Ini adalah daftar dipisahkan koma yang berisi nama-nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".

Kolom union location. Informasi tentang tempat dan cara penyimpanan ubin raster. location hanya dapat berupa salah satu dari berikut:
asset.cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

Tidak digunakan lagi. Sebagai gantinya, gunakan image.importExternal. 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.

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.