T-Plan から Google Cloud Vision（オンラインのOCR／画像認識）を呼び出すための認証と疎通をここで行います。

各フィールドの意味

• gcloudバイナリのパス

  既定は Service Account 認証を想定。gcloud（Google CLI）が PATH か、ここでフルパス指定されている必要があります。例：

  C:\\Program Files\\Google\\Cloud SDK\\google-cloud-sdk\\bin\\gcloud.cmd

• APIキーで認証／APIキー

  Service Account の代わりに API Key を使う場合にチェックし、キーを貼り付けます。プロキシ経由でも動作させやすい簡易方式。

• 接続テスト

  その場で認証・到達性を検証します（成功するまでスクリプト実行は避けるのが吉）。

• デバッグメッセージをコンソールに表示する

  呼び出し時の詳細ログを標準出力へ。設定・疎通の調整中だけONに。

使い始める手順（Service Account 推奨）

1. GCPでプロジェクト作成 → Vision API を有効化。

2. サービスアカウントを作成し、**鍵（JSON）**を発行。

3. どちらかの方法で認証を通します：

   • PCに Google Cloud SDK を入れて gcloud auth application-default login（または JSON を指定して ADC を設定）
   • もしくは環境変数 GOOGLE_APPLICATION_CREDENTIALS に JSON のパスを設定

4. 本画面の gcloudバイナリのパス を確認／指定 → 接続テスト。

   ※ API Key 方式を使うなら「APIキーで認証」をONにしてキーを貼り付け → 接続テスト。

運用のコツ

• プロキシ環境：［外観＆アクセシビリティ → プロキシサーバー］の「Google Vision API」にチェックを入れておく。
• コスト／レート制限：クラウド課金と1分あたりの呼び出し上限に注意。回帰ではキャッシュや差分実行を。
• 機微データ：クラウドに画像が送信されます。社内規程上NGなら、ローカルの Tesseract／ABBYY（OCR）や画像マッチで代替。
• オフライン端末：この機能は使えません。前述のローカル手段を使用。

よくあるハマりどころ

• 接続テスト失敗
  • gcloud パス未設定／ADC 未構成（Service Account）
  • API Key の権限不足、Vision API 未有効化
  • 社内プロキシでブロック → プロキシ設定とCA証明書を見直し