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