> ## Documentation Index
> Fetch the complete documentation index at: https://wavecnct.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Workspace

> 将您的 Wave 团队目录与 Google Workspace 保持同步

<Info>
  适用于 **Teams** 和 **Enterprise** 计划。这是组织级集成，由管理员配置。
</Info>

Google Workspace 集成将您的 Wave 团队目录与 Google Workspace 目录保持同步。当员工在 Google Workspace 中被添加、更新或删除时，Wave 会自动反映这些变化，无需手动管理用户。

## 连接方式

<Steps>
  <Step title="打开集成">
    前往 **集成 → Google Workspace**（仅管理员）。
  </Step>

  <Step title="使用管理员账户连接">
    点击 **连接** 并使用 Google Workspace 管理员账户登录。
  </Step>

  <Step title="授权 Wave">
    授权 Wave 读取您的目录。
  </Step>

  <Step title="启用自动同步">
    开启 **自动同步** 以自动将所有未来目录变更应用到 Wave，或手动管理同步。
  </Step>
</Steps>

Wave 仅请求只读访问权限，以读取 Google Workspace 目录中的用户信息。

## 同步内容

| Google Workspace 字段 | Wave 用户字段 |
| ------------------- | --------- |
| 名字、姓氏               | 姓名        |
| 主邮箱                 | 邮箱        |
| 工作电话                | 工作电话      |
| 手机                  | 手机        |
| 职位（来自组织）            | 职位        |
| 城市（来自地址）            | 城市        |
| 语言偏好                | 语言        |

**同步方向**：Google Workspace → Wave（仅入站）

**同步时机**：通过 Google Workspace Webhook 实时同步，并支持按需手动刷新

## 功能特点

* **实时同步**：Google Workspace 中的员工变更（新入职、职位变动、离职）会通过 Webhook 在数分钟内反映到 Wave 中。
* **自动停用**：当员工在 Google Workspace 中被归档或停用时，其 Wave 账户会自动停用。
* **导入预览**：在启用自动同步前可预览所有 Workspace 用户。

## 限制与要求

* 需要 Google Workspace 管理员账户进行授权。
* 需要 Google 登录才能查看的个人头像不会被导入。
* 这是组织级集成，各团队成员无需单独连接。

## 断开连接

前往 **集成 → Google Workspace** 并点击 **断开连接**。这将移除集成、撤销 Wave 的访问权限，并取消注册 Webhook 订阅。现有 Wave 用户不会被删除。