Method: projects.assets.create

  • Creates an Earth Engine asset with the specified ID and type (FOLDER, IMAGE, or IMAGE_COLLECTION).

  • Requires authorization with earthengine.assets.create permission on the parent resource.

  • Allows specification of startTime, endTime, properties, and cloudStorageLocation for image assets.

  • Optionally overwrites existing image assets using the overwrite query parameter.

  • Uses a POST request to the earthengine.googleapis.com endpoint with asset details in the request body.

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/*}/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.