# Microsoft Excel向けGenderAPI数式

> ExcelでGENDER.FROM_NAME、GENDER.FROM_EMAIL、GENDER.FROM_USERNAMEを使用します。引数、既定値、拡張出力、よくあるエラーを確認します。

Canonical HTML: https://www.genderapi.io/ja/blog/gender-formula-for-microsoft-excel

Last reviewed: 2026-09-29

## 入力データに合った関数を選ぶ

GenderAPI Excelアドインをインストールし、サイドバーにAPIキーを保存したうえで、名前にはGENDER.FROM_NAME、メールアドレスにはGENDER.FROM_EMAIL、ユーザー名にはGENDER.FROM_USERNAMEを使用します。各関数は最初に入力を受け取り、次に追加情報を有効にする任意のフラグ、最後に任意の国のコンテキストを受け取ります。

これらのExcelネイティブの数式は従来のAPIに基づいています。Google SheetsのGENDER数式は引数の構成が異なり、直接呼び出すREST V2 APIには独自のJSONの仕様があります。

- [Excelアドインをインストール](https://appsource.microsoft.com/en-us/product/office/WA200008555)
- [Excelでサイドバーを設定する](https://www.genderapi.io/ja/blog/genderize-excel-names-using-genderapi-excel-add-in)

## 決まった順序の3つの引数

| 引数 | 種類 | 既定値 | 説明 |
| --- | --- | --- | --- |
| `name / email / username` | テキストまたはセル参照 | 必須 | 選択した関数への入力（例：A2）。 |
| `enable_additional_info` | ブール値 | FALSE | TRUEまたは1を指定すると4列を返します。省略するかFALSE/0を指定すると性別のみを返します。 |
| `country` | テキスト | 国フィルターなし | 任意の2文字の国コード（例：IT、US、DE、TR）。この3番目の引数を指定する場合は、2番目の引数も指定してください。 |

**Excelの数式の例**

各行は別々の例です。A2には対応する名前、メールアドレス、ユーザー名を入力します。Excelの地域設定によっては、引数の区切りにカンマではなくセミコロンを使う場合があります。

```text
=GENDER.FROM_NAME(A2)
=GENDER.FROM_NAME(A2, TRUE, "IT")
=GENDER.FROM_EMAIL(A2, TRUE)
=GENDER.FROM_USERNAME(A2, FALSE)
```

## Excelの拡張出力は4列を使用する

追加情報を有効にしない場合、数式は性別のみを返します。有効にすると、Excelのドキュメントに記載された出力は1行に性別、probability、国、検出された名前の順で入ります。右側の3つのセルは空けておいてください。

Google Sheetsの数式では国がprobabilityより前に来るため、Excelで有効な順序を確認せずにその列ヘッダーを流用しないでください。

| 位置 | Excelの出力 | 意味 |
| --- | --- | --- |
| 1 | Gender | 判定された性別、または未解決の値。実行時のエラーは別に扱ってください。 |
| 2 | Probability | 従来のAPIの信頼度のシグナルです。V2のconfidence_kindでも、測定されたモデルの精度でもありません。 |
| 3 | Country | 検索で返された国のコンテキストであり、本人の確認済みの属性ではありません。 |
| 4 | Matched name | 使用または抽出された名前を確認してください。特にメールアドレスとユーザー名の場合に重要です。 |

## 数式を下の行にコピーする前に設定のエラーを解消する

再計算によって新しい検索が実行されることがあります。固定したスナップショットが必要な場合は、完了した結果を値として貼り付け、元のデータと確認日をその横に保管してください。

| 症状 | 確認すること |
| --- | --- |
| 関数が使用できない | アドインがインストールされ、このブックとこのExcel環境で使用できることを確認してください。 |
| APIキーが設定されていない | GenderAPIのサイドバーを開いてキーを保存してください。セルに入力したキーは、アドインに保存された認証情報の代わりにはなりません。 |
| 入力が空 | 数式が参照しているセルを確認し、実際の入力の種類に合った関数を選んでください。 |
| 拡張出力が表示されない | 必要な隣接する出力先のセルを空けてください。ただし、必要なデータは上書きしないでください。 |
| エラーメッセージまたはunknown error | 接続、アカウントの状態、返されたメッセージを確認してください。実行時のエラーは未解決の推定結果とは異なります。 |

## クレジット、制限、再実行を計画する

登録済みの無料GenderAPIアカウントには、1日あたり200クレジットが含まれます。これはアカウントの残高であり、すべてのワークフローで200件のidentifiedの結果が得られることを約束するものではありません。開始する前に、選択したキーの残高とツールの現在の処理オプションを確認してください。

アドオンとファイル処理は、それぞれ独自の処理経路で動作します。V2 REST APIのバッチ上限、AIオプション、リクエストごとの課金フィールドは、これらのツールには自動的には適用されません。再実行や再計算によって新しいリクエストが送信され、クレジットが消費されることがあるため、無料だと考えないでください。

小さなサンプルから始め、得られた結果を保存し、再実行する前に失敗した行を確認します。エクスポートや出力先システムの更新を修正するだけであれば、既存の結果を再利用してください。

- [アカウントのプランとクレジット](https://www.genderapi.io/ja/price)

## V2 APIを直接使うべき場合

アプリケーションで明示的なAIオプションと、項目ごとのV2のstatus、source、confidence_kind、usageの情報が必要な場合は、別のHTTP連携を設定してください。V2のリクエストとレスポンスの仕様に従う必要があります。アドオン独自の数式や既存のアドオンにV2のフィールド名を追加しても、その動作は変わりません。

- [リクエストパラメーター](https://www.genderapi.io/ja/docs/v2/request-parameters)
- [V2のレスポンスフィールド](https://www.genderapi.io/ja/docs/v2/responses)
- [PythonでのV2連携](https://www.genderapi.io/ja/integrations/python)
- [Node.jsでのV2連携](https://www.genderapi.io/ja/integrations/javascript)

## Microsoft Excelで数式「=GENDER(A2)」を使用できますか？

Excelアドインのドキュメントに記載されている関数はGENDER.FROM_NAME、GENDER.FROM_EMAIL、GENDER.FROM_USERNAMEです。単純なGENDER数式はGoogle Sheetsアドオンのものです。

## 追加出力なしで国を指定するにはどうすればよいですか？

2番目の引数を無効のままにします（例：=GENDER.FROM_NAME(A2, FALSE, "IT")）。国は2番目ではなく3番目の引数です。

## 追加情報の設定の既定値は何ですか？

引数を省略した場合は無効です。TRUEまたは1を指定すると、性別、probability、国、検出された名前の4列の出力が有効になります。

## これらの関数はV2の課金情報を返しますか？

いいえ。ネイティブの数式は従来のAPIの結果フィールドを返します。リクエストのメタデータ、source、confidence_kind、リクエストごとの消費量が必要な場合は、別のV2連携を使用してください。

## 出典とドキュメント

- [Microsoft AppSourceのアドイン公式掲載ページ](https://appsource.microsoft.com/en-us/product/office/WA200008555)
- [Excelの数式ドキュメント：gender_from_name](https://excel.genderapi.io/help/gender_from_name.html)
- [Excelの数式ドキュメント：gender_from_email](https://excel.genderapi.io/help/gender_from_email.html)
- [Excelの数式ドキュメント：gender_from_username](https://excel.genderapi.io/help/gender_from_username.html)
- [公開されているExcel関数の定義](https://excel.genderapi.io/functions_v2.json)
- [GenderAPIのプランとクレジット](https://www.genderapi.io/ja/price)
- [GenderAPIのプライバシーポリシー](https://www.genderapi.io/ja/privacy-policy)
- [V2リクエストの仕様](https://www.genderapi.io/ja/docs/v2/request-parameters)