Method: projects.image.import

  • The import image request uses an HTTP POST method with a specific URL structure following gRPC Transcoding syntax.

  • Path parameters include the project which requires earthengine.imports.create IAM permission for authorization.

  • The request body contains an imageManifest, optional description, overwrite boolean, and an optional requestId for deduplication.

  • A successful response returns an instance of Operation.

  • Authorization requires either the https://www.googleapis.com/auth/earthengine or https://www.googleapis.com/auth/cloud-platform OAuth scope.

Imports an image.

HTTP request

POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/image:import

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
project

string

The project id or project number of the Google Cloud Platform project that should be treated as the service consumer for this request. Format is projects/{project-id}.

Authorization requires the following IAM permission on the specified resource project:

  • earthengine.imports.create

Request body

The request body contains data with the following structure:

JSON representation 
{
  "imageManifest": {
    object (ImageManifest)
  },
  "description": string,
  "overwrite": boolean,
  "requestId": string
}
Fields
imageManifest

object (ImageManifest)

The image manifest.
description

string

A human-readable name of the task.
overwrite

boolean

Whether to allow overwriting an existing asset.
requestId

string

A unique string used to detect duplicated requests. If more than one request is made by the same user with the same non-empty requestId, only one of those requests may successfully start a long-running operation. requestId may contain the characters a..z, A..Z, 0-9, or '-'. requestId may be at most 60 characters long.

Response body

If successful, the response body contains an instance of Operation.

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.