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