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