Method: projects.assets.getIamPolicy

  • Retrieves the access control policy for a specified Earth Engine resource, returning an empty policy if none is set.

  • Uses an HTTP POST request to the earthengine.googleapis.com endpoint with the resource name as a path parameter.

  • Optionally accepts a GetPolicyOptions object within the request body for customized policy retrieval.

  • Returns a Policy object in the response body if successful, containing the resource's access control details.

  • Requires authorization using one of the specified OAuth scopes related to Earth Engine or Google Cloud Platform access.

Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.

HTTP request

POST https://earthengine.googleapis.com/v1/{resource=projects/*/assets/**}:getIamPolicy

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
resource

string

REQUIRED: The resource for which the policy is being requested. See Resource names for the appropriate value for this field.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "options": {
    object (GetPolicyOptions)
  }
}
Fields
options

object (GetPolicyOptions)

OPTIONAL: A GetPolicyOptions object for specifying options to assets.getIamPolicy.

Response body

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

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/earthengine.readonly
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-platform.read-only

For more information, see the OAuth 2.0 Overview.