واجهة برمجة تطبيقات الدليل هي جزء من واجهة برمجة التطبيقات 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.