Method: customers.policies.orgunits.batchModify

修改套用至特定機構單位的多個政策值。所有目標都必須採用相同格式。這表示這些鍵必須指向相同的目標資源，且必須與 additionalTargetKeyNames 中指定的鍵相同，但這些鍵的值可能不同。要求失敗時，會傳回 google.rpc.Status 中的錯誤詳細資料。

HTTP 要求

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

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

路徑參數

參數
customer

string

與要求相關聯客戶的 G Suite 帳戶 ID 或常值「my_customer」。

要求主體

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

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

object (ModifyOrgUnitPolicyRequest)

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

  1. 清單中的所有結構定義都必須具有相同的根命名空間。
  2. 所有「policyTargetKey.targetResource」值都必須指向機構單位資源。
  3. 所有「policyTargetKey」值的鍵名稱在「 additionalTargetKeys」中都必須使用相同的鍵。這也表示如果其中一個目標有空白的「additionalTargetKeys」對應，則所有目標都必須有空白的「additionalTargetKeys」對應。
  4. 沒有任何兩項修改要求可以參照同一個「policySchema」和「policyTargetKey」組合。

回應主體

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

授權範圍

需要下列 OAuth 範圍：

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

ModifyOrgUnitPolicyRequest

要求參數以修改特定機構單位目標的政策值。

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

object (PolicyTargetKey)

必要欄位。這是指您要修改政策的目標鍵。目標資源必須指向機構單位。
policyValue

object (PolicyValue)

政策的新值。
updateMask

string (FieldMask format)

必要欄位。要更新的政策欄位。系統只會更新這個遮罩中的欄位，系統會忽略「policyValue」中的其他欄位 (即使這些欄位含有值)。如果這份清單中的欄位含有「policyValue」的值，

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