Method: projects.assets.patch

Aggiorna una risorsa. L'operazione di aggiornamento è soggetta a una serie di vincoli:

  • È possibile aggiornare solo i campi title, description, startTime, endTime e properties della risorsa.
  • Se specifichi "properties" in updateMask, tutte le proprietà definite dall'utente della risorsa vengono sostituite dalle proprietà in asset.
  • Se specifichi "title", "description", "startTime" o "endTime" in updateMask e non fornisci un valore in asset, il campo diventa non impostato.
  • È possibile aggiornare le singole proprietà specificandole in updateMask, ad esempio "properties.my_property_name". Il valore della proprietà verrà impostato sul valore corrispondente di asset.properties. Se non è presente un valore corrispondente in asset.properties o se è presente un valore ma è un NullValue, la proprietà verrà eliminata dalla risorsa.
  • Le proprietà possono essere impostate solo su valori di stringa o numerici oppure eliminate specificando un NullValue.
  • Se fornisci un updateMask vuoto, i timestamp e le proprietà della risorsa verranno sostituiti dai valori in asset.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
asset.name

string

Il nome della risorsa. name ha il formato "projects/*/assets/**" (ad es. "projects/earthengine-legacy/assets/users//").

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione 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
}
Campi
asset.type

enum (Type)

Il tipo di risorsa.
asset.id

string

ID della risorsa. Equivalente a name senza il prefisso "projects/*/assets/" (ad es. "users//"). Tieni presente che questo valore è destinato esclusivamente alla visualizzazione. Non deve essere utilizzato come input per un'altra operazione. Utilizza invece name.
asset.updateTime

string (Timestamp format)

L'ora dell'ultima modifica della risorsa.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
asset.properties

object (Struct format)

Proprietà chiave/valore associate alla risorsa.
asset.startTime

string (Timestamp format)

Il timestamp associato alla risorsa, se presente, ad es. l'ora in cui è stata scattata un'immagine satellitare. Per le risorse che corrispondono a un intervallo di tempo, ad esempio i valori medi su un mese o un anno, questo timestamp corrisponde all'inizio dell'intervallo.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
asset.endTime

string (Timestamp format)

Per le risorse che corrispondono a un intervallo di tempo, ad esempio i valori medi su un mese o un anno, questo timestamp corrisponde alla fine dell'intervallo (valore inserito escluso).

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
asset.geometry

object (Struct format)

L'impronta spaziale associata alla risorsa, se presente, come oggetto di geometria GeoJSON (vedi RFC 7946).
asset.bands[]

object (ImageBand)

Informazioni sulle bande di dati dell'asset immagine. Omesse per le risorse non immagine.
asset.sizeBytes

string (int64 format)

Le dimensioni di una risorsa foglia (ad es. un'immagine) in byte.
asset.featureCount

string (int64 format)

Il numero di funzionalità nella risorsa, se applicabile.
asset.quota

object (FolderQuota)

Le informazioni sulla quota associate alla risorsa cartella, se presenti. Restituite per le risorse cartella di proprietà dell'utente di primo livello (ad es. "users/*" o "projects/*").
asset.tilesets[]

object (Tileset)

I set di riquadri che supportano questa immagine. Presenti solo per le immagini esterne, i cui pixel vengono recuperati da uno spazio di archiviazione non di proprietà di Earth Engine.
updateMask

string (FieldMask format)

La maschera di aggiornamento che specifica i campi della risorsa da aggiornare.

Si tratta di un elenco separato da virgole di nomi completi dei campi. Esempio: "user.displayName,photo".
Informazioni su dove e come vengono archiviati i riquadri raster. Di seguito è riportato un elenco di campi che si escludono a vicenda. Nella risposta verrà impostato al massimo uno dei campi seguenti:
asset.cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

Deprecato. Utilizza invece ImportExternalImage. Per maggiori dettagli, visita la pagina https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff.
asset.featureViewAssetLocation

object (FeatureViewLocation)

La posizione di questa FeatureView in EE.
Fine dei campi che si escludono a vicenda.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di EarthEngineAsset.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per saperne di più, consulta la OAuth 2.0 Overview.