نمای اجمالی Directory API
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Directory API بخشی از RESTful Admin SDK API است که می‌تواند برای ایجاد و مدیریت برنامه‌نویسی منابع تحت کنترل سرپرست متعلق به حساب Google Workspace استفاده شود. برخی از موارد استفاده عبارتند از:
- ایجاد و مدیریت کاربران و اضافه کردن مدیران.
- ایجاد و مدیریت گروه ها و عضویت های گروهی.
- نظارت بر دستگاه های متصل به دامنه شما و انجام اقدامات در مورد دستگاه های گم شده.
- مدیریت نمودار سازمانی و ساختارهای سازمانی.
- حسابرسی برنامه هایی که کاربران شما اجازه دسترسی به برنامه های غیرمجاز و لغو آن را داده اند.
در زیر لیستی از اصطلاحات رایج مورد استفاده در Directory API آمده است:
- مشتری
- نهادی که دارای حساب Google Workspace است که توسط منبع مشتری ارائه می شود.
- دامنه
- در صورت وجود، دامنه DNS مرتبط با حساب Google Workspace، که توسط منبع دامنه نشان داده شده است. همه حساب ها دامنه مرتبطی ندارند.
- واحد سازمانی (OU)
- واحدی فرعی از درخت سازمانی حساب Google Workspace، که برای گروه‌بندی و مرتب‌سازی کاربران به منظور اعمال خط‌مشی‌ها و اعطای مجوز استفاده می‌شود. یک OU توسط منبع OrgUnit نشان داده می شود.
- امتیاز
- توانایی کاربر برای انجام یک عمل در یک منبع Google Workspace. در درجه اول برای ادمین ها اعمال می شود. یک امتیاز توسط منبع Privilege نشان داده می شود.
- نقش
- مجموعه تعریف شده ای از امتیازات که می تواند به یک کاربر یا مجموعه ای از کاربران اختصاص داده شود که توسط منبع Role نشان داده می شود.
- تعیین نقش
- رکوردی که نشان می‌دهد به کدام کاربر چه نقش‌هایی و در چه محدوده‌ای داده می‌شود. یک انتساب نقش با منبع RoleAssignment نشان داده می شود.
- طرحواره
- یک شی JSON که ویژگی های کاربر سفارشی را برای سازمان شما تعریف می کند که توسط منبع Schema نشان داده می شود.
- کاربر
- یک حساب کاربر نهایی فردی با دسترسی به برنامه‌ها و منابع Google Workspace که توسط منبع کاربر نشان داده می‌شود.
مراحل بعدی
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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)."]]
