在保存有效的服务账号 JSON 密钥并将集成设为 On 之前，同步不会运行。请像对待密码一样保管 JSON 密钥——任何人持有该密钥且已配置全域委托，都能以你选择的管理员身份读取目录。
你需要准备
- 可创建服务账号并下载 JSON 密钥的 Google Cloud 项目
- Google Workspace 超级管理员（用于授权全域委托）
- 要同步的 Workspace 域名（例如
hilt.ai） - 该域名上可供服务账号模拟的管理员邮箱
admin.directory.user.readonly）。不会读取 Gmail，也不会修改 Workspace 设置。
设置步骤
1
在 Google Cloud 中启用 Admin SDK
打开 Google Cloud Console，选择或创建项目。进入 APIs & Services → Library，搜索 Admin SDK API 并启用。未启用该 API 时，Directory 同步无法运行。
2
创建服务账号并下载 JSON 密钥
进入 IAM & Admin → Service Accounts → Create service account。起一个可识别的名称，例如
hilt-workspace-sync。Directory 同步无需在 GCP 项目上授予角色。打开新服务账号 → Keys → Add key → Create new key → JSON，然后下载文件。该文件即粘贴到 Hilt 的内容。3
在 Google Workspace 中授权全域委托
在服务账号详情中复制 Client ID（数字 ID，不是邮箱）。以超级管理员身份打开 Google Admin Console → Security → Access and data control → API controls → Manage Domain Wide Delegation → Add new。粘贴 Client ID，并在一行中授权以下 OAuth scope：
https://www.googleapis.com/auth/admin.directory.user.readonlyGCP 步骤与此 Workspace 授权缺一不可。4
在 Hilt 中完成配置
打开 设置 → 集成 → Google Workspace。填写 Workspace 域名（例如
hilt.ai）、服务账号可模拟的 管理员邮箱（真实 Workspace 管理员，例如 you@hilt.ai），并将下载的 JSON 密钥全文粘贴到 Service account JSON。点击 Save connection，再将集成设为 On。Hilt 会同步目录并显示这些用户的安装覆盖情况。