Method: projects.assets.listAssets

列出任何容器素材资源，例如文件夹或合集。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。要列出的容器素材资源的名称。parent 的格式为“projects/*”或“projects/*/assets/**”（例如“projects/[PROJECT]”或“projects/earthengine-legacy/assets/users/[USER]/[ASSET]”。所有用户拥有的资产目前都位于项目“earthengine-legacy”下（例如，“projects/earthengine-legacy/assets/users/foo/bar”）。所有其他资产均位于项目“earthengine-public”下（例如“projects/earthengine-public/assets/LANDSAT”）。如果指定了“projects/earthengine-legacy”，则响应将包含请求用户拥有的所有顶级文件夹的列表。

必须对指定的资源 parent 具有以下一项或多项 IAM 权限才能进行授权：

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

查询参数

参数
pageSize

integer

每页的结果数上限。服务器返回的素材资源数量可能少于请求的数量。如果未指定，默认每页数据大小取决于 EarthEngineAssetView，限制越严格的视图，上限越高。
pageToken

string

标识服务器应返回的结果页面的令牌。 通常，这是上次调用 assets.listAssets 方法返回的 ListAssetsResponse.next_page_token 值。
filter

string

指定过滤器（如果有）。过滤条件仅应用于 ImageCollection 素材资源，系统会忽略 Folder 素材资源。

系统会识别 startTime、endTime 字段以及 properties 的成员。可使用自定义函数 intersects(str)，以按几何图形进行过滤。

日期过滤条件示例：

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

属性过滤条件示例：

"properties.CLOUDY_PIXEL_PERCENTAGE<30"

几何图形过滤器示例：

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

如需详细了解过滤器语言，请参阅 https://google.aip.dev/160。
view

enum (EarthEngineAssetView)

指定应在响应中返回 EarthEngineAsset 资源的哪些部分。仅适用于 ImageCollection 素材资源。无论此字段的值如何，Folder 资源的所有元素都将在 BASIC 视图中编码。

请求正文

请求正文必须为空。

响应正文

如果成功，则响应正文包含一个 ListAssetsResponse 实例。

授权范围

需要以下 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

如需了解详情，请参阅 OAuth 2.0 Overview。