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)

僅供輸出。新增的來源鍵會建立實體明確新增至管理的層級。對於某些類型的政策,只有在明確加入管理專用的政策時才能套用。例如應用程式和網路。您只能從已明確新增實體的機構單位中,從管理部分刪除實體。如果未指定這項政策,表示不需明確新增實體 (例如標準使用者政策或裝置政策) 管理政策。