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. לכל הסכימות ברשימה צריך להיות אותו מרחב שמות של הרמה הבסיסית (root).
  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"