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