نظرة عامة على Directory API

تُعدّ Directory API جزءًا من RESTful Admin SDK API ويمكن استخدامها لإنشاء وإدارة موارد يتحكّم فيها المشرف ويملكها حساب Google Workspace بشكل آلي. تشمل بعض حالات الاستخدام ما يلي:

  • إنشاء المستخدمين وإدارتهم وإضافة المشرفين.
  • إنشاء المجموعات وعضويات المجموعات وإدارتها.
  • مراقبة الأجهزة المتصلة بنطاقك واتّخاذ إجراءات بشأن الأجهزة المفقودة
  • إدارة المخطط التنظيمي وهياكل المؤسسات.
  • مراجعة التطبيقات التي منحها المستخدمون إمكانية الوصول إلى التطبيقات غير المُصرَّح بها وإبطالها.

في ما يلي قائمة بالمصطلحات الشائعة المستخدمة في Directory API:

العميل
الكيان الذي يملك حساب Google Workspace، الذي يمثله مورد العميل.
النطاق
نطاق نظام أسماء النطاقات المرتبط بحساب على Google Workspace، يمثّله مورد النطاق، إذا كان ذلك منطبقًا ولا تملك جميع الحسابات نطاقًا مرتبطًا.
الوحدة التنظيمية
وحدة فرعية من الشجرة التنظيمية لحساب Google Workspace تُستخدَم لتجميع المستخدمين وترتيبهم بغرض تطبيق السياسات ومنح التراخيص. ويتم تمثيل الوحدة التنظيمية بمورد OrgUnit.
امتياز
هي قدرة المستخدم على تنفيذ إجراء على مورد Google Workspace. ينطبق ذلك بشكل أساسي على المشرفين. ويتم تمثيل الامتياز من خلال مورد الامتياز.
الدور
مجموعة محدَّدة من الامتيازات التي يمكن منحها لمستخدم أو مجموعة من المستخدمين، ويتم تمثيلها من خلال مورد الدور.
إسناد الأدوار
سجلّ يشير إلى المستخدم الذي تم منحه الأدوار والمهام والنطاق يتم تمثيل عملية إسناد الدور من خلال مورد RoleAssignment.
المخطّط
كائن JSON يحدد سمات المستخدم المخصصة لمؤسستك، ويمثله مورد المخطط.
المستخدم
حساب فردي للمستخدم النهائي يمكنه الوصول إلى تطبيقات وموارد Google Workspace، ويتم تمثيله في مورد المستخدم.

الخطوات التالية

  • للاطّلاع على معلومات عن التطوير باستخدام واجهات برمجة التطبيقات في Google Workspace، بما في ذلك معالجة المصادقة والتفويض، يُرجى الرجوع إلى مقالة البدء كمطوّر في Workspace.

  • لمعرفة كيفية تهيئة وتشغيل تطبيق بسيط لواجهة برمجة التطبيقات، يمكنك تجربة البدء السريع لـ JavaScript.