GenderAPIのAirtable拡張機能で名前とメールアドレスをマッピングする

Airtable拡張機能でフィールドをマッピングする

GenderAPI拡張機能は、選択したフィールドから名前またはメールアドレスを読み取り、推定された性別シグナルを別の出力先フィールドに書き込みます。国、probability、見つかった名前もマッピングでき、性別の出力先にすでに値が入っているレコードはスキップできます。

2026年9月27日に確認した拡張機能のソースコードは、名前とメールアドレス用の従来のV1エンドポイントと、そのトップレベルのレスポンスフィールドを使用しています。このガイドでは、そのネイティブなワークフローを説明します。インストール済みの拡張機能はこのガイドとは別に変更される可能性があるため、以下のマッピングを適用する前に、利用可能な設定を確認してください。

ベースを接続し、フィールドを準備する

対象のAirtableベースを開き、「Extensions」からGenderAPI.ioを追加して実行します。拡張機能に表示される接続手順を完了してください。
この操作で使用するクレジットキーを選択します。残高を確認し、このキーが意図したGenderAPIアカウントに関連付けられていることを確認してください。
テーブルと、名前またはメールアドレスを含むソースフィールドを選択します。元の入力はそのフィールドに残し、結果用に別のフィールドを作成してください。
必須の性別の出力先と、任意の補助的な出力先を選択します。書式設定されたパーセンテージにはpercentフィールドを、元のprobabilityのスケールを保つにはnumberフィールドを使用してください。
値が入力済みの性別の出力先を保持するかどうかを決めます。スキップを有効にすると、以前の実行で残った未解決のテキスト値も保持されます。そのため、意図的に再処理したい結果だけを消去してください。

拡張機能の入力と出力をマッピングする

ソースフィールドには名前とメールアドレスが混在していてもかまいません。確認した実装では、@を含む値はメールアドレスの処理経路に送られます。この振り分けルールは、メールボックスが実在するかどうかを検証するものではありません。

拡張機能の設定	必須	値と動作
クレジットキー	はい	選択したGenderAPIアカウントのキーが、処理されるクエリのクレジットを提供します。
テーブルとソースフィールド	はい	ソースセルが名前またはメールアドレスを提供します。空のソースセルはスキップされます。
性別の出力先	はい	ネイティブのgenderフィールドを受け取ります。未解決の値はmaleやfemaleと区別して扱ってください。
国の出力先	いいえ	返されたcountryの値を受け取ります。これは出力列であり、リクエストの国フィルターではありません。
probabilityの出力先	いいえ	従来のAPIのprobability値を受け取ります。percentフィールドには100で割った値が入り、numberフィールドは元のスケールを保ちます。
Found Nameの出力先	いいえ	利用可能な場合、ネイティブAPIが返した名前を受け取ります。この推定された候補は、ソースの値と区別して保持してください。
入力済みの性別フィールドをスキップ	いいえ	出力先にすでに値があるレコードを、未解決のテキストも含めて保持します。実行のたびに、この設定の選択状態を確認してください。

テーブル全体を処理する前に小規模な実行で確認する

名前、メールアドレス、空のセル、あいまいな入力を含む小さなテスト用テーブルから始めます。メインのテーブルを処理する前に、選択した出力先フィールドと、Airtableがprobabilityのスケールをどのように表示するかを確認してください。

確認した拡張機能のコードでは、未解決時の既定値としてテキストのnullとprobability 0が表示されることがあります。失敗した一部のネイティブレスポンスでもこれらの既定値が残ることがあり、接続エラーの場合はレコードが変更されないままになることがあります。実行状態と影響を受けた行を確認してください。テキストのnullだけでは、検索が正常に完了した証拠にはなりません。

実行後に既存の値を確認します。自分で性別を割り当てるのではなく、未解決の結果は確認用に保持してください。名前に基づく推定は、その人の性自認を確認するものではなく、返された国は居住地の証明ではありません。

表示される内容	対応方法
想定した列に期待どおりの結果がある	元の入力と補助的なフィールドを保持し、マッピングを後から確認できるようにします。
nullのテキストまたはprobability 0	未解決のままにし、再度検索すべきかを判断する前に処理ステータスを確認します。
以前に入力済みの出力先が変更されていない	スキップ設定を確認します。意図的に値が保持されている可能性があります。
キーやクレジットに関するメッセージ、またはエラー後に結果が変わらない	アカウントまたは接続の問題を解決し、再開する前に影響を受けたレコードを特定します。

使用するクレジットと再実行を管理する

ネイティブの拡張機能は、選択したGenderAPIキーを使用して値を1件ずつ検索します。スキップされない同じレコードを再度実行すると、新しいクエリが送信され、再びクレジットが消費される可能性があります。Airtable自体のプランや拡張機能の利用可否は、このアカウント残高とは別のものです。

ネイティブの出力は、V2のdata/metaレスポンス、明示的なAIモードの選択、項目ごとのusageオブジェクト、V2のバッチ仕様のいずれも公開していません。このワークフローには従来のV1リファレンスを使用し、これらの設定が必要な場合は、以下で説明する別のAPIの選択肢を使用してください。

拡張機能は、マッピングされた値を処理のために送信し、結果をベースに書き戻します。対象のレコードについて、公開されているデータ取り扱いポリシーと拡張機能の権限を確認してください。関係のないフィールドはソースのマッピングに含めないでください。

構造化されたレスポンスが必要な場合はV2を使用する

カスタム連携では、GenderAPI V2は名前、メールアドレス、ユーザー名を受け付け、結果、信頼度、ソース、使用量を示す明示的なフィールドを返します。この接続は別途設定してください。V2ガイドを読んでも、インストール済みのアプリやその出力列は変更されません。

PythonとNode.jsの例では、単一リクエスト、バッチ、不明な結果、運用上のエラーを扱います。認証ガイドから始め、課金対象のリクエストを送信する前にAIモードを選択してください。

よくある質問

Airtable拡張機能はGenderAPI V2を使用していますか？

2026年9月27日に確認した拡張機能のソースコードは、名前とメールアドレス用の従来のV1エンドポイントを使用しています。別途構築するカスタムのV2接続はリクエストとレスポンスのフィールドが異なり、インストール済みの拡張機能をアップグレードするものではありません。

1つのソースフィールドに名前とメールアドレスの両方を含めることはできますか？

はい。確認した拡張機能は、@を含む空でない値をメールアドレスの検索に、それ以外の値を名前の検索に振り分けます。これは入力の振り分けであり、メールボックスの検証ではありません。

percentフィールドではprobabilityの表示が異なるのはなぜですか？

Airtableがパーセンテージとして書式設定できるよう、拡張機能はAirtableのpercentフィールドに対して従来のAPIのprobability値を100で割ります。numberフィールドの出力先は元のスケールを保ちます。これはV2のconfidenceフィールドではありません。

スキップの設定で未解決の結果は保持されますか？

はい、出力先にすでに値が入っている場合は保持されます。以前の実行で残ったnullのテキストも含まれます。それらのレコードを確認し、意図的に再処理したい値だけを消去してください。

出典とドキュメント

このガイドの最終確認日は2026年9月29日です。インストール方法は各プラットフォームのドキュメントで確認してください。V2連携を別途構築する場合は、以下のAPIドキュメントを使用してください。