# 使用 GenderAPI 插件在 Google Sheets 中识别性别

> 安装插件、映射列，并处理选定的行范围。检查 unknown 结果、积分，以及插件与 V2 API 的区别。

Canonical HTML: https://www.genderapi.io/zh/blog/%E5%A6%82%E4%BD%95%E5%9C%A8-google-sheets-%E4%B8%AD%E8%AF%86%E5%88%AB%E6%80%A7%E5%88%AB-%E4%BD%BF%E7%94%A8-gender-api-%E6%8F%92%E4%BB%B6

Last reviewed: 2026-09-29

## 通过侧边栏处理选定的行

GenderAPI for Google Sheets 插件会读取一列姓名、电子邮箱地址或用户名，并把所选的结果字段写入表格。通过侧边栏，您可以处理指定的行范围并保存结果值，而无需在每个单元格中保留公式。

这是插件自身的工作流。插件的结果列和批量处理与 V2 REST API 公开的响应格式相互独立。

- [从 Google Workspace Marketplace 安装](https://workspace.google.com/marketplace/app/gender_api_for_google_sheets_determines/712811575775)
- [改用 GENDER 公式](https://www.genderapi.io/zh/blog/gender-gongshi-google-sheets-genju-xingming-shibie-xingbie)
- [为新行配置工作流](https://www.genderapi.io/zh/blog/%E5%A6%82%E4%BD%95%E5%9C%A8-google-sheets-%E4%B8%AD%E5%AE%9E%E6%97%B6%E8%AF%86%E5%88%AB%E5%AE%A2%E6%88%B7%E6%80%A7%E5%88%AB)

## 安装、连接并用小样本测试

- 从插件在 Google Workspace Marketplace 上的页面安装插件，并检查其请求的权限。在 Google Sheets 中打开“扩展程序”（Extensions）→ GenderAPI → Determine Gender。
- 选择一个 GenderAPI 密钥，或在侧边栏中输入密钥。确认所选账户有可用的积分。
- 选择工作表以及 name、email 或 username 方法。填写对应的源列和一个不含标题行的小行范围。
- 为性别选择单独的一列；如有需要，再为 probability、国家/地区和识别出的名字选择列。不要覆盖原始值。
- 如果您掌握可靠的地理背景信息，请使用国家/地区选项或包含国家/地区代码的列。不要根据您正在请求的预测来推断这一背景信息。
- 检查跳过已有结果的选项，开始处理，并在扩大范围之前复核所选的行。

## 映射输入和目标位置

| 设置 | 类型 | 选项与说明 |
| --- | --- | --- |
| API 密钥 | 账户标识 | 使用插件中选择的密钥，并确认其有效且有余额。 |
| 方法 | 选项 | 根据源列选择 name、email 或 username。 |
| 工作表和行范围 | 工作表和行号 | 只选择需要处理的行，并排除标题行。 |
| 源列 | 列引用 | 所选方法对应的唯一输入列。 |
| 地理背景 | 可选的选项或列 | 如有可靠的两位字母国家/地区代码，请使用它们。 |
| 结果列 | 列引用 | 性别是主要的目标位置。probability、国家/地区和识别出的名字为可选项。 |
| 跳过已有结果 | 复选框 | 请检查此选项，以免重新运行时意外替换已填写的行。 |

## 读取结果列

请把原始值保留在结果旁边。基于姓名的关联不能确定本人自述的性别，返回的国家/地区也不能证明居住地或国籍。

- 在处理整个数据集之前，请先检查一个普通结果、一个含义不明确的输入和一次失败的运行。
- 空单元格、文本 null 和公式错误是不同的值。请有意识地统一 unknown 结果的表示方式，但不要掩盖错误。
- 对于 unknown 或不确定的情况，请使用中性的表述，并把本人提供的信息与预测分开保存。

| 结果 | 类型 | 使用方式 |
| --- | --- | --- |
| Gender | 文本或未解析的值 | 只有在结果成功时才保存 male 或 female。把未解析的值保存为 unknown，并单独检查错误信息。 |
| Probability | 数值（如有） | 一个沿用下来的置信度指标。它并不对应 V2 的 confidence 字段，也不代表在您的数据上实测的准确率。 |
| Country | 文本（如有） | 查询返回的背景信息。请把它与经过核实的客户国家/地区分开保存。 |
| Found / normalized name | 文本（如有） | 处理过程中使用或提取出的名字。当电子邮箱地址或用户名含义不明确时，请检查这一值。 |

- [置信度值及其局限](https://www.genderapi.io/zh/accuracy-methodology)

## 规划积分、限制和重新运行

已注册的免费 GenderAPI 账户每天包含 200 个积分。这是账户余额，并不承诺每个工作流都能得到 200 个已识别的结果。开始之前，请检查所选密钥的余额以及该工具当前的处理选项。

插件和文件处理遵循各自的处理流程。V2 REST API 的批量限制、AI 选项和每个请求的计费字段并不会自动适用于这些工具。重新运行或重新计算可能会发送新的请求并消耗积分，因此不要默认它是免费的。

请先从小样本开始，保存已得到的结果，并在重新运行之前复核失败的行。如果您只需要修正一次导出或目标系统中的更新，请复用已有的结果。

- [账户方案与积分](https://www.genderapi.io/zh/price)

## 选择要共享的数据

电子表格集成会发送查询所需的值，并需要所选文档的相关权限。在处理个人数据之前，请检查谁可以访问该表格、连接的是哪个账户，以及使用了哪些目标列。

请把 API 密钥保存在插件设置中，而不要放在普通单元格、截图或共享的示例中。已发布的隐私政策说明了输入数据如何被处理、存储和记录。使用电子表格集成并不意味着数据只保留在您的设备上。

- [GenderAPI 隐私政策](https://www.genderapi.io/zh/privacy-policy)

## 何时直接使用 V2 API

如果您的应用需要明确的 AI 选项，并需要每个条目的 V2 status、source、confidence_kind 和 usage 信息，请配置单独的 HTTP 集成。请遵循 V2 的请求和响应契约：把 V2 字段名添加到插件自带的公式或现有插件中，并不会改变它们的行为。

- [请求参数](https://www.genderapi.io/zh/docs/v2/request-parameters)
- [V2 响应字段](https://www.genderapi.io/zh/docs/v2/responses)
- [使用 Python 进行 V2 集成](https://www.genderapi.io/zh/integrations/python)
- [使用 Node.js 进行 V2 集成](https://www.genderapi.io/zh/integrations/javascript)

## 使用侧边栏需要编写代码吗？

不需要。安装插件、连接密钥，然后映射源列和结果列即可。直接集成 V2 API 是面向自定义应用的另一种选择。

## 可以处理已有的行吗？

可以。请使用侧边栏中的工作表和行范围选项。开始处理之前，请检查标题行、输入类型、目标列以及已有结果的相关选项。

## 结果列与 V2 的 JSON 响应一致吗？

不一致。插件自身的处理会把兼容的字段写入表格。data 和 meta 对象以及 source 和 confidence_kind 字段属于直接调用 V2 REST API 的契约。

## 应该如何处理 unknown 结果？

请把它保存为 unknown，并与失败的运行区分开。复核含义不明确的输入，并使用中性的表述，而不是自动指定一个性别。

## 来源与文档

- [Google Sheets 插件官方页面](https://workspace.google.com/marketplace/app/gender_api_for_google_sheets_determines/712811575775)
- [GenderAPI 方案与积分](https://www.genderapi.io/zh/price)
- [GenderAPI 隐私政策](https://www.genderapi.io/zh/privacy-policy)
- [V2 请求契约](https://www.genderapi.io/zh/docs/v2/request-parameters)