Method: organizations.settings.updateValue
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
更新設定值。
如果設定或設定值不存在，則傳回 google.rpc.Status (含 google.rpc.Code.NOT_FOUND)。如果設定標示為唯讀，則會傳回含 google.rpc.Status 的 google.rpc.Status。google.rpc.Code.FAILED_PRECONDITION如果要求中提供的 ETag 與設定值的持續性 ETag 不符，則會傳回含有 google.rpc.Code.ABORTED 的 google.rpc.Status。
注意：提供的設定值會完整覆寫所有欄位。
HTTP 要求
PATCH https://resourcesettings.googleapis.com/v1alpha1/{settingValue.name=organizations/*/settings/*/value}
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 |
settingValue.name |
string
設定值的資源名稱。必須採用下列其中一種形式：
projects/{project_number}/settings/{setting_name}/valuefolders/{folder_id}/settings/{setting_name}/valueorganizations/{organization_id}/settings/{setting_name}/value 例如「/projects/123/settings/gcp-enableMyFeature/value」
|
要求主體
要求主體包含 SettingValue 的例項。
回應主體
如果成功，回應主體會包含 SettingValue 的執行例項。
授權範圍
需要下列 OAuth 範圍：
https://www.googleapis.com/auth/cloud-platform
詳情請參閱驗證總覽一文。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-25 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-07-25 (世界標準時間)。"],[[["This operation updates a specific setting value, requiring a full overwrite of all fields."],["It uses a PATCH request to `https://resourcesettings.googleapis.com/v1alpha1/{settingValue.name=organizations/*/settings/*/value}` with the setting value's name as a path parameter."],["Potential errors include NOT_FOUND if the setting or value is missing, FAILED_PRECONDITION if the setting is read-only, and ABORTED if the provided etag doesn't match."],["Authorization requires the `https://www.googleapis.com/auth/cloud-platform` scope."]]],["This describes how to update a setting value using a `PATCH` request to a specific URL, including the setting's resource name in the path. The request body must contain a `SettingValue` instance, which will fully overwrite existing fields. Successful responses also return a `SettingValue` instance. Failures return a `google.rpc.Status`, indicating `NOT_FOUND`, `FAILED_PRECONDITION`, or `ABORTED`. The operation requires the `https://www.googleapis.com/auth/cloud-platform` OAuth scope.\n"]]
