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 帐号 ID,或文字为“my_customer”。

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "requests": [
    {
      object (ModifyGroupPolicyRequest)
    }
  ]
}
字段
requests[]

object (ModifyGroupPolicyRequest)

按照 requests 的定义,要修改的政策列表。列表中的所有请求都必须遵守以下限制条件:

  1. 列表中的所有架构都必须具有相同的根命名空间。
  2. 所有“policyTargetKey.targetResource”值都必须指向组资源。
  3. 所有“policyTargetKey”值在“additionalTargetKeys”中必须具有相同的“appId”键名称。
  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"