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