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