本記事は、Google Cloud Vision API を使用した OCR（文字起こし）環境の構築、トラブルシューティング、および運用ノウハウに関する一連の記事をまとめたインデックスページです。
これから OCR 環境を構築する方、GCP の設定で詰まっている方は、以下の順序で読み進めることをおすすめします。
1. 導入・トラブルシューティング編
最初に直面した IAM 権限周りのトラブルと、その解決策です。公式ドキュメント通りに進めても動かない場合のヒントになります。
Cloud Vision API の OCR が IAM で通らない理由と、最終的に動かすまでの全記録 roles/vision.user が付与できない問題に対し、プロジェクトレベルの権限設定で回避した実録です。
2. 運用・ベストプラクティス編
なぜ GUI ではなく CLI（コマンドライン）で運用すべきなのか。頻繁に OCR を回すようになった経緯と、そのメリットを解説しています。
Cloud Vision OCRをCLIで回すのが一番ラクだった理由 GCP の GUI 設定で見えなくなる「認証の流れ」を、CLI で可視化・単純化するメリットについて。
頻繁にOCRするなら GCP × VSC × CLI が正解ルートになる理由 精度・コスト・運用の観点から、なぜこの構成が「玄人寄りの正解ルート」なのかを深掘りしています。
Cloud Vision OCRをCLIで回すために作った実務向けツール解説 実際に使用している CLI ツールの構成と実装例。PDF を投げてテキストを受け取るまでの自動化フローについて。
【コード無料】Cloud Vision OCRをCLIで安全に回す最小構成スクリプト 認証情報をハードコードせず、安全にOCRを実行するためのPythonスクリプト（コピペ用）。
3. 番外編：GCP との付き合い方
OCR に限らず、GCP を触る上での教訓です。GUI で消耗する前に読んでいただきたい失敗談です。
GCPのGUIで詰んだら、Cloud Shell＋CUIに逃げたほうが早かった話（失敗談） トラブルシュートにおける Cloud Shell の優位性と、AI との連携について。
シリーズの結論 Cloud Vision OCR は強力ですが、環境構築（特に IAM と認証）が最初の壁になります。 GUI だけで完結させようとせず、CLI (Cloud Shell / Local) を活用して、構成をシンプルに保つことが、安定的かつ低コストに運用する鍵です。
