Directory API 概览

Directory API 是 RESTful Admin SDK API 的一部分,可用于以编程方式创建和管理归 Google Workspace 帐号所有的由管理员控制的资源。一些用例包括:

  • 创建和管理用户以及添加管理员。
  • 创建和管理群组及群组成员资格。
  • 监控连接到您网域的设备并针对丢失的设备采取措施。
  • 管理组织结构图和组织结构。
  • 审核用户授予了访问权限的应用以及撤消未经授权的应用。

下面列出了 Directory API 中使用的常用术语:

客户
拥有 Google Workspace 帐号的实体,由 Customer 资源表示。
网域
与 Google Workspace 帐号关联的 DNS 网域(如果适用),由 Domain 资源表示。并非所有帐号都有关联的网域。
组织部门 (OU)
Google Workspace 帐号组织树的子单元,用于对用户进行分组和排序,以应用政策和授权。组织部门由OrgUnit资源表示。
权限
用户对 Google Workspace 资源执行操作的能力。主要适用于管理员。权限由权限资源表示。
Role
可以分配给一位或一组用户的一组已定义权限,由 Role 资源表示。
角色分配
一条记录,指明向哪个用户授予了哪些角色,在什么范围内授予了什么角色。角色分配由 RoleAssignment 资源表示。
架构
一个 JSON 对象,用于为您的组织定义自定义用户属性(以 Schema 资源表示)。
User
有权访问 Google Workspace 应用和资源的个人最终用户帐号,由 User 资源表示。

后续步骤

  • 如需了解如何使用 Google Workspace API 进行开发,包括处理身份验证和授权,请参阅 Workspace 开发者入门

  • 如需了解如何配置和运行简单的 Directory API 应用,请参阅 JavaScript 快速入门