サイドバーからExcelの行にデータを追加する
GenderAPI Excelアドインでは、名前、メールアドレス、ユーザー名のいずれかの列を選び、結果をワークシート上のマッピングした列に書き込めます。行の範囲を管理しながら処理する場合はサイドバーを、セルに連動した計算にはGENDER.FROM_*関数を使用してください。
Excelのネイティブクライアントは従来のAPIのフィールドを使用します。REST V2のdataオブジェクトやmetaオブジェクトは返さないため、ブック内の既存のマッピングはアドインの実際の出力に合わせてください。
まず小さな行範囲で設定する
- MicrosoftのカタログにあるGenderAPIのページからアドインをインストールし、ブックでサイドバーを開きます。ドキュメントへのアクセス許可と、組織による制限の有無を確認してください。
- アドインにGenderAPIのキーを保存し、選択したアカウントにクレジットがあることを確認します。
- name、email、usernameのいずれかのメソッドと、対応する元の列を選択します。ヘッダー行を除いた小さな行範囲を設定します。
- 性別の出力先の列をマッピングし、必要に応じてprobability、国、検出された名前の列もマッピングします。各結果は元のデータと分けて保持してください。
- 国のコンテキストは、処理するデータに対して信頼できる場合にのみ指定します。選択した設定を確認してから、サンプルを実行します。
- 範囲を広げる前に、identifiedの行、未解決の行、失敗した行を確認します。ブックの元データのコピーを保管してください。
入力、コンテキスト、結果の列を選ぶ
| 設定 | 種類 | 説明 |
|---|---|---|
| APIキー | アカウントの認証情報 | アドインのキー入力フィールドから保存します。ブックの通常のセルには入力しないでください。 |
| メソッドと入力元 | 選択肢と列 | name、email、usernameのいずれかと、それに対応する元の列。 |
| 行範囲 | 行番号 | ヘッダー行を除いた小さな範囲から始めます。 |
| 国フィルター | 任意の国または列 | 既知の国のコンテキストを指定します。このフィールドは本人の所在地が確認済みであることを示すものではありません。 |
| 結果の列 | 列の参照 | 性別の出力先となる列と、probability、国、検出された名前の任意の出力先の列。 |
結果列を読み取る
元の値は結果の隣に保持します。名前に基づく関連付けは本人が申告した性別を確定するものではなく、返された国も居住地や国籍を証明するものではありません。
- データセット全体を処理する前に、通常の結果、あいまいな入力、失敗した実行をそれぞれ確認します。
- 空のセル、テキストのnull、数式エラーは異なる値です。不明な結果の表し方は意図的に統一し、エラーを隠さないようにします。
- 不明または不確かなケースには中立的な表現を使い、本人が提供した情報は推定と分けて保持します。
| 結果 | 種類 | 使い方 |
|---|---|---|
| Gender | テキストまたは未解決の値 | maleまたはfemaleは、成功した結果の場合にのみ保存します。未解決の値はunknownとして保存し、エラーメッセージは別に確認します。 |
| Probability | 数値（利用可能な場合） | 従来から使われている信頼度の指標です。V2のconfidenceフィールドとは一致せず、お使いのデータで測定された精度でもありません。 |
| Country | テキスト（利用可能な場合） | 検索で返されたコンテキストです。顧客の確認済みの国とは分けて保持します。 |
| Found / normalized name | テキスト（利用可能な場合） | 処理で使用された名前、または抽出された名前です。メールアドレスやユーザー名があいまいな場合は、この値を確認します。 |
クレジット、制限、再実行を計画する
登録済みの無料GenderAPIアカウントには、1日あたり200クレジットが含まれます。これはアカウントの残高であり、すべてのワークフローで200件のidentifiedの結果が得られることを約束するものではありません。開始する前に、選択したキーの残高とツールの現在の処理オプションを確認してください。
アドオンとファイル処理は、それぞれ独自の処理経路で動作します。V2 REST APIのバッチ上限、AIオプション、リクエストごとの課金フィールドは、これらのツールには自動的には適用されません。再実行や再計算によって新しいリクエストが送信され、クレジットが消費されることがあるため、無料だと考えないでください。
小さなサンプルから始め、得られた結果を保存し、再実行する前に失敗した行を確認します。エクスポートや出力先システムの更新を修正するだけであれば、既存の結果を再利用してください。
共有するデータを決める
スプレッドシートとの連携は、検索に必要な値を送信し、選択したドキュメントに対する権限を要求します。個人データを処理する前に、スプレッドシートにアクセスできるユーザー、接続されているアカウント、使用される出力先の列を確認してください。
APIキーは、通常のセル、スクリーンショット、共有する例ではなく、アドオンの設定に保管します。公開されているプライバシーポリシーには、入力データがどのように処理、保存、記録されるかが記載されています。スプレッドシートとの連携を使うことは、データがお使いのデバイス上だけにとどまることを意味しません。
V2 APIを直接使うべき場合
アプリケーションで明示的なAIオプションと、項目ごとのV2のstatus、source、confidence_kind、usageの情報が必要な場合は、別のHTTP連携を設定してください。V2のリクエストとレスポンスの仕様に従う必要があります。アドオン独自の数式や既存のアドオンにV2のフィールド名を追加しても、その動作は変わりません。
よくある質問
Excelでメールアドレスやユーザー名を分析できますか？
はい。サイドバーで対応するメソッドを選び、正しい入力列をマッピングしてください。結果を使用する前に、返された名前と未解決のケースを確認してください。
サイドバーと数式のどちらを使うべきですか？
選択した範囲を処理してマッピングした列に値を書き込む場合は、サイドバーを使用します。セルに連動した計算が必要な場合はGENDER.FROM_*数式を選び、再計算による影響に注意してください。
ファイル名がfunctions_v2.jsなのは、アドインがREST V2を使っているという意味ですか？
いいえ。これはExcelクライアントのファイル名にすぎません。このガイドのために確認した公開数式ファイルは、従来のAPIのエンドポイントを呼び出し、そのレスポンスのフィールドを読み取ります。
推定結果は顧客の確認済みの属性ですか？
いいえ。顧客本人が提供した情報とは分けて保持し、不明な結果や判断が不確かなケースでは中立的な代替表現を使用してください。
出典とドキュメント
このガイドの最終確認日はです。インストール方法は各プラットフォームのドキュメントで確認してください。V2連携を別途構築する場合は、以下のAPIドキュメントを使用してください。