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. يجب أن تحتوي جميع المخططات في القائمة على مساحة الاسم الجذر نفسها.
  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"