GenderAPIでGoogle Sheetsの新しい行のワークフローを設定する

新しいレコードを結果列にマッピングする

GenderAPIアドオンにはWorkflows画面があり、シートの新しいレコードを性別の列やその他の任意の結果列にマッピングできます。正しいシートに対して設定し、この自動化に頼る前に、実際に追加されたレコードを確認してください。

アドオン独自のワークフローは、V2を直接呼び出すHTTPアクションとは別のものです。有効化の方法、実行のタイミング、出力フィールドは、インストールされているアドオンとGoogleアカウントによって異なります。新しい行のすべての送信元について、即時の更新が保証されるわけではありません。

ワークフローを作成してテストする

GenderAPIアドオンをインストールして開き、サイドバーのメニューからWorkflowsを開きます。
シートとAPIキーを選択します。ソース列に合わせて、name、email、usernameのいずれかの分析方式を選択します。
ソース列を、別に用意した性別の列にマッピングします。probability、国、検出された名前の出力先は、必要な場合にのみ追加します。
ワークフローを作成する前に、すべてのマッピングを確認します。画面では列の競合が防止され、ワークフローがすでに存在することや上限に達したことが表示される場合があります。
本番データと同じ方法で、代表的なレコードを追加します。値が正しい行に表示され、既存のフィールドが上書きされていないことを確認します。
未解決の値と実行エラーをテストし、漏れた行や失敗した行を見つけて確認する方法を決めます。

Google Sheetsアドオンをインストール

アドオンのワークフローのフィールドを設定する

設定	種類	使い方
APIキー	認証情報	正しいアカウントを選択し、利用可能なクレジットがあることを確認します。
シート	シートの選択	このワークフローがレコードを処理するシートです。
方式	選択肢	name、email、usernameのいずれかです。選択した方式によって、入力の解釈方法が決まります。
ソース列	列の参照	各レコードで分析する値です。
性別の列	列の参照	入力やほかの結果とは別の出力先です。
probability、国、検出された名前	任意の出力先	アドオンの追加の結果を入れる個別の列です。

行が実際にどのようにシートに追加されるかを確認する

値の手入力、フォームの送信、CRMからのレコードのインポートは、それぞれ異なるイベントです。Googleのドキュメントによると、スクリプトの実行やAPIリクエストでは、通常、インストール可能なトリガーは起動しません。アドオンの公式掲載ページには正確な実装方法が記載されていないため、実際に使用するデータソースでテストしてください。

新しく作成したワークフローが、既存の行をさかのぼって処理するとは考えないでください。それらのレコードについては、サイドバーで範囲を選択して一括処理を行い、処理済みの行を記録しておきます。

想定した更新が反映されない場合は、同じレコードを再送信する前に、ワークフロー、権限、キーの残高、列のマッピング、プラットフォームのエラーを確認してください。

結果列を読み取る

元の値は結果の隣に保持します。名前に基づく関連付けは本人が申告した性別を確定するものではなく、返された国も居住地や国籍を証明するものではありません。

データセット全体を処理する前に、通常の結果、あいまいな入力、失敗した実行をそれぞれ確認します。
空のセル、テキストのnull、数式エラーは異なる値です。不明な結果の表し方は意図的に統一し、エラーを隠さないようにします。
不明または不確かなケースには中立的な表現を使い、本人が提供した情報は推定と分けて保持します。

結果	種類	使い方
Gender	テキストまたは未解決の値	maleまたはfemaleは、成功した結果の場合にのみ保存します。未解決の値はunknownとして保存し、エラーメッセージは別に確認します。
Probability	数値（利用可能な場合）	従来から使われている信頼度の指標です。V2のconfidenceフィールドとは一致せず、お使いのデータで測定された精度でもありません。
Country	テキスト（利用可能な場合）	検索で返されたコンテキストです。顧客の確認済みの国とは分けて保持します。
Found / normalized name	テキスト（利用可能な場合）	処理で使用された名前、または抽出された名前です。メールアドレスやユーザー名があいまいな場合は、この値を確認します。

信頼度の値とその限界

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

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

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

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

アカウントのプランとクレジット

V2 APIを直接使うべき場合

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

よくある質問

CRMからのインポートは、毎回アドオンのワークフローを起動しますか？

そうとは限りません。実際に使用しているCRMや自動化からのレコードでテストしてください。Googleは、手動での変更、フォームの送信、APIによる更新を区別しています。インストールされているアドオンの実際の動作を確認してください。

シートにすでにある行を処理できますか？

サイドバーで範囲を選択して一括処理を行ってください。新しい行のワークフローを作成しても、既存のレコードは処理されません。

ワークフローはいくつ作成できますか？

画面に上限が表示されることがありますが、このガイドでは確認されていない数値は示しません。インストールされているバージョンを確認し、必要に応じて不要になったワークフローを削除してください。

V2のsourceとusageのフィールドはどうすれば取得できますか？

MakeやZapierのドキュメント化されたガイドなどに従って、別のV2 HTTP連携を作成してください。アドオンの列にV2のレスポンス構造が含まれるとは考えないでください。

出典とドキュメント

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