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"