> ## 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 Contacts

> 将 Wave 联系人保存到您的 Google 联系人

<Info>
  适用于 **Pro**、**Teams** 和 **Enterprise** 计划。
</Info>

Google Contacts 集成通过 Google People API 将 Wave 联系人同步到您的 Google 联系人，让您遇到的每个人都自动保存，并可在 Gmail、Google Calendar 等 Google 产品中访问。

## 连接方式

<Steps>
  <Step title="打开集成">
    前往 **集成 → Google Contacts**。
  </Step>

  <Step title="连接 Google">
    点击 **连接** 并登录您的 Google 账户。
  </Step>

  <Step title="授权 Wave">
    授权 Wave 管理您的 Google 联系人。
  </Step>
</Steps>

Wave 请求对您的 Google 联系人的读写权限。

## 同步内容

| Wave 字段     | Google Contacts 字段               |
| ----------- | -------------------------------- |
| 名字          | `names.givenName`                |
| 姓氏          | `names.familyName`               |
| 显示名称        | `names.displayName`              |
| 主邮箱         | `emailAddresses`                 |
| 主电话         | `phoneNumbers`                   |
| 公司 + 职位     | `organizations`                  |
| 城市          | `locations`                      |
| 网站          | `urls`                           |
| Wave 联系人 ID | `externalIds`（类型：`wave-user-id`） |

**同步方向**：Wave → Google Contacts（仅出站）

**同步时机**：联系人创建、更新或删除时实时同步

## 功能特点

* **自动同步**：联系人在 Wave 中捕获后立即同步到 Google Contacts。
* **批量导入**：首次连接时，最多 200 条现有联系人将在一次批量操作中导入。
* **去重**：每条联系人都标记了 Wave 外部 ID，因此更新时会修改现有的 Google 联系人，而非创建新条目。

## 限制与要求

* 初始批量导入上限为 200 条联系人。
* 这是个人集成，按用户连接，而非按团队。

## 断开连接

前往 **集成 → Google Contacts** 并点击 **断开连接**。这将移除集成并撤销 Wave 的访问权限。已保存到 Google Contacts 的联系人不会被删除。