选择与输入相匹配的函数
安装 GenderAPI Excel 插件，在其侧边栏中保存您的 API 密钥，然后对姓名使用 GENDER.FROM_NAME，对电子邮箱地址使用 GENDER.FROM_EMAIL，对用户名使用 GENDER.FROM_USERNAME。每个函数先接收输入，然后是一个可选的额外信息开关，最后是可选的国家/地区背景。
这些 Excel 公式基于旧版 API。Google Sheets 的 GENDER 公式有不同的签名，而直接调用的 V2 REST API 有自己的 JSON 契约。
三个参数，顺序固定
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
name / email / username | 文本或单元格引用 | 必填 | 所选函数的输入，例如 A2。 |
enable_additional_info | 布尔值 | FALSE | TRUE 或 1 会返回四列。省略该参数或使用 FALSE/0 时只返回性别。 |
country | 文本 | 不按国家/地区筛选 | 可选的两位字母国家/地区代码，例如 IT、US、DE 或 TR。如果提供了第三个参数，也必须提供第二个参数。 |
每一行都是一个独立的示例。请在 A2 中输入相应的姓名、电子邮箱地址或用户名。根据 Excel 的区域设置，参数分隔符可能是分号而不是逗号。
=GENDER.FROM_NAME(A2)
=GENDER.FROM_NAME(A2, TRUE, "IT")
=GENDER.FROM_EMAIL(A2, TRUE)
=GENDER.FROM_USERNAME(A2, FALSE)Excel 中的扩展输出占用四列
不启用额外信息时，公式只返回性别。启用后，Excel 文档中说明的输出会在一行中依次填入性别、probability、国家/地区和识别出的名字。请让右侧的三个单元格保持为空。
Google Sheets 公式会把国家/地区放在 probability 之前，因此在核实 Excel 中适用的顺序之前，不要直接复用那里的列标题。
| 位置 | Excel 输出 | 含义 |
|---|---|---|
| 1 | Gender | 识别出的性别或未解析的值。请单独处理运行错误。 |
| 2 | Probability | 旧版 API 的置信度信号；它不是 V2 的 confidence_kind，也不是实测的模型准确率。 |
| 3 | Country | 查询返回的国家/地区背景，而不是当事人经过核实的属性。 |
| 4 | Matched name | 请检查使用或提取出的名字，尤其是对于电子邮箱地址和用户名。 |
向下复制公式之前先修正配置错误
重新计算可能会触发一次新的查询。如果您需要一个稳定的快照，请把已得到的结果以值的形式粘贴，并在旁边保存原始数据和核对日期。
| 症状 | 检查内容 |
|---|---|
| 函数不可用 | 确认插件已安装，并且在此工作簿和此 Excel 环境中可用。 |
| 未提供 API 密钥 | 打开 GenderAPI 侧边栏并保存密钥。写在单元格中的密钥不能代替插件中保存的凭据。 |
| 输入为空 | 检查公式引用的单元格，并选择与实际输入类型相匹配的函数。 |
| 没有出现扩展输出 | 腾出所需的相邻目标单元格，但不要覆盖有用的数据。 |
| 错误信息或 unknown error | 检查连接、账户状态和返回的信息。运行错误并不是未解析的预测。 |
规划积分、限制和重新运行
已注册的免费 GenderAPI 账户每天包含 200 个积分。这是账户余额，并不承诺每个工作流都能得到 200 个已识别的结果。开始之前，请检查所选密钥的余额以及该工具当前的处理选项。
插件和文件处理遵循各自的处理流程。V2 REST API 的批量限制、AI 选项和每个请求的计费字段并不会自动适用于这些工具。重新运行或重新计算可能会发送新的请求并消耗积分，因此不要默认它是免费的。
请先从小样本开始，保存已得到的结果，并在重新运行之前复核失败的行。如果您只需要修正一次导出或目标系统中的更新，请复用已有的结果。
何时直接使用 V2 API
如果您的应用需要明确的 AI 选项，并需要每个条目的 V2 status、source、confidence_kind 和 usage 信息，请配置单独的 HTTP 集成。请遵循 V2 的请求和响应契约：把 V2 字段名添加到插件自带的公式或现有插件中，并不会改变它们的行为。
常见问题
可以在 Microsoft Excel 中使用 =GENDER(A2) 吗？
Excel 插件文档中说明的函数是 GENDER.FROM_NAME、GENDER.FROM_EMAIL 和 GENDER.FROM_USERNAME。简单的 GENDER 公式属于 Google Sheets 插件。
如何在不返回额外输出的情况下提供国家/地区？
请保持第二个参数为关闭状态，例如 =GENDER.FROM_NAME(A2, FALSE, "IT")。国家/地区是第三个参数，而不是第二个。
额外信息选项的默认值是什么？
省略该参数时，它处于关闭状态。TRUE 或 1 会启用四列输出：性别、probability、国家/地区和识别出的名字。
这些函数会返回 V2 的计费信息吗？
不会。内置公式显示的是旧版 API 的结果字段。如果您需要请求元数据、source、confidence_kind 或每个请求的用量，请使用单独的 V2 集成。
来源与文档
本指南最近一次审核于 。请在平台文档中确认安装方式；如需单独构建 V2 集成，请使用下列 API 文档。