واجهة 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.