必需扩展程序
安装 GenderAPI Google Sheets Add-On
自定义公式依赖 Add-On。请从 Google Workspace Marketplace 安装，在表格中完成授权，并在公式设置中保存 GenderAPI API key。
从 Google Marketplace 安装设置
四步启用 GENDER 公式
- 01
打开 GenderAPI 侧边栏
在 Google Sheets 中打开“扩展程序”，选择 GenderAPI，然后进入性别识别功能。
- 02
打开公式设置
通过侧边栏菜单打开 GENDER 公式说明和 API key 设置。
- 03
保存 API key
选择或粘贴 GenderAPI API key，并保存到当前表格的公式工作流中。
- 04
输入公式
姓名可使用 =GENDER(A2)；邮箱、用户名、国家信息和扩展字段可通过可选参数设置。
公式参考
选择输入方式和输出详细程度
=GENDER(A2)使用默认设置分析 A2 中的姓名。
=GENDER(A5, "email", "", true)分析邮箱，并返回性别、probability、国家和标准化姓名。
| 参数 | 用途 |
|---|---|
input | 姓名、邮箱或用户名 |
method | name（默认）、email 或 username |
country_filter | 可选两位国家代码，例如 US、DE 或 TR |
additional_info | 设为 true 时，同时返回 probability、国家和标准化姓名 |
输出示例
自动填充扩展结果列
启用 additional information 后，公式会在相邻列中填入扩展结果字段。
按场景选择
公式适合灵活、轻量的分析
常见问题
Google Sheets GENDER 公式常见问题
为什么结果单元格中包含 JSON 注释？
注释会缓存公式和结果，使 Google Sheets 自动重新计算时可以复用结果，避免重复消耗 API credit。
必须安装 GenderAPI Add-On 吗？
是。自定义 GENDER 公式需要安装并授权 GenderAPI Google Sheets Add-On。
可以分析邮箱或用户名吗？
可以。将 method 参数设置为 email 或 username，即可处理相应输入。
卸载 Add-On 后会怎样？
公式结果是动态的，卸载后可能无法继续显示或计算。需要静态结果时，请复制并粘贴为值。
公式受到哪些额度限制？
GenderAPI 套餐额度和 Google Apps Script 配额都会生效。Google 当前公布的 URL Fetch 日配额为个人账户 20,000 次、Workspace 账户 100,000 次，并说明配额可能调整。
公式结果会永久保存吗？
不会。公式输出是动态的。需要持久结果时请粘贴为值，或使用 Add-On 的批量处理流程。
在哪里获取 API key？
注册或登录 GenderAPI，在控制面板中复制 API key。新账户每天可获得 200 个免费 API credits。