واجهة برمجة التطبيقات للدليل: الوحدات التنظيمية

إدارة الوحدات التنظيمية

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

  • هناك شجرة مؤسسة واحدة فقط لحساب Google Workspace. عند إعداد هذا الحساب في البداية، يكون لديه وحدة تنظيمية على مستوى الحساب. هذه هي المؤسسة المرتبطة بالنطاق الأساسي. لمزيد من المعلومات عن النطاق الأساسي، يُرجى الاطّلاع على معلومات حول حدود واجهة برمجة التطبيقات.
  • يكون مسار الوحدة التنظيمية فريدًا. قد لا يكون اسم الوحدة التنظيمية فريدًا داخل التسلسل الهرمي للمؤسسة ولكن يكون اسمها فريدًا بين الوحدات التنظيمية التابعة لها. ولا يُراعي اسم الوحدة التنظيمية حالة الأحرف.
  • تكتسب الوحدة التنظيمية السياسات من التسلسل الهرمي التنظيمي. يمكن لأي وحدة تنظيمية حظر سلسلة اكتساب السياسات من الوحدات الرئيسية من خلال إلغاء السياسة المُكتسَبة. يتم تحديد أولوية سياسة على أخرى حسب أقرب وحدة تنظيمية. وهذا يعني أنّ سياسات الوحدة التنظيمية ذات المستوى الأدنى يمكن أن تكون لها الأولوية على سياسات الوحدات التنظيمية الرئيسية ذات المستوى الأعلى. لمزيد من المعلومات عن اكتساب الأذونات والمستخدمين في بنية المؤسسة، يُرجى الاطّلاع على مركز مساعدة الإدارة.
  • يمكن نقل الوحدة التنظيمية لأعلى أو لأسفل في شجرة هرمية. ويمكن نقل المستخدمين المرتبطين في المؤسسة بشكل فردي أو في دفعة عند تعبئة مؤسسة جديدة أو نقل مجموعة فرعية من المستخدمين من وحدة تنظيمية إلى أخرى.
  • يمكن أن تتغيّر البيانات المحفوظة في سمات الوحدة التنظيمية باستمرار. عند تقديم طلب، نضمن لك اتساق السمات المعروضة لكيان ما في وقت استرداد الكيان.وهذا يعني أنّك لن تظهر لك تعديلات "جزئية". إذا أدّت عملية الاسترداد إلى عرض أكثر من كيان واحد، لا يتوفّر ضمان للاتساق بين الكيانات، وخاصةً إذا كانت الاستجابة تمتد على عدة صفحات في التقسيم على صفحات.

إنشاء وحدة تنظيمية

لإنشاء وحدة تنظيمية، استخدِم طلب POST التالي وأضِف التفويض الموضّح في طلبات التفويض.

إذا كنت مشرفًا تنشئ وحدة تنظيمية، استخدِم my_customer.

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits

إذا كنت مورِّدًا تُنشئ وحدة تنظيمية لعميل توريد، استخدِم customerId. لاسترداد customerId، استخدِم عملية استرداد مستخدم.

POST https://admin.googleapis.com/admin/directory/v1/customer/customerId/orgunits

للتعرّف على بنية مؤسستك في حسابك، يُرجى الاطّلاع على مركز مساعدة المشرفين. للاطّلاع على سمات الطلب والاستجابة، راجِع مرجع واجهة برمجة التطبيقات.

طلب JSON

يعرض المثال التالي لمورِّد JSON نموذج نص طلب يؤدي إلى إنشاء الوحدة التنظيمية sales_support. يجب توفُّر name وparentOrgUnitPath: 

POST https://admin.googleapis.com/admin/directory/v1/customer/C03az79cb/orgunits

{
    "name": "sales_support",
    "description": "The sales support team",
    "parentOrgUnitPath": "/corp/support",
}

استجابة JSON

تعرِض الاستجابة الناجحة رمز حالة HTTP 201. وإلى جانب رمز الحالة، تعرض الاستجابة سمات المجموعة الجديدة: 

{
    "kind": "directory#orgUnit",
    "name": "sales_support",
    "description": "The sales support team",
    "orgUnitPath": "/corp/support/sales_support",
    "parentOrgUnitPath": "/corp/support"
  }

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

لتعديل وحدة تنظيمية، استخدِم طلب PUT التالي وأضِف التفويض الموضّح في تفويض الطلبات. للاطّلاع على سمات الطلب والاستجابة، راجِع مرجع واجهة برمجة التطبيقات:

إذا كنت مشرفًا تعدّل وحدة تنظيمية، استخدِم my_customer.

 PUT https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits/orgUnitPath

إذا كنت مورِّدًا تعدّل وحدة تنظيمية لعميل تم إعادة بيعه، استخدِم customerId. للحصول على customerId، استخدِم عملية استرداد مستخدم.

PUT https://admin.googleapis.com/admin/directory/v1/customer/customerId/orgunits/orgUnitPath

طلب JSON

في المثال أدناه، تم تعديل وصف الوحدة التنظيمية: 

PUT https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits/corp/support/sales_support

{
    "description": "The BEST sales support team"
}

ملاحظات حول طلب التعديل:

  • ما عليك سوى إرسال المعلومات المعدَّلة في طلبك. لست بحاجة إلى إدخال جميع خصائص المجموعة في الطلب.
  • إذا لم يتم تعيين مستخدم إلى وحدة تنظيمية معيَّنة عند إنشاء حساب المستخدم، يكون الحساب في الوحدة التنظيمية ذات المستوى الأعلى.
  • يمكنك نقل وحدة تنظيمية إلى جزء آخر من بنية المؤسسة في حسابك من خلال ضبط السمة parentOrgUnitPath في الطلب. تجدر الإشارة إلى أنّ نقل وحدة تنظيمية يمكن أن يؤدي إلى تغيير الخدمات والإعدادات للمستخدمين في الوحدة التنظيمية التي يتم نقلها.

استجابة JSON

تعرِض الاستجابة الناجحة رمز حالة HTTP 201. بالإضافة إلى رمز الحالة، تعرض الاستجابة خصائص الوحدة التنظيمية التي تم تعديلها. 

{
    "kind": "directory#orgUnit",
    "name": "sales_support",
    "description": "The BEST sales support team",
    "orgUnitPath": "/corp/support/sales_support",
    "parentOrgUnitPath": "/corp/support"
}

إذا لم يتم تعيين مستخدم إلى وحدة تنظيمية معيَّنة عند إنشاء حساب المستخدم، يكون الحساب في الوحدة التنظيمية ذات المستوى الأعلى. تحدِّد الوحدة التنظيمية للمستخدم خدمات Google Workspace التي يمكنه الوصول إليها. في حال نقل المستخدم إلى مؤسسة جديدة، تتغير إذن وصوله. لمزيد من المعلومات عن الهياكل التنظيمية، يُرجى الاطّلاع على مركز مساعدة الإدارة. لمزيد من المعلومات عن نقل مستخدم إلى مؤسسة مختلفة، يُرجى الاطّلاع على مقالة تعديل مستخدم.

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

لاسترداد وحدة تنظيمية، استخدِم طلب GET التالي وأضِف التفويض الموضّح في طلبات التفويض. سلسلة طلب البحث orgUnitPath هي المسار الكامل لهذه الوحدة التنظيمية. للاطّلاع على سمات الطلب والاستجابة، راجِع مرجع واجهة برمجة التطبيقات:

إذا كنت مشرفًا تسترجع وحدة تنظيمية، استخدِم my_customer.

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits/orgUnitPath

إذا كنت مورّدًا يستردّ وحدة تنظيمية لعميل تم إعادة بيعه، استخدِم customerId. للحصول على customerId، استخدِم عملية استرداد مستخدم.

GET https://admin.googleapis.com/admin/directory/v1/customer/customerId/orgunits/orgUnitPath

استجابة JSON

في المثال أدناه، يتم استرداد الوحدة التنظيمية "مبيعات خطوط المواجهة". يُرجى ملاحظة ترميز HTTP‏ "frontline+sales" في معرّف الموارد المنتظم للطلب: 

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits/corp/sales/frontline+sales

تعرِض الاستجابة الناجحة رمز الحالة HTTP 200. بالإضافة إلى رمز الحالة، تعرض الاستجابة إعدادات الوحدة التنظيمية: 

{
    "kind": "directory#orgUnit",
    "name": "frontline sales",
    "description": "The frontline sales team",
    "orgUnitPath": "/corp/sales/frontline sales",
    "parentOrgUnitPath": "/corp/sales"
}

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

لاسترداد جميع الوحدات التنظيمية الفرعية ضمن وحدة تنظيمية، أو الوحدات الفرعية المباشرة ضمن وحدة تنظيمية، أو جميع الوحدات التنظيمية الفرعية بالإضافة إلى الوحدة التنظيمية المحدّدة، استخدِم طلب GET التالي وأضِف التفويض الموضّح في طلبات التفويض. للاطّلاع على سمات الطلب والاستجابة، راجِع مرجع واجهة برمجة التطبيقات.

إذا كنت مشرف حساب يسترجع جميع الوحدات التنظيمية الفرعية، استخدِم my_customer. بغرض سهولة القراءة، يستخدم هذا المثال أحرف الرجوع إلى أول السطر: 

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer
/orgunits?orgUnitPath=full org unit path&type=all or children or all_including_parent

إذا كنت مورّدًا لاسترداد الوحدات التنظيمية لعميل توريد، استخدم customerId. للحصول على customerId، استخدِم عملية استرداد مستخدم: 

GET https://admin.googleapis.com/admin/directory/v1/customer/customerId
/orgunits?orgUnitPath=full org unit path&type=all or children or all_including_parent

تعرض سلسلة طلب البحث get إما all وحدة تنظيمية فرعية ضمن orgUnitPath، أو children المباشرة من orgUnitPath، أو جميع الوحدات التنظيمية الفرعية وorgUnitPath المحددة لـ all_including_parent. القيمة التلقائية هي type=children.

استجابة JSON

على سبيل المثال، يعرض هذا الطلب جميع الوحدات التنظيمية التي تبدأ بالوحدة التنظيمية /corp: 

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits?orgUnitPath=/corp&type=all

تعرِض الاستجابة الناجحة رمز الحالة HTTP 200. وإلى جانب رمز الحالة، تعرض الاستجابة الوحدات التنظيمية للحساب: 

{
"kind": "directory#orgUnits",
    "organizationUnits": [
     {
    "kind": "directory#orgUnit",
    "name": "sales",
    "description": "The corporate sales team",
    "orgUnitPath": "/corp/sales",
    "parentOrgUnitPath": "/corp"
     },
     {
    "kind": "directory#orgUnit",
    "name": "frontline sales",
    "description": "The frontline sales team",
    "orgUnitPath": "/corp/sales/frontline sales",
    "parentOrgUnitPath": "/corp/sales"
     },
     {
    "kind": "directory#orgUnit",
    "name": "support",
    "description": "The corporate support team",
    "orgUnitPath": "/corp/support",
    "parentOrgUnitPath": "/corp"
     },
     {
    "kind": "directory#orgUnit",
    "name": "sales_support",
    "description": "The BEST support team",
    "orgUnitPath": "/corp/support/sales_support",
    "parentOrgUnitPath": "/corp/support"
     }
  ]
  }

حذف وحدة تنظيمية

لحذف وحدة تنظيمية، استخدِم طلب DELETE التالي وأضِف التفويض الموضّح في طلبات التفويض. لاسترداد customerId، استخدِم عملية استرداد مستخدم. للاطّلاع على سمات الطلب والاستجابة، راجِع مرجع واجهة برمجة التطبيقات:

إذا كنت مشرف حساب وتريد حذف وحدة تنظيمية، استخدِم my_customer. 

DELETE https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits/orgUnitPath

في حال كنت مورِّدًا تحذف وحدة تنظيمية لعميل توريد، استخدِم customerId. للحصول على customerId، استخدِم عملية استرداد مستخدم. 

DELETE https://admin.googleapis.com/admin/directory/v1/customer/customerId/orgunits/orgUnitPath
 على سبيل المثال، يؤدي طلب DELETE الذي قدّمه مشرف المورّد هذا إلى حذف الوحدة التنظيمية backend_tests: 
DELETE https://admin.googleapis.com/admin/directory/v1/customer/C03az79cb/orgunits/corp/sales/backend_tests

تعرِض الاستجابة الناجحة رمز الحالة HTTP 200.

يمكنك فقط حذف الوحدات التنظيمية التي لا تحتوي على أي وحدات تنظيمية فرعية أو أي مستخدمين تم إسنادهم إليها. عليك إعادة تعيين المستخدمين إلى وحدات تنظيمية أخرى وإزالة أي وحدات تنظيمية فرعية قبل حذفها.