공지사항:
2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 Earth Engine 액세스를 유지하기 위해
비상업용 자격 요건을 인증해야 합니다.
Method: projects.listAssets
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
폴더나 컬렉션과 같은 컨테이너 애셋을 나열합니다.
HTTP 요청
GET https://earthengine.googleapis.com/v1/{parent=projects/*}: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'가 지정된 경우 응답은 요청 사용자가 소유한 모든 최상위 폴더 목록으로 구성됩니다.
승인을 처리하려면 지정된 리소스 parent 에 대해 다음 IAM 권한 중 하나 이상이 필요합니다.
earthengine.assets.get
earthengine.assets.list
|
쿼리 매개변수
매개변수 |
pageSize |
integer
페이지당 최대 결과 수입니다. 서버에서 요청한 것보다 적은 애셋을 반환할 수 있습니다. 지정하지 않으면 페이지 크기 기본값은 EarthEngineAssetView에 따라 달라지며, 제한이 더 많은 뷰의 경우 한도가 더 높습니다.
|
pageToken |
string
서버에서 반환할 결과 페이지를 식별하는 토큰입니다. 일반적으로 이는 projects.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를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[],["This content describes how to list container assets like folders or collections via a `GET` request to `https://earthengine.googleapis.com/v1/{parent=projects/*}:listAssets`. The `parent` parameter specifies the container, with projects like \"earthengine-legacy\" or \"earthengine-public.\" Query parameters like `pageSize`, `pageToken`, `filter` (for `ImageCollection` assets), and `view` allow refining results. Authorization requires specific IAM permissions and OAuth scopes. The response is an instance of `ListAssetsResponse`, and the request body must be empty.\n"],null,[]]