Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
Method: projects.assets.setIamPolicy
Stay organized with collections
Save and categorize content based on your preferences.
Sets the access control policy on the specified resource. Replaces any existing policy.
HTTP request
POST https://earthengine.googleapis.com/v1alpha/{resource=projects/*/assets/**}:setIamPolicy
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
resource |
string
REQUIRED: The resource for which the policy is being specified. See Resource names for the appropriate value for this field.
|
Request body
The request body contains data with the following structure:
| JSON representation |
{
"policy": {
object (Policy)
}
} |
| Fields |
policy |
object (Policy)
REQUIRED: The complete policy to be applied to the resource. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Google Cloud services (such as Projects) might reject them.
|
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/cloud-platform
For more information, see the OAuth 2.0 Overview.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-03-06 UTC.
[null,null,["Last updated 2025-03-06 UTC."],[[["\u003cp\u003eThe \u003ccode\u003esetIamPolicy\u003c/code\u003e method allows you to define access control for a specific Earth Engine resource, replacing any existing policy.\u003c/p\u003e\n"],["\u003cp\u003eYou send a \u003ccode\u003ePOST\u003c/code\u003e request to the specified URL, including the resource name and the desired policy in the request body.\u003c/p\u003e\n"],["\u003cp\u003eThe policy you provide in the request should adhere to the structure defined in the \u003ccode\u003ePolicy\u003c/code\u003e object and can be a few 10s of KB in size.\u003c/p\u003e\n"],["\u003cp\u003eA successful response will return the applied \u003ccode\u003ePolicy\u003c/code\u003e object, confirming the access control settings for the resource.\u003c/p\u003e\n"],["\u003cp\u003eTo use this method, you need appropriate authorization with either the \u003ccode\u003eearthengine\u003c/code\u003e or \u003ccode\u003ecloud-platform\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This content describes setting an access control policy on a specified resource using a POST request to the `setIamPolicy` endpoint. The request requires a `resource` path parameter, and the body must contain the complete `policy` object to be applied. The `policy` replaces any existing policy. Successful requests return a `Policy` object. Authorization requires specific OAuth scopes, including `earthengine` or `cloud-platform`. The policy size is limited.\n"],null,["# Method: projects.assets.setIamPolicy\n\nSets the access control policy on the specified resource. Replaces any existing policy.\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1alpha/{resource=projects/*/assets/**}:setIamPolicy`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `resource` | `string` REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------|\n| ``` { \"policy\": { object (/earth-engine/reference/rest/Shared.Types/Policy) } } ``` |\n\n| Fields ||\n|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `policy` | `object (`[Policy](/earth-engine/reference/rest/Shared.Types/Policy)`)` REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Google Cloud services (such as Projects) might reject them. |\n\n### Response body\n\nIf successful, the response body contains an instance of [Policy](/earth-engine/reference/rest/Shared.Types/Policy).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/earthengine`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]