Method: customers.policies.resolve

הפונקציה מחזירה את ערכי המדיניות שנפתרו עבור רשימת כללי מדיניות שתואמים לשאילתת חיפוש.

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

פרמטרים של נתיב

פרמטרים
customer

string

מספר חשבון G Suite או המילה המילולית "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.

לדוגמה: ערך תקין: "chrome.users.*", "chrome.users.apps.*", "chrome.printers.*" לא חוקי: "*", "*.users", "chrome.*", "chrome.*.apps.*"

policyTargetKey

object (PolicyTargetKey)

חובה. המפתח של משאב היעד שבו יש לפתור את המדיניות.

pageSize

integer

המספר המקסימלי של כללי מדיניות להחזרה, ברירת המחדל היא 100 ומקסימום 1,000.

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)

פלט בלבד. מפתח המקור שנוסף קובע את הרמה שבה ישות נוספה באופן מפורש לניהול. האפשרות הזו שימושית לסוג מסוים של כללי מדיניות שחלים רק אם הם נוספו במפורש לצורך ניהול. לדוגמה: אפליקציות ורשתות. ניתן למחוק ישות מניהול רק ביחידה ארגונית שאליה היא נוספה באופן מפורש. אם הוא לא מופיע, המשמעות היא שהמדיניות מנוהלת ללא צורך להוסיף ישות במפורש, לדוגמה: מדיניות משתמש רגילה או מדיניות מכשיר.