Method: customers.policies.orgunits.batchModify

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

درخواست HTTP

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

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

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

پارامترها
customer

string

شناسه حساب G Suite یا «my_customer» برای مشتری مرتبط با درخواست.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "requests": [
    {
      object (ModifyOrgUnitPolicyRequest)
    }
  ]
}
فیلدها
requests[]

object ( ModifyOrgUnitPolicyRequest )

فهرست خط‌مشی‌هایی که باید مطابق با requests اصلاح شوند. تمام درخواست های موجود در لیست باید از این محدودیت ها پیروی کنند:

  1. همه طرحواره های موجود در لیست باید فضای نام ریشه یکسانی داشته باشند.
  2. همه مقادیر «policyTargetKey.targetResource» باید به یک منبع واحد سازمانی اشاره کنند.
  3. همه مقادیر «policyTargetKey» باید نام‌های کلیدی یکسانی در «اضافیTargetKeys» داشته باشند. این همچنین به این معنی است که اگر یکی از اهداف یک نقشه «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" .