نظرة عامة على Directory API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
واجهة Directory API هي جزء من واجهة RESTful Admin SDK API التي يمكن استخدامها لإنشاء الموارد التي يتحكّم فيها المشرف والتي يملكها حساب Google Workspace وإدارتها آليًا. تشمل بعض حالات الاستخدام ما يلي:
- إنشاء المستخدمين وإدارتهم وإضافة المشرفين
- إنشاء المجموعات وإدارتها وإدارة عضويتها
- مراقبة الأجهزة المتصلة بنطاقك واتخاذ إجراءات بشأن الأجهزة المفقودة
- إدارة المخطط التنظيمي وبُنى المؤسسة
- تدقيق التطبيقات التي منحها المستخدمون إذن الوصول إليها وإبطال التطبيقات غير المصرّح بها
في ما يلي قائمة بالمصطلحات الشائعة المستخدَمة في Directory API:
- العميل
- الكيان الذي يملك حساب Google Workspace، ويتم تمثيله من خلال مورد
العميل.
- النطاق
- إذا كان ذلك منطبقًا، يشير هذا الحقل إلى نطاق نظام أسماء النطاقات المرتبط بحساب Google Workspace،
وتمثله السمة
Domain. لا تتضمّن بعض الحسابات نطاقًا مرتبطًا بها.
- الوحدة التنظيمية (OU)
- هي وحدة فرعية من الهيكل التنظيمي لحساب Google Workspace، تُستخدَم لتجميع المستخدمين وفرزهم بغرض تطبيق السياسات ومنح الأذونات. يتم تمثيل الوحدة التنظيمية من خلال مورد
OrgUnit.
- الامتياز
- هي إذن يتيح للمستخدم تنفيذ إجراء على أحد موارد Google Workspace.
ينطبق هذا الإجراء بشكل أساسي على المشرفين. يتم تمثيل الامتياز من خلال مورد الامتياز.
- Role
- مجموعة محدّدة من الامتيازات التي يمكن منحها لمستخدم أو مجموعة من المستخدمين، ويتم تمثيلها من خلال مورد الدور.
- إسناد الدور
- سجلّ يوضّح الأدوار الممنوحة لكل مستخدم ونطاقها
يتم تمثيل تعيين الدور من خلال مورد
RoleAssignment.
- المخطط
- كائن JSON يحدّد سمات المستخدم المخصّصة لمؤسستك،
وتمثّله
Schema.
- المستخدم
- حساب مستخدم نهائي فردي يمكنه الوصول إلى تطبيقات وموارد Google Workspace، ويتم تمثيله من خلال مورد المستخدم.
الخطوات التالية
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Directory API Overview\n\n|-------------------------------------------------------------------------------------------------------------------------------------------|\n| Got 5 minutes? Help us improve our Google Workspace documentation by taking a quick [online survey](https://forms.gle/XcqRP3PJiQv9ADuj9). |\n\nThe Directory API is part of the RESTful Admin SDK API that can be used to\nprogrammatically create and manage admin-controlled resources owned by a\nGoogle Workspace account. Some use cases include:\n\n- Creating and managing users and adding administrators.\n- Creating and managing groups and group memberships.\n- Monitoring devices connected to your domain and taking action on lost devices.\n- Managing your org chart and organization structures.\n- Auditing applications your users have granted access to and revoking unauthorized apps.\n\nFollowing is a list of common terms used in the Directory API:\n\n*Customer*\n: The entity that owns the Google Workspace account, represented by the\n [Customer](/workspace/admin/directory/reference/rest/v1/customers) resource.\n\n*Domain*\n: If applicable, the DNS domain associated with a Google Workspace account,\n represented by the\n [Domain](/workspace/admin/directory/reference/rest/v1/domains) resource. Not all\n accounts have an associated domain.\n\n*Organizational unit (OU)*\n: A sub-unit of a Google Workspace account's organizational tree, used to\n group and sort users for the purpose of applying policies and granting\n authorizations. An OU is represented by the\n [OrgUnit](/workspace/admin/directory/reference/rest/v1/orgunits) resource.\n\n*Privilege*\n: The ability of a user to perform an action on a Google Workspace resource.\n Applies primarily to admins. A privilege is represented by the\n [Privilege](/workspace/admin/directory/reference/rest/v1/privileges/list#Privilege)\n resource.\n\n*Role*\n: A defined collection of privileges that can be assigned to a user or set of\n users, represented by the\n [Role](/workspace/admin/directory/reference/rest/v1/roles) resource.\n\n*Role assignment*\n: A record indicating which user is granted what roles, and over what scope.\n A role assignment is represented by the\n [RoleAssignment](/workspace/admin/directory/reference/rest/v1/roleAssignments)\n resource.\n\n*Schema*\n: A JSON object that defines custom user attributes for your organization,\n represented by the\n [Schema](/workspace/admin/directory/reference/rest/v1/schemas) resource.\n\n*User*\n: An individual end user account with access to Google Workspace apps and\n resources, represented by the\n [User](/workspace/admin/directory/reference/rest/v1/users) resource.\n\nNext steps\n----------\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer to\n [Get started as a Workspace developer](/workspace/guides/getstarted-overview).\n\n- To learn how to configure and run a simple Directory API app, try the\n [JavaScript quickstart](/workspace/admin/directory/v1/quickstart/js)."]]
