Method: projects.assets.listAssets

Перечисляет любой ресурс контейнера, например папку или коллекцию.

HTTP-запрос

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

URL-адрес использует синтаксис транскодирования 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», ответ будет состоять из списка всех папок верхнего уровня, принадлежащих запрашивающему пользователю.

Для авторизации требуется одно или несколько из следующих разрешений IAM для указанного parent ресурса:

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

Параметры запроса

Параметры
pageSize

integer

Максимальное количество результатов на странице. Сервер может вернуть меньше ресурсов, чем запрошено. Если не указано, размер страницы по умолчанию зависит от EarthEngineAssetView с более высокими ограничениями для более ограничительных представлений.

pageToken

string

Токен, идентифицирующий страницу результатов, которую должен вернуть сервер. Обычно это значение ListAssetsResponse.next_page_token , возвращенное в результате предыдущего вызова метода assets.listAssets .

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 .