Method: projects.listAssets

Répertorie tous les composants de conteneur, tels qu'un dossier ou une collection.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Nom de l'élément de conteneur à lister. parent est au format "projects/*" ou "projects/*/assets/**" (par exemple, "projects/[PROJECT]" ou "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). Tous les éléments appartenant à l'utilisateur sont actuellement regroupés dans le projet "earthengine-legacy" (par exemple, "projects/earthengine-legacy/assets/users/foo/bar"). Tous les autres composants sont associés au projet "earthengine-public" (par exemple, "projects/earthengine-public/assets/LANDSAT"). Si "projects/earthengine-legacy" est spécifié, la réponse consiste en une liste de tous les dossiers de premier niveau appartenant à l'utilisateur à l'origine de la requête.

Une ou plusieurs des autorisations IAMsuivantes sont requises pour la ressource parent indiquée :

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

Paramètres de requête

Paramètres
pageSize

integer

Nombre maximal de résultats par page. Le serveur peut renvoyer moins d'assets que demandé. Si aucune valeur n'est spécifiée, la taille de page par défaut dépend de EarthEngineAssetView, avec des limites plus élevées pour les vues plus restrictives.

pageToken

string

Jeton identifiant une page de résultats que le serveur doit renvoyer. Il s'agit généralement de la valeur de ListAssetsResponse.next_page_token renvoyée par l'appel précédent à la méthode projects.listAssets.

filter

string

Le cas échéant, spécifie un filtre. Les filtres ne s'appliquent qu'aux éléments ImageCollection et sont ignorés pour les éléments Folder.

Les champs startTime, endTime et les membres de properties sont reconnus. La fonction personnalisée intersects(str) est disponible et permet de filtrer par géométrie.

Exemple de filtre de date:

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

Exemple de filtre de propriété:

"properties.CLOUDY_PIXEL_PERCENTAGE<30"

Exemple de filtre de géométrie:

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

Pour en savoir plus sur le langage de filtre, consultez https://google.aip.dev/160.

view

enum (EarthEngineAssetView)

Spécifie les parties de la ressource EarthEngineAsset à renvoyer dans la réponse. Ne s'applique qu'aux éléments ImageCollection. Tous les éléments des éléments Folder seront encodés dans la vue BASIC, quelle que soit la valeur de ce champ.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de ListAssetsResponse.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • 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

Pour en savoir plus, consultez OAuth 2.0 Overview.