REST Resource: orgunits

المرجع: الوحدة التنظيمية

تتيح لك إدارة الوحدات التنظيمية في حسابك ضبط إمكانية وصول المستخدمين إلى الخدمات والإعدادات المخصصة. لمزيد من المعلومات حول المهام الشائعة للوحدات التنظيمية، يُرجى الاطّلاع على دليل مطوّر البرامج. يقتصر العرض الهرمي للوحدة التنظيمية للعميل على 35 مستوى من العمق.

تمثيل JSON 
{
  "kind": string,
  "name": string,
  "description": string,
  "etag": string,
  "blockInheritance": boolean,
  "orgUnitId": string,
  "orgUnitPath": string,
  "parentOrgUnitId": string,
  "parentOrgUnitPath": string
}
الحقول
kind

string

نوع مورد واجهة برمجة التطبيقات. بالنسبة إلى موارد الوحدات التنظيمية، تكون القيمة هي admin#directory#orgUnit.
name

string

اسم مسار الوحدة التنظيمية. على سبيل المثال، اسم الوحدة التنظيمية داخل المسار الرئيسي /corp/support/sales_support هو sales_support. مطلوبة.
description

string

تمثّل هذه السمة وصف الوحدة التنظيمية.
etag

string

علامة ETag للمورد.
blockInheritance
(deprecated)

boolean

تحدِّد هذه السياسة ما إذا كان بإمكان الوحدة التنظيمية الفرعية اكتساب إعدادات المؤسسة الرئيسية. القيمة التلقائية هي false، أي أن الوحدة التنظيمية الفرعية تكتسب إعدادات الوحدة التنظيمية الرئيسية الأقرب. تم إيقاف العمل بهذا الحقل. لم يعُد ضبطه على "true" متاحًا ويمكن أن يؤدي إلى عواقب غير مقصودة. لمزيد من المعلومات عن الاكتساب والمستخدمين في بنية مؤسسة، راجِع مركز مساعدة الإدارة.
orgUnitId

string

المعرّف الفريد للوحدة التنظيمية.
orgUnitPath

string

المسار الكامل للوحدة التنظيمية. السمة orgUnitPath هي سمة مشتقة. عند إدراجه، يتم استنتاجه من parentOrgunitPath وname للوحدة التنظيمية. على سبيل المثال، بالنسبة إلى وحدة تنظيمية باسم 'apps' ضمن المؤسسة الرئيسية '/الهندس'، تكون وحدة orgUnitPath هي '/Engineeringing/apps'. لتعديل orgUnitPath، عليك تعديل اسم المؤسسة أو parentOrgunitPath.
تحدِّد الوحدة التنظيمية للمستخدم خدمات Google Workspace التي يمكن للمستخدم الوصول إليها. في حال نقل المستخدم إلى مؤسسة جديدة، تتغير إمكانية وصول المستخدم. لمزيد من المعلومات عن بُنى المؤسسات، يُرجى الاطّلاع على مركز مساعدة الإدارة. لمزيد من المعلومات حول نقل مستخدم إلى مؤسسة مختلفة، يمكنك الاطّلاع على مقالة orgunits.update مستخدم.
parentOrgUnitId

string

المعرّف الفريد للوحدة التنظيمية الرئيسية هذه السمة مطلوبة ما لم يتم ضبط parentOrgUnitPath.
parentOrgUnitPath

string

المسار الرئيسي للوحدة التنظيمية على سبيل المثال، /corp/sales هو المسار الرئيسي للوحدة التنظيمية /corp/sales/sales_support. هذه السمة مطلوبة ما لم يتم ضبط parentOrgUnitId.

الطُرق

delete

 يؤدي إلى إزالة وحدة تنظيمية.

get

 استرداد وحدة تنظيمية.

insert

 لإضافة وحدة تنظيمية.

list

 يسترد قائمة بجميع الوحدات التنظيمية لحساب.

patch

 تعديل وحدة تنظيمية.

update

 تعديل وحدة تنظيمية.