Method: projects.locations.assets.create

  • 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.create IAM 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

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

string

The ID of the asset to create. Equivalent to name but without the "projects/*/assets" (e.g., users/[USER]/[ASSET]).
overwrite

boolean

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.