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 الوحدة التنظيمية. على سبيل المثال، بالنسبة إلى وحدة تنظيمية باسم "التطبيقات" ضمن المؤسسة الرئيسية "‎/engineering"، يكون orgUnitPath هو "‎/engineering/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

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