Method: projects.assets.listAssets

Muestra una lista de cualquier recurso de contenedor, como una carpeta o una colección.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Es obligatorio. Es el nombre del activo del contenedor que se mostrará en la lista. parent tiene el formato "projects/*" o "projects/*/assets/**" (p.ej., "projects/[PROJECT]" o "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). Actualmente, todos los recursos que pertenecen a los usuarios se encuentran en el proyecto "earthengine-legacy" (p.ej., "projects/earthengine-legacy/assets/users/foo/bar"). Todos los demás recursos se encuentran en el proyecto "earthengine-public" (p.ej., "projects/earthengine-public/assets/LANDSAT"). Si se especifica "projects/earthengine-legacy", la respuesta consistirá en una lista de todas las carpetas de nivel superior que pertenecen al usuario solicitante.

La autorización requiere uno o más de los siguientes permisos de IAM en el recurso parent especificado:

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

Parámetros de consulta

Parámetros
pageSize

integer

Es la cantidad máxima de resultados por página. Es posible que el servidor devuelva menos recursos de los solicitados. Si no se especifica, el tamaño de página predeterminado depende de EarthEngineAssetView, con límites más altos para vistas más restrictivas.
pageToken

string

Un token que identifica una página de resultados que debe mostrar el servidor. Por lo general, este es el valor de ListAssetsResponse.next_page_token que se muestra de la llamada anterior al método assets.listAssets.
filter

string

Si está presente, especifica un filtro. Los filtros solo se aplican a los activos ImageCollection y se ignoran para los activos Folder.

Se reconocen los campos startTime, endTime y los miembros de properties. La función personalizada intersects(str) está disponible, lo que permite filtrar por geometría.

Ejemplo de filtro de fecha:

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

Ejemplo de filtro de propiedad:

"properties.CLOUDY_PIXEL_PERCENTAGE<30"

Ejemplo de filtro de geometría:

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

Consulta https://google.aip.dev/160 para obtener más detalles sobre el lenguaje de filtros.
view

enum (EarthEngineAssetView)

Especifica qué partes del recurso EarthEngineAsset se deben mostrar en la respuesta. Solo se aplica a los recursos ImageCollection. Todos los elementos de los recursos Folder se codificarán en la vista BASIC, independientemente del valor de este campo.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de ListAssetsResponse.

Alcances de autorización

Se necesita uno de los siguientes permisos de 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

Para obtener más información, consulta OAuth 2.0 Overview.