Method: folders.settings.updateValue
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
更新設定值。
如果設定或設定不存在,會傳回 google.rpc.Code.NOT_FOUND
的 google.rpc.Status
。如果設定標記為唯讀,會傳回含有 google.rpc.Code.FAILED_PRECONDITION
的 google.rpc.Status
。如果請求中提供的 etag 與設定值的永久 etag 不符,則傳回 google.rpc.Status
並傳回 google.rpc.Code.ABORTED
。
注意:提供的設定值會完全覆寫所有欄位。
HTTP 要求
PATCH https://resourcesettings.googleapis.com/v1alpha1/{settingValue.name=folders/*/settings/*/value}
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
settingValue.name |
string
設定值的資源名稱。必須採用下列其中一種格式:
projects/{project_number}/settings/{setting_name}/value
folders/{folder_id}/settings/{setting_name}/value
organizations/{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 和/或其關聯企業的註冊商標。
上次更新時間:2023-05-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"]],["上次更新時間:2023-05-25 (世界標準時間)。"],[[["Updates a setting value, returning errors if the setting or value is not found, read-only, or if the etag does not match."],["Uses a PATCH request to `https://resourcesettings.googleapis.com/v1alpha1/{settingValue.name=folders/*/settings/*/value}` with gRPC Transcoding syntax for updating."],["Requires a request body containing a `SettingValue` object for the update and returns the updated `SettingValue` in the response upon success."],["Needs the `https://www.googleapis.com/auth/cloud-platform` OAuth scope for authorization."]]],["This describes how to update a setting value via a `PATCH` HTTP request to a specific URL using gRPC Transcoding. The request requires a setting value name in a specific format, provided as a path parameter. The request and response bodies use the `SettingValue` instance. Errors result in specific `google.rpc.Status` codes. Authorization requires the `cloud-platform` OAuth scope. A successful request updates the setting value with a full overwrite and returns the updated `SettingValue`.\n"]]