Method: projects.assets.patch

Memperbarui aset. Ada sejumlah batasan pada operasi pembaruan:

  • Hanya kolom title, description, startTime, endTime, dan properties aset yang dapat diperbarui.
  • Menamai "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 properti satu per satu 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 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 diganti dengan nilai di asset.

Permintaan HTTP

PATCH https://earthengine.googleapis.com/v1beta/{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
      ]
    },
    "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 hal ini hanya ditujukan untuk tujuan tampilan. Hal ini tidak boleh digunakan sebagai input untuk operasi lain. Sebagai gantinya, gunakan name.

asset.updateTime

string (Timestamp format)

Waktu aset terakhir diubah.

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.properties

object (Struct format)

Properti kunci/nilai 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)

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 leaf (misalnya, gambar) dalam byte.

asset.featureCount

string (int64 format)

Jumlah fitur dalam aset, jika berlaku.

asset.quota

object (FolderQuota)

Informasi kuota yang terkait dengan aset folder, jika ada. Ditampilkan untuk aset folder milik pengguna tingkat atas (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 pembaruan 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 saling eksklusif. 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.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.