Method: customers.policies.groups.batchModify

چندین مقدار خط مشی که برای یک گروه خاص اعمال می شود را تغییر دهید. همه اهداف باید قالب هدف یکسانی داشته باشند. به این معنی که آنها باید به یک منبع هدف اشاره کنند و باید کلیدهای مشخص شده در additionalTargetKeyNames را داشته باشند، اگرچه مقادیر آن کلیدها ممکن است متفاوت باشد. در صورت شکست، درخواست جزئیات خطا را به عنوان بخشی از google.rpc.Status برمی گرداند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
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" .