Method: customers.policies.orgunits.batchModify

שינוי של כמה ערכי מדיניות שחלים על יחידה ארגונית ספציפית. לכל היעדים צריך להיות פורמט יעד זהה. כלומר, המפתחות צריכים להפנות לאותו משאב יעד ועליהם לציין אותם מפתחות ב-additionalTargetKeyNames, אם כי יכול להיות שהערכים למפתחות האלה יהיו שונים. אם הבקשה לא תתקבל, היא תחזיר את פרטי השגיאה כחלק מ-google.rpc.Status.

בקשת HTTP

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

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

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

פרמטרים
customer

string

מספר חשבון G Suite או המילה המילולית "my_customer" של הלקוח המשויך לבקשה.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "requests": [
    {
      object (ModifyOrgUnitPolicyRequest)
    }
  ]
}
שדות
requests[]

object (ModifyOrgUnitPolicyRequest)

רשימת כללי מדיניות שצריך לשנות בהתאם להגדרה ב-requests. כל הבקשות ברשימה חייבות לעמוד בהגבלות הבאות:

  1. לכל הסכימות ברשימה חייב להיות אותו מרחב שמות ברמה הבסיסית.
  2. כל הערכים של 'policyTargetKey.targetResource' חייבים להפנות למשאב של יחידה ארגונית.
  3. לכל ערכי 'policyTargetKey' צריכים להיות אותם שמות מפתחות ב-'additionalTargetKeys'. המשמעות היא גם שאם לאחד מהיעדים יש מפה ריקה מסוג 'additionalTargetKeys', כל היעדים חייבת לכלול מפה ריקה מסוג 'additionalTargetKeys'.
  4. שתי בקשות שינוי לא יכולות להפנות לאותו צמד 'policySchema' + ' policyTargetKey'.

גוף התגובה

אם הביצוע יהיה תקין, גוף התגובה יהיה ריק.

היקפי הרשאות

נדרש היקף OAuth הבא:

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

ModifyOrgUnitPolicyRequest

פרמטרים של בקשות לשינוי ערך מדיניות ליעד ספציפי של יחידה ארגונית.

ייצוג JSON 
{
  "policyTargetKey": {
    object (PolicyTargetKey)
  },
  "policyValue": {
    object (PolicyValue)
  },
  "updateMask": string
}
שדות
policyTargetKey

object (PolicyTargetKey)

חובה. מפתח היעד שעבורו אנחנו רוצים לשנות מדיניות. משאב היעד צריך להפנות ליחידה ארגונית.
policyValue

object (PolicyValue)

הערך החדש של המדיניות.
updateMask

string (FieldMask format)

חובה. שדות המדיניות שצריך לעדכן. רק שדות במסכה הזו יעודכנו. המערכת תתעלם משדות אחרים ב-policyValue (גם אם יש להם ערכים). אם שדה מסוים ברשימה הזו חייב להיות ערך ב-'policyValue'.

זוהי רשימה של שמות שדות מלאים, שמופרדים בפסיקים. דוגמה: "user.displayName,photo"