Directory API 屬於 RESTful Admin SDK API 的一部分,可用來以程式輔助方式建立及管理 Google Workspace 帳戶擁有且由管理員控管的資源。某些用途包括:
- 建立及管理使用者以及新增管理員。
- 建立及管理群組和群組成員。
- 監控與您網域連結的裝置,並在遺失的裝置上採取行動。
- 管理機構圖表和機構架構。
- 稽核使用者已授權存取及撤銷未授權應用程式的應用程式。
以下列出 Directory API 的常用詞彙:
- 客戶
- 擁有 Google Workspace 帳戶的實體,以客戶資源表示。
- 網域
- 在適用情況下,與 Google Workspace 帳戶相關聯的 DNS 網域,由網域資源代表。並非所有帳戶都有相關聯的網域。
- 機構單位 (OU)
- Google Workspace 帳戶機構樹狀結構的子單位,用於將使用者分組及排序,以便套用政策及授權。機構單位會以 OrgUnit 資源表示。
- 權限
- 使用者對 Google Workspace 資源執行動作的能力。主要適用於管理員。權限會以權限資源表示。
- 角色
- 可以指派給單一使用者或一組使用者的權限集合,以角色資源表示。
- 角色指派
- 記錄會顯示哪些使用者獲派哪些角色,以及該角色的範圍。角色指派作業會以 RoleAssignment 資源表示。
- 結構定義
- 定義貴機構自訂使用者屬性的 JSON 物件,以結構定義資源表示。
- User
- 可存取 Google Workspace 應用程式和資源的個人使用者帳戶,以使用者資源表示。
後續步驟
如要瞭解如何使用 Google Workspace API 進行開發,包括處理驗證與授權,請參閱「開始成為 Workspace 開發人員」。
如要瞭解如何設定及執行簡單的 Directory API 應用程式,請嘗試 JavaScript 快速入門導覽課程。