Method: projects.assets.patch

Aktualisiert ein Asset. Für den Aktualisierungsvorgang gelten eine Reihe von Einschränkungen:

  • Es können nur die Felder title, description, startTime, endTime, und properties des Assets aktualisiert werden.
  • Wenn Sie in updateMask "properties" angeben, werden alle benutzerdefinierten Eigenschaften des Assets durch die Eigenschaften in asset ersetzt.
  • Wenn Sie in updateMask "title", "description", "startTime" oder "endTime" angeben und in asset keinen Wert angeben, wird das Feld nicht festgelegt.
  • Sie können einzelne Eigenschaften aktualisieren, indem Sie sie in updateMask angeben, z. B. "properties.my_property_name". Der Wert der Eigenschaft wird auf den entsprechenden Wert aus asset.properties festgelegt. Wenn in asset.properties kein entsprechender Wert vorhanden ist oder ein Wert vorhanden ist, aber es sich um einen NullValue handelt, wird die Eigenschaft aus dem Asset gelöscht.
  • Eigenschaften können nur auf String- oder Zahlenwerte festgelegt oder durch Angabe eines NullValue gelöscht werden.
  • Wenn Sie ein leeres updateMask angeben, werden alle Zeitstempel und Eigenschaften des Assets durch die Werte in asset ersetzt.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
asset.name

string

Der Name des Inhalts, name hat das Format "projects/*/assets/**" (z.B. "projects/earthengine-legacy/assets/users//").

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "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
}
Felder
asset.type

enum (Type)

Der Typ des Assets.

asset.id

string

Die ID des Assets. Entspricht name ohne das Präfix „projects/*/assets/“ (z.B. „users//“). Diese Angabe dient nur zu Anzeigezwecken. Sie sollte nicht als Eingabe für einen anderen Vorgang verwendet werden. Verwenden Sie stattdessen name.

asset.updateTime

string (Timestamp format)

Der Zeitpunkt der letzten Änderung des Assets.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

asset.properties

object (Struct format)

Schlüssel/Wert-Eigenschaften, die mit dem Asset verknüpft sind.

asset.startTime

string (Timestamp format)

Der Zeitstempel, der mit dem Asset verknüpft ist, falls vorhanden, z.B. der Zeitpunkt, zu dem ein Satellitenbild aufgenommen wurde. Bei Assets, die einem Zeitraum entsprechen, z. B. Durchschnittswerte für einen Monat oder ein Jahr, entspricht dieser Zeitstempel dem Beginn dieses Zeitraums.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

asset.endTime

string (Timestamp format)

Bei Assets, die einem Zeitraum entsprechen, z. B. Durchschnittswerte für einen Monat oder ein Jahr, entspricht dieser Zeitstempel dem Ende dieses Zeitraums (exklusiv).

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

asset.geometry

object (Struct format)

Der räumliche Footprint, der mit dem Asset verknüpft ist, falls vorhanden, als GeoJSON-Geometrieobjekt (siehe RFC 7946).

asset.bands[]

object (ImageBand)

Informationen zu den Datenbändern des Bild-Assets. Wird für Nicht-Bild-Assets weggelassen.

asset.sizeBytes

string (int64 format)

Die Größe eines Blatt-Assets (z.B. eines Bildes) in Byte.

asset.featureCount

string (int64 format)

Die Anzahl der Features im Asset, falls zutreffend.

asset.quota

object (FolderQuota)

Die Kontingentinformationen, die mit dem Ordner-Asset verknüpft sind, falls vorhanden. Wird für Ordner-Assets der obersten Ebene zurückgegeben, die sich im Besitz des Nutzers befinden (z.B. „users/*“ oder „projects/*“).

asset.tilesets[]

object (Tileset)

Die Tilesets, die dieses Bild unterstützen. Nur für externe Bilder vorhanden, deren Pixel aus einem Speicher abgerufen werden, der nicht Earth Engine gehört.

updateMask

string (FieldMask format)

Die Aktualisierungsmaske, die angibt, welche Felder des Assets aktualisiert werden sollen.

Dies ist eine durch Kommas getrennte Liste voll qualifizierter Feldnamen. Beispiel: "user.displayName,photo".

Informationen dazu, wo und wie die Rasterkacheln gespeichert werden. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
asset.cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

Verworfen. Verwenden Sie stattdessen ImportExternalImage. Weitere Informationen finden Sie unter https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff.

asset.featureViewAssetLocation

object (FeatureViewLocation)

Der Speicherort dieser FeatureView in Earth Engine.

Ende der sich gegenseitig ausschließenden Felder.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von EarthEngineAsset.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.