Method: projects.locations.assets.create

  • This API endpoint is used to create different types of assets, including FOLDER, IMAGE, and IMAGE_COLLECTION.

  • The creation of certain asset types like IMAGE requires using image.importExternal for COG-backed assets.

  • The HTTP request method is POST to a specific URL with parent project and location information.

  • Required parameters for creating an asset include the parent and optionally an assetId and overwrite flag.

  • Successful creation returns a new EarthEngineAsset instance, and authorization requires specific 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/v1beta/{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.