# 使用 GenderAPI 在 Airtable 中处理姓名和电子邮箱地址

> 配置 Airtable 扩展，并映射性别、国家/地区和 probability。保留已有的值，复核未解析的记录，并区分 V1 和 V2。

Canonical HTML: https://www.genderapi.io/zh/blog/%E4%BD%BF%E7%94%A8-gender-api-%E6%89%A9%E5%B1%95%E7%A8%8B%E5%BA%8F%E4%BB%8E-airtable-%E6%95%B0%E6%8D%AE%E4%B8%AD%E8%AF%86%E5%88%AB%E6%80%A7%E5%88%AB

Last reviewed: 2026-09-29

## 使用 Airtable 扩展映射字段

GenderAPI 扩展会从您选择的字段中读取姓名或电子邮箱地址，并把性别预测写入单独的目标字段。您还可以映射国家/地区、probability 和识别出的名字，并跳过性别目标字段中已有值的记录。

2026年9月27日审核的扩展代码针对姓名和电子邮箱地址使用 V1 端点及其顶层响应字段。本指南描述的是原生工作流。已安装的扩展可能会独立于本指南发生变化，因此在应用下面的映射之前，请先检查可用的选项。

- [Airtable Marketplace 上的 GenderAPI.io](https://airtable.com/marketplace/blkqCasjQIqmmBrmb/gender-api-io-determine-gender)
- [现有的 V1 文档](https://www.genderapi.io/zh/api-documentation/v1)

## 连接 base 并准备字段

- 打开正确的 base，在 Extensions 中添加 GenderAPI.io 并启动扩展。完成扩展显示的连接步骤。
- 选择要使用其积分的密钥。检查剩余余额，并确认该密钥属于正确的 GenderAPI 账户。
- 选择包含姓名或电子邮箱地址的表格和源字段。请把原始输入保留在该字段中，并为结果创建单独的字段。
- 选择必填的性别目标字段以及任何额外的目标字段。如需显示格式化的百分比值，请使用 percent 字段；如需保留 probability 的原始数值范围，请使用数字字段。
- 决定是否保留已填写的性别目标字段。跳过这些字段的选项也会保留上一次运行留下的未解析文本值。因此，请只清除您有意重新处理的结果。

## 映射扩展的输入和输出

| 扩展设置 | 是否必填 | 值与行为 |
| --- | --- | --- |
| 积分密钥 | 是 | 所选的 GenderAPI 账户密钥为处理的请求提供积分。 |
| 表格和源字段 | 是 | 源单元格包含一个姓名或一个电子邮箱地址。空的源单元格会被跳过。 |
| 性别目标字段 | 是 | 接收原生的 gender 字段。请把未解析的值与 male 和 female 区分开。 |
| 国家/地区目标字段 | 否 | 接收返回的 country 值。这是一个输出列，而不是请求中的国家/地区筛选。 |
| probability 目标字段 | 否 | 接收旧版 API 的 probability 值。percent 字段接收除以 100 之后的值，而数字字段保留原始数值范围。 |
| Found Name 目标字段 | 否 | 在有值时接收原生 API 返回的名字。请把这个推断出的候选值与源值分开保存。 |
| 跳过已填写的性别字段 | 否 | 保留目标字段中已有值的记录，包括未解析的文本。每次运行之前请检查该选项。 |

源字段中可以同时包含姓名和电子邮箱地址。在审核的实现中，包含 @ 的值会走电子邮箱地址路径。这条路由规则并不会核实邮箱是否存在。

## 处理整个表格之前先测试一小批记录

请先用一个包含一个姓名、一个电子邮箱地址、一个空单元格和一个含义不明确的输入的小测试表格开始。在处理主表格之前，请检查所选的目标字段，以及 Airtable 如何显示 probability 的数值范围。

在审核的代码中，未解析时的默认值可能显示为文本 null 和 probability 0。某些原生响应失败时也可能留下这些默认值，而连接错误可能会让记录保持不变。请检查运行状态和受影响的行：仅凭文本 null 并不能证明查询成功。

运行后请检查已有的值。请保留未解析的结果以便复核，而不要自行指定性别。基于姓名的预测不能确认一个人的性别认同，返回的国家/地区也不能证明其居住地。

| 您看到的情况 | 应采取的操作 |
| --- | --- |
| 预期的列中出现了预期的结果 | 保留原始输入以及任何额外字段，以便核对映射。 |
| 文本 null 或 probability 0 | 把该情况保留为未解析，并在决定是否重新查询之前检查处理状态。 |
| 已填写的目标字段保持不变 | 检查跳过选项。这种保留可能是有意为之。 |
| 出现有关密钥或积分的提示，或者出错后结果保持不变 | 先解决账户或连接问题，并找出受影响的记录，然后再重新开始。 |

## 控制积分消耗和重新运行

原生扩展使用所选的 GenderAPI 密钥逐个查询这些值。对未被跳过的相同记录重新运行，可能会发送新的请求并再次消耗积分。Airtable 的方案和扩展的可用性与这一账户余额无关。

原生输出不会显示 V2 响应中的 data/meta、明确的 AI 模式选择、每个条目的 usage 对象或 V2 的批量契约。对于此工作流，请使用 V1 文档；当您需要这些选项时，请使用下方单独的 API 方案。

扩展会把映射的值发送出去进行处理，并把结果写回您的 base。请查看已发布的数据处理政策以及扩展对相关记录的权限，不要在源映射中包含无关的字段。

- [价格与积分](https://www.genderapi.io/zh/price)
- [隐私政策](https://www.genderapi.io/zh/privacy-policy)

## 需要结构化响应时使用 V2

对于自定义集成，GenderAPI V2 接受姓名、电子邮箱地址和用户名，并返回明确的结果、置信度、来源和用量字段。请单独配置这一连接：阅读 V2 指南并不会改变已安装的应用或其输出列。

Python 和 Node.js 示例涵盖单个请求、批量请求、unknown 结果和运行错误。请先阅读身份验证指南，并在发送计费请求之前选择 AI 模式。

- [V2 身份验证](https://www.genderapi.io/zh/docs/v2/authentication)
- [V2 响应字段](https://www.genderapi.io/zh/docs/v2/responses)
- [Python 集成示例](https://www.genderapi.io/zh/integrations/python)
- [Node.js 集成示例](https://www.genderapi.io/zh/integrations/javascript)

## Airtable 扩展使用 GenderAPI V2 吗？

2026年9月27日审核的扩展代码针对姓名和电子邮箱地址使用 V1 端点。自定义的 V2 连接有不同的请求和响应字段，也不会更新已安装的扩展。

## 一个源字段可以同时包含姓名和电子邮箱地址吗？

可以。审核的扩展会把包含 @ 的非空值发送到电子邮箱地址查询，把其他值发送到姓名查询。这只是输入的路由，并不是对邮箱的核实。

## 为什么 probability 在百分比字段中显示得不一样？

对于 Airtable 的 percent 字段，扩展会把旧版 API 的 probability 值除以 100，以便 Airtable 以百分比形式显示。数字字段会保留原始数值范围。它不是 V2 的 confidence 字段。

## 跳过选项会保留未解析的结果吗？

会。当目标字段中已有值时就会保留，包括上一次运行留下的文本 null。请复核这些记录，并只清除您有意重新处理的值。

## 来源与文档

- [官方目录页面：Airtable](https://airtable.com/marketplace/blkqCasjQIqmmBrmb/gender-api-io-determine-gender)
- [GenderAPI V1 文档](https://www.genderapi.io/zh/api-documentation/v1)
- [单独的 V2 API 文档](https://www.genderapi.io/zh/api-documentation)