Method: projects.listAssets
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Hier werden alle Container-Assets wie Ordner oder Sammlungen aufgelistet.
HTTP-Anfrage
GET https://earthengine.googleapis.com/v1alpha/{parent=projects/*}:listAssets
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
parent |
string
Erforderlich. Der Name des zu listenden Container-Assets. parent hat das Format „projects/*“ oder „projects/*/assets/**“ (z.B. „projects/[PROJECT]“ oder „projects/earthengine-legacy/assets/users/[USER]/[ASSET]“). Alle vom Nutzer erstellten Assets befinden sich derzeit im Projekt „earthengine-legacy“ (z.B. "projects/earthengine-legacy/assets/users/foo/bar"). Alle anderen Assets befinden sich im Projekt „earthengine-public“ (z.B. "projects/earthengine-public/assets/LANDSAT"). Wenn „projects/earthengine-legacy“ angegeben ist, enthält die Antwort eine Liste aller Ordner auf oberster Ebene, deren Eigentümer der anfragende Nutzer ist.
Zur Autorisierung ist mindestens eine der folgenden IAM-Berechtigungen für die angegebene Ressource parent erforderlich:
earthengine.assets.getearthengine.assets.list
|
Abfrageparameter
| Parameter |
pageSize |
integer
Die maximale Anzahl von Ergebnissen pro Seite. Der Server gibt möglicherweise weniger Assets zurück, als angefordert. Wenn keine Angabe gemacht wird, hängt die Standardseitengröße von der EarthEngineAssetView ab. Für eingeschränktere Ansichten gelten höhere Limits.
|
pageToken |
string
Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll. Normalerweise ist dies der Wert von ListAssetsResponse.next_page_token, der vom vorherigen Aufruf der projects.listAssets-Methode zurückgegeben wurde.
|
filter |
string
Gibt einen Filter an, falls vorhanden. Filter werden nur auf ImageCollection-Assets angewendet und für Folder-Assets ignoriert. Die Felder startTime, endTime und Mitglieder von properties werden erkannt. Die benutzerdefinierte Funktion intersects(str) ist verfügbar, mit der nach Geometrie gefiltert werden kann. Beispiel für einen Datumsfilter:
"startTime>\"2020-01-01T00:00:00+00:00\" AND
endTime<\"2020-02-01T00:00:00+00:00\""
Beispiel für einen Property-Filter:
"properties.CLOUDY_PIXEL_PERCENTAGE<30"
Beispiel für einen Geometriefilter:
"intersects(\"{'type':'Point','coordinates':[1,2]}\")"
"intersects(\"{\\\"type\\\":\\\"Point\\\",\\\"coordinates\\\":[1,2]}\")"
Weitere Informationen zur Filtersprache finden Sie unter https://google.aip.dev/160.
|
view |
enum (EarthEngineAssetView)
Gibt an, welche Teile der EarthEngineAsset-Ressource in der Antwort zurückgegeben werden sollen. Gilt nur für ImageCollection-Assets. Alle Elemente von Folder-Assets werden unabhängig vom Wert dieses Felds in der BASIC-Ansicht codiert.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von ListAssetsResponse.
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
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
Weitere Informationen finden Sie unter OAuth 2.0 Overview.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[[["\u003cp\u003eLists container assets, such as folders or collections, within a specified parent resource.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by date, properties, and geometry for \u003ccode\u003eImageCollection\u003c/code\u003e assets.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination to retrieve large result sets.\u003c/p\u003e\n"],["\u003cp\u003eRequires appropriate IAM permissions or OAuth scopes for authorization.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes details about the listed assets and a token for retrieving subsequent pages.\u003c/p\u003e\n"]]],["This describes the `listAssets` method, which retrieves a list of container assets like folders or collections. The method uses a `GET` request with the `parent` path parameter, specifying the container to list (e.g., projects or user folders). Optional query parameters include `pageSize` and `pageToken` for pagination, `filter` to filter `ImageCollection` assets by date, properties or geometry and `view` to specify the `EarthEngineAsset` returned parts. Authorization needs specific IAM permissions. The request body is empty.\n"],null,["# Method: projects.listAssets\n\nLists any container asset, such as a folder or collection.\n\n### HTTP request\n\n`GET https://earthengine.googleapis.com/v1alpha/{parent=projects/*}:listAssets`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The name of the container asset to list. `parent` is of the format \"projects/\\*\" or \"projects/\\*/assets/\\*\\*\" (e.g., \"projects/\\[PROJECT\\]\" or \"projects/earthengine-legacy/assets/users/\\[USER\\]/\\[ASSET\\]\"). All user-owned assets are currently under the project \"earthengine-legacy\" (e.g., \"projects/earthengine-legacy/assets/users/foo/bar\"). All other assets are under the project \"earthengine-public\" (e.g., \"projects/earthengine-public/assets/LANDSAT\"). If \"projects/earthengine-legacy\" is specified, the response will consist of a list of all top-level folders owned by the requesting user. Authorization requires one or more of the following [IAM](https://cloud.google.com/iam/docs/) permissions on the specified resource `parent`: - `earthengine.assets.get` - `earthengine.assets.list` |\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of results per page. The server may return fewer assets than requested. If unspecified, the page size default depends on the EarthEngineAssetView, with higher limits for more restrictive views. |\n| `pageToken` | `string` A token identifying a page of results the server should return. Typically this is the value of [ListAssetsResponse.next_page_token](/earth-engine/reference/rest/v1alpha/ListAssetsResponse#FIELDS.next_page_token) returned from the previous call to the `projects.listAssets` method. |\n| `filter` | `string` If present, specifies a filter. Filters are only applied to `ImageCollection` assets and are ignored for `Folder` assets. The fields `startTime`, `endTime`, and members of `properties` are recognized. The custom function `intersects(str)` is available, which allows filtering by geometry. An example date filter: \"startTime\u003e\\\"2020-01-01T00:00:00+00:00\\\" AND endTime\u003c\\\"2020-02-01T00:00:00+00:00\\\"\" An example property filter: \"properties.CLOUDY_PIXEL_PERCENTAGE\u003c30\" An example geometry filter: \"intersects(\\\"{'type':'Point','coordinates':[1,2]}\\\")\" \"intersects(\\\"{\\\\\\\"type\\\\\\\":\\\\\\\"Point\\\\\\\",\\\\\\\"coordinates\\\\\\\":[1,2]}\\\")\" See \u003chttps://google.aip.dev/160\u003e for more details on the filter language. |\n| `view` | `enum (`[EarthEngineAssetView](/earth-engine/reference/rest/v1alpha/EarthEngineAssetView)`)` Specifies which parts of the `EarthEngineAsset` resource should be returned in the response. Only applies to `ImageCollection` assets. All elements of `Folder` assets will be encoded in the `BASIC` view regardless of the value of this field. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [ListAssetsResponse](/earth-engine/reference/rest/v1alpha/ListAssetsResponse).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/earthengine`\n- `\n https://www.googleapis.com/auth/earthengine.readonly`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/cloud-platform.read-only`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
