Method: customers.policies.resolve

針對符合搜尋查詢的政策清單,取得政策的解析值。

HTTP 要求

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

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

路徑參數

參數
customer

string

G Suite 帳戶或常值「my_customer」的 ID。

要求主體

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

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)

僅供輸出。新增的來源金鑰會在哪個層級明確新增實體以用於管理。對於某些類型的政策,只有在明確增加管理政策時才適用這類政策,這項設定就能派上用場。例如應用程式與網路。您只能從明確加入機構單位的管理單位中刪除實體。如果沒有出現,表示政策在受管理的情況下,不需要明確新增實體,例如:標準使用者或裝置政策。