Method: projects.assets.listAssets

Elenca qualsiasi risorsa contenitore, ad esempio una cartella o una raccolta.

Richiesta HTTP

GET https://earthengine.googleapis.com/v1/{parent=projects/*/assets/**}:listAssets

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Il nome dell'asset contenitore da elencare. parent sia nel formato "projects/*" o "projects/*/assets/**" (ad es. "projects/[PROJECT]" o "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). Tutti gli asset di proprietà dell'utente sono attualmente nel progetto "earthengine-legacy" (ad es. "projects/earthengine-legacy/assets/users/foo/bar"). Tutti gli altri asset si trovano nel progetto "earthengine-public" (ad es. "projects/earthengine-public/assets/LANDSAT"). Se viene specificato "projects/earthengine-legacy", la risposta sarà costituita da un elenco di tutte le cartelle di primo livello di proprietà dell'utente che effettua la richiesta.

L'autorizzazione richiede una o più delle seguenti autorizzazioni IAM sulla risorsa specificata parent:

  • earthengine.assets.get
  • earthengine.assets.list

Parametri di query

Parametri
pageSize

integer

Il numero massimo di risultati per pagina. Il server potrebbe restituire meno asset rispetto a quelli richiesti. Se non specificato, il valore predefinito per le dimensioni della pagina dipende da EarthEngineAssetView, con limiti più elevati per le visualizzazioni più restrittive.

pageToken

string

Un token che identifica una pagina di risultati che il server deve restituire. In genere, si tratta del valore di ListAssetsResponse.next_page_token restituito dalla chiamata precedente al metodo assets.listAssets.

filter

string

Se presente, specifica un filtro. I filtri vengono applicati solo agli asset ImageCollection e ignorati per gli asset Folder.

I campi startTime, endTime e i membri di properties sono riconosciuti. È disponibile la funzione personalizzata intersects(str), che consente di filtrare in base alla geometria.

Un esempio di filtro per data:

"startTime>\"2020-01-01T00:00:00+00:00\" AND
endTime<\"2020-02-01T00:00:00+00:00\""

Un esempio di filtro proprietà:

"properties.CLOUDY_PIXEL_PERCENTAGE<30"

Un esempio di filtro della geometria:

"intersects(\"{'type':'Point','coordinates':[1,2]}\")"
"intersects(\"{\\\"type\\\":\\\"Point\\\",\\\"coordinates\\\":[1,2]}\")"

Per ulteriori dettagli sul linguaggio dei filtri, visita la pagina https://google.aip.dev/160.

view

enum (EarthEngineAssetView)

Specifica quali parti della risorsa EarthEngineAsset devono essere restituite nella risposta. Si applica solo agli asset ImageCollection. Tutti gli elementi degli asset Folder verranno codificati nella visualizzazione BASIC, indipendentemente dal valore di questo campo.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

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

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.