تُعدّ Directory API جزءًا من واجهة برمجة التطبيقات RESTful Admin SDK API، ويمكن استخدامها لإنشاء وإدارة موارد يتحكّم فيها المشرف ويملكها حساب على Google Workspace بشكل آلي. وتشمل بعض حالات الاستخدام ما يلي:
- إنشاء المستخدمين وإدارتهم وإضافة مشرفين.
- إنشاء وإدارة المجموعات وعضويات المجموعات.
- مراقبة الأجهزة المتصلة بنطاقك واتّخاذ إجراءات بشأن الأجهزة المفقودة.
- إدارة المخطط التنظيمي والبنى التنظيمية.
- تدقيق التطبيقات التي منحها المستخدمون إمكانية الوصول إلى التطبيقات غير المُصرّح بها وإبطالها.
في ما يلي قائمة بالمصطلحات الشائعة المستخدمة في Directory API:
- العميل
- الكيان الذي يملك حساب Google Workspace، ويتمثل في مورد العميل.
- النطاق
- نطاق نظام أسماء النطاقات المرتبط بحساب Google Workspace، يمثله مورد النطاق، إن وُجد. لا ترتبط كل الحسابات بنطاق مرتبط.
- الوحدة التنظيمية (OU)
- وحدة فرعية من الهيكل التنظيمي لحساب Google Workspace تُستخدَم لتجميع المستخدمين وترتيبهم بهدف تطبيق السياسات ومنح التفويضات. يمثَّل مورد OrgUnit الوحدة التنظيمية.
- امتياز
- قدرة المستخدم على تنفيذ إجراء على مورد Google Workspace. ينطبق ذلك بشكل أساسي على المشرفين. ويتم تمثيل الامتياز من خلال مورد الامتياز.
- الدور
- مجموعة محددة من الامتيازات التي يمكن تخصيصها لمستخدم أو مجموعة من المستخدمين، ويمثلها مورد الدور.
- إسناد الأدوار
- سجلّ يشير إلى المستخدم الذي تم منحه الأدوار ونطاقه ويتم تمثيل إسناد الأدوار من خلال المرجع RoleAssignment.
- المخطّط
- كائن JSON يحدد سمات المستخدم المخصّصة لمؤسستك، ويمثله مورد Schema.
- المستخدم
- حساب مستخدم نهائي فردي لديه إمكانية الوصول إلى تطبيقات Google Workspace ومواردها، ويتم تمثيله في مورد المستخدم.
الخطوات التالية
للاطّلاع على معلومات حول التطوير باستخدام واجهات برمجة تطبيقات Google Workspace، بما في ذلك التعامل مع عمليات المصادقة والتفويض، يُرجى الرجوع إلى مقالة البدء كمطوّر برامج على Workspace.
للتعرّف على كيفية إعداد وتشغيل تطبيق Directory API بسيط، يمكنك تجربة البدء السريع لJavaScript.