Method: customers.policies.resolve

获取与搜索查询匹配的一系列政策的解析政策值。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
customer

string

G Suite 账号的 ID,即“my_customer”。

请求正文

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

JSON 表示法
{
  "policySchemaFilter": string,
  "policyTargetKey": {
    object (PolicyTargetKey)
  },
  "pageSize": integer,
  "pageToken": string
}
字段
policySchemaFilter

string

必需。要应用于解析请求的架构过滤条件。

指定架构名称以查看特定架构,例如:chrome.users.ShowLogoutButton

支持使用通配符,但只能在架构名称的叶部分使用。通配符不能直接在命名空间中使用。如需详细了解架构命名空间,请参阅 https://developers.google.com/chrome/policy/guides/policy-schemas

例如:Valid: "chrome.users.*","chrome.users.apps.*","chrome.printers.*"无效:“*”“*.users”“chrome.*”“chrome.*.apps.*”

policyTargetKey

object (PolicyTargetKey)

必需。应针对其解析政策的目标资源的键。

pageSize

integer

要返回的最大政策数,默认值为 100,最大值为 1000。

pageToken

string

用于检索特定请求中的页面令牌。

响应正文

用于获取已解析特定目标的政策值的响应消息。

如果成功,响应正文将包含结构如下的数据:

JSON 表示法
{
  "resolvedPolicies": [
    {
      object (ResolvedPolicy)
    }
  ],
  "nextPageToken": string
}
字段
resolvedPolicies[]

object (ResolvedPolicy)

通过解析请求找到的已解析政策的列表。

nextPageToken

string

用于获取通过请求找到的下一组已解决政策的页面令牌。

授权范围

需要以下 OAuth 范围之一:

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

ResolvedPolicy

给定目标的政策解析值。

JSON 表示法
{
  "targetKey": {
    object (PolicyTargetKey)
  },
  "value": {
    object (PolicyValue)
  },
  "sourceKey": {
    object (PolicyTargetKey)
  },
  "addedSourceKey": {
    object (PolicyTargetKey)
  }
}
字段
targetKey

object (PolicyTargetKey)

仅限输出。已解析的政策值适用的目标资源。

value

object (PolicyValue)

仅限输出。政策的解析值。

sourceKey

object (PolicyTargetKey)

仅限输出。从中获取此政策值的来源资源。如果直接在目标上修改了政策,则可能与 targetKey 相同,否则,它会从中获取政策值的其他资源(如果适用)。如果不存在,来源就是客户的默认价值。

addedSourceKey

object (PolicyTargetKey)

仅限输出。添加的来源键可确定在哪个级别明确添加实体以进行管理。这对于某些类型的政策来说非常有用,这类政策只有在明确添加以进行管理时才会应用。例如:应用和网络。实体只能从明确添加到的组织部门的管理中删除。如果此字段未显示,则表示该政策无需明确添加实体即可进行管理,例如标准用户政策或设备政策。