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