針對符合搜尋查詢的政策清單,取得政策的解析值。
HTTP 要求
POST https://chromepolicy.googleapis.com/v1/{customer=customers/*}/policies:resolve
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
customer |
G Suite 帳戶或常值「my_customer」的 ID。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{
"policySchemaFilter": string,
"policyTargetKey": {
object ( |
欄位 | |
---|---|
policySchemaFilter |
必要欄位。要套用至解析要求的結構定義篩選器。 指定結構定義名稱即可查看特定結構定義,例如: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 |
必要欄位。應解析政策的目標資源鍵。 |
pageSize |
要傳回的政策數量上限,預設為 100 個,上限為 1000 個。 |
pageToken |
網頁權杖,用於擷取要求的特定頁面。 |
回應主體
取得特定目標已解決政策值的回應訊息。
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
---|
{
"resolvedPolicies": [
{
object ( |
欄位 | |
---|---|
resolvedPolicies[] |
解析要求找到的已解決政策清單。 |
nextPageToken |
網頁憑證可用於取得要求所找到的下一組已解析政策。 |
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/chrome.management.policy.readonly
https://www.googleapis.com/auth/chrome.management.policy
ResolvedPolicy
指定目標政策的解析值。
JSON 表示法 |
---|
{ "targetKey": { object ( |
欄位 | |
---|---|
targetKey |
僅供輸出。套用已解析政策值的目標資源。 |
value |
僅供輸出。政策的解析值。 |
sourceKey |
僅供輸出。取得這個政策值的來源資源。如果直接對目標修改政策,可能與 |
addedSourceKey |
僅供輸出。新增的來源金鑰會在哪個層級明確新增實體以用於管理。對於某些類型的政策,只有在明確增加管理政策時才適用這類政策,這項設定就能派上用場。例如應用程式與網路。您只能從明確加入機構單位的管理單位中刪除實體。如果沒有出現,表示政策在受管理的情況下,不需要明確新增實體,例如:標準使用者或裝置政策。 |