Method: projects.assets.patch

Aggiorna una risorsa. Esistono una serie di vincoli per l'operazione di aggiornamento:

  • Possono essere aggiornati solo i campi title, description, startTime, endTime e properties dell'asset.
  • Se assegni il nome "properties" a updateMask, tutte le proprietà definite dall'utente della risorsa vengono sostituite dalle proprietà in asset.
  • Se assegni i nomi "title", "description", "startTime" o "endTime" a updateMask e non fornisci un valore in asset, il campo non viene impostato.
  • È possibile aggiornare le singole proprietà assegnando loro un nome 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 si tratta di NullValue, la proprietà verrà eliminata dalla risorsa.
  • Le proprietà possono essere impostate solo su valori di stringa o numeri oppure eliminate specificando un NullValue.
  • Se fornisci un updateMask vuoto, i timestamp e le proprietà dell'asset 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 è nel 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 è solo a scopo di 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 sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. 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 all'asset, se presente, ad esempio l'ora in cui è stata acquisita un'immagine satellitare. Per gli asset che corrispondono a un intervallo di tempo, ad esempio i valori medi di un mese o un anno, questo timestamp corrisponde all'inizio dell'intervallo.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. 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 gli asset che corrispondono a un intervallo di tempo, ad esempio i valori medi di un mese o un anno, questo timestamp corrisponde alla fine dell'intervallo (esclusivo).

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. 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 geometrico GeoJSON (vedi RFC 7946).
asset.bands[]

object (ImageBand)

Informazioni sulle bande di dati dell'asset immagine. Omesso per gli asset non immagine.
asset.sizeBytes

string (int64 format)

Le dimensioni di un asset a livello inferiore (ad es. un'immagine) in byte.
asset.featureCount

string (int64 format)

Il numero di elementi nella risorsa, se applicabile.
asset.quota

object (FolderQuota)

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

object (Tileset)

I set di tessere alla base di questa immagine. Presente 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".
Campo unione location. Informazioni su dove e come vengono archiviati i riquadri raster. location può essere solo uno dei seguenti:
asset.cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

Deprecato. Utilizza invece image.importExternal. 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 visualizzazione elemento in EE.

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 ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.