Method: customers.policies.groups.batchModify

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

בקשת HTTP

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

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

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

פרמטרים
customer

string

מספר חשבון Google Workspace או המזהה המילולי 'my_customer' של הלקוח המשויך לבקשה.

גוף הבקשה

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

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

object (ModifyGroupPolicyRequest)

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

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

גוף התגובה

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

היקפי הרשאות

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

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

ModifyGroupPolicyRequest

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

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

object (PolicyTargetKey)

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

object (PolicyValue)

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

string (FieldMask format)

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

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