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"