AI-generated Key Takeaways
-
This process allows for the creation of Earth Engine assets.
-
Three asset types can be created: FOLDER, IMAGE, and IMAGE_COLLECTION, each with specific limitations on fields.
-
Asset creation requires a POST request to the specified URL with parent and optional query parameters like assetId and overwrite.
-
Authorization to create assets depends on the
earthengine.assets.createIAM permission on the parent resource. -
Successful asset creation returns an instance of EarthEngineAsset and requires one of the specified OAuth scopes.
Creates an asset.
The following asset types are createable: * FOLDER
: No fields in asset
may be specified. * IMAGE
: To create a COG-backed asset, use image.importExternal
instead. See https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff
for more details. * IMAGE_COLLECTION
: Only the fields startTime
, endTime
, and properties
may be specified.
HTTP request
POST https://earthengine.googleapis.com/v1/{parent=projects/*/locations/*}/assets
The URL uses gRPC Transcoding syntax.
Path parameters
parent
string
Required. The parent of the asset collection (e.g., "projects/*").
Authorization requires the following IAM
permission on the specified resource parent
:
-
earthengine.assets.create
Query parameters
| Parameters | |
|---|---|
assetId
|
The ID of the asset to create. Equivalent to name but without the "projects/*/assets" (e.g., users/[USER]/[ASSET]). |
overwrite
|
Whether to allow overwriting an image asset. |
Request body
The request body contains an instance of EarthEngineAsset
.
Response body
If successful, the response body contains a newly created instance of EarthEngineAsset
.
Authorization scopes
Requires one of the following OAuth scopes:
-
https://www.googleapis.com/auth/earthengine -
https://www.googleapis.com/auth/cloud-platform
For more information, see the OAuth 2.0 Overview .
