Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
Method: projects.updateConfig
Stay organized with collections
Save and categorize content based on your preferences.
Updates the config state of a project.
HTTP request
PATCH https://earthengine.googleapis.com/v1beta/{projectConfig.name=projects/*/config}
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
projectConfig.name |
string
Required. The project config name, of the format "projects/*/config".
|
Query parameters
| Parameters |
updateMask |
string (FieldMask format)
Required. The list of fields to update. This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".
|
Request body
The request body contains an instance of ProjectConfig.
Response body
If successful, the response body contains an instance of ProjectConfig.
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\u003eThis request updates specific settings within a project's configuration.\u003c/p\u003e\n"],["\u003cp\u003eIt uses the PATCH method and requires the project's config name in the URL.\u003c/p\u003e\n"],["\u003cp\u003eYou must specify the fields you want to change using the 'updateMask' query parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe request body contains the new configuration data in JSON format, following the 'ProjectConfig' structure.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is needed through either Earth Engine or Cloud Platform scopes.\u003c/p\u003e\n"]]],["This documentation describes updating a project's configuration state via a PATCH request to the specified URL, `https://earthengine.googleapis.com/v1beta/{projectConfig.name=projects/*/config}`. The request requires the project config name and an `updateMask` parameter listing the fields to modify. The request body contains a `ProjectConfig` instance, and upon success, returns a `ProjectConfig` instance. Authorization requires specific OAuth scopes related to Earth Engine or Cloud Platform.\n"],null,["# Method: projects.updateConfig\n\nUpdates the config state of a project.\n\n### HTTP request\n\n`PATCH https://earthengine.googleapis.com/v1beta/{projectConfig.name=projects/*/config}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------------|---------------------------------------------------------------------------------|\n| `projectConfig.name` | `string` Required. The project config name, of the format \"projects/\\*/config\". |\n\n### Query parameters\n\n| Parameters ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Required. The list of fields to update. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n\n### Request body\n\nThe request body contains an instance of [ProjectConfig](/earth-engine/reference/rest/v1beta/ProjectConfig).\n\n### Response body\n\nIf successful, the response body contains an instance of [ProjectConfig](/earth-engine/reference/rest/v1beta/ProjectConfig).\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)."]]