Method: customers.policies.groups.batchModify

修改套用至特定群組的多個政策值。所有目標都必須採用相同的目標格式。也就是說,這些鍵必須指向相同的目標資源,且必須具備 additionalTargetKeyNames 中指定的相同鍵,但這些鍵的值可能不同。失敗時,要求會在 google.rpc.Status 中傳回錯誤詳細資料。

HTTP 要求

POST https://chromepolicy.googleapis.com/v1/{customer=customers/*}/policies/groups:batchModify

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
customer

string

Google Workspace 帳戶或常值「my_customer」的 ID。

要求主體

要求主體的資料會採用以下結構:

JSON 表示法
{
  "requests": [
    {
      object (ModifyGroupPolicyRequest)
    }
  ]
}
欄位
requests[]

object (ModifyGroupPolicyRequest)

根據 requests 定義要修改的政策清單。清單中的所有要求都必須符合下列限制:

  1. 清單中的所有結構定義都必須具有相同的根命名空間。
  2. 所有「policyTargetKey.targetResource」值都必須指向群組 資源。
  3. 所有「policyTargetKey」值在 「additionalTargetKeys」
  4. 不能有兩個修改要求可以參照同一個「policySchema」以及 「policyTargetKey」配對。

回應主體

如果成功,回應主體會是空白的。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/chrome.management.policy

ModifyGroupPolicyRequest

要求參數來修改特定群組目標的政策值。

JSON 表示法
{
  "policyTargetKey": {
    object (PolicyTargetKey)
  },
  "policyValue": {
    object (PolicyValue)
  },
  "updateMask": string
}
欄位
policyTargetKey

object (PolicyTargetKey)

必要欄位。要修改政策的目標鍵。目標資源必須指向群組。

policyValue

object (PolicyValue)

政策的新值。

updateMask

string (FieldMask format)

必要欄位。要更新的政策欄位。只會更新這個遮罩中的欄位。並忽略 policyValue 中的其他欄位 (即使這些欄位含有值)。如果這份清單中有某個欄位,則其「policyValue」必須包含一個值。

這是以半形逗號分隔的完整欄位名稱清單。範例:"user.displayName,photo"