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