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"