GAS × Vertex AI (Gemini) で画像解析スクリプトを作成

このツールでできること

Google Apps Script (GAS) と Vertex AI の Gemini モデルを連携させることで、Google Drive 上に保存された画像を自動で解析するスクリプトを作成できます。このスクリプトは、AppSheet と組み合わせることで、「スマートフォンで写真を撮る → AI が自動で画像を解析 → 解析結果をスプレッドシートに保存する」という一連のワークフローを実現します。

具体的には、GAS から Vertex AI (Gemini) を呼び出して画像解析を行うスクリプトを作成し、サービスアカウント認証による安全な API 接続を実装します。さらに、AppSheet から呼び出し可能な公開 API として機能させることが可能です。

料金プラン

料金については元記事に記載がありません。公式サイトで最新情報を確認してください。

使い方の概要

全体の構成は、AppSheet から GAS (api.gs) を呼び出し、GAS が Google Drive から画像を取得して Base64 に変換後、サービスアカウント認証を用いて Vertex AI API (Gemini) にリクエストを送信します。Gemini は画像を解析し、テキスト形式で結果を返します。

前提条件

• Google Cloud プロジェクトを所有していること
• Google Apps Script の基本操作ができること

1. Google Cloud の準備

• Vertex AI API の有効化: Google Cloud Console で「Vertex AI API」を検索し、有効化します。
• サービスアカウントの作成: IAM と管理からサービスアカウントを作成し、「Vertex AI ユーザー」ロールを付与します。
• JSON キーのダウンロード: 作成したサービスアカウントの「キー」タブから JSON キーをダウンロードします。

2. GAS プロジェクトのセットアップ

• プロジェクトの作成: Google Apps Script で新規プロジェクトを作成します。
• OAuth2 ライブラリの追加: サービスアカウント認証のために、指定されたスクリプト ID を持つ OAuth2 ライブラリを追加します。
• スクリプトプロパティの設定: プロジェクトの設定で、Google Cloud プロジェクト ID、サービスアカウントの client_email、private_key、および Vertex AI のリージョンをスクリプトプロパティに登録します。JSON キーの private_key は、改行文字を含んだままコピー＆ペーストします。

3. コードの実装

以下のファイル構成でコードを実装します。

• src/config.gs: スクリプトプロパティからの値取得とデフォルト値の管理。デフォルトモデルとして gemini-2.5-flash を使用。
• src/auth.gs: OAuth2 ライブラリを使用して、サービスアカウントで Vertex AI の認証トークンを取得。
• src/drive.gs: Google Drive 上のファイルパスを解決し、画像データを Base64 に変換。Base64 インライン方式を採用。
• src/vertex_ai.gs: Vertex AI API のエンドポイント URL 構築、リクエストボディの構築、API 呼び出し、レスポンスからのテキスト抽出を行うコアモジュール。
• src/api.gs: AppSheet から直接呼び出せる公開 API (エントリポイント)。
• src/test.gs: テスト用のコード。

drive.gs の詳細

AppSheet から渡されるファイルパスを元に Google Drive 上のファイルを特定し、その画像データを Base64 エンコードされた形式に変換します。URL 指定方式と比較して、Base64 インライン方式は画像を非公開のまま送信できるため、業務データに適しています。

vertex_ai.gs の詳細

このモジュールでは、まずプロジェクト ID、リージョン、モデル名から Vertex AI API のエンドポイント URL を構築します。次に、画像データ (Base64) とユーザープロンプトを Gemini API が要求する contents 形式に変換します。最後に、取得したアクセストークンを使用して Bearer 認証を行い、API を呼び出します。レスポンスから解析結果のテキストを抽出して返します。

api.gs の詳細

このファイルは、AppSheet からの呼び出しを想定した公開 API のエントリポイントとなります。単一画像の解析などの機能を提供します。

どんな人に向いているか

• GAS を使って AI 機能を手軽に実装したい方
• AppSheet と GAS を連携させて、業務ワークフローを自動化したい方
• Vertex AI のサービスアカウント認証を GAS で実装する方法を知りたい方
• Google Drive 上の画像を AI で解析したい方

競合ツールとの位置づけ

本スクリプトは、GAS と Vertex AI (Gemini) を直接連携させることで、柔軟なカスタマイズ性とセキュアなデータ連携を実現します。特に、機密性の高い業務データを扱う場合に、Base64 インライン方式による画像送信が可能な点は、他のサービスと比較して優位性があります。AppSheet との連携により、ノーコード/ローコード開発の延長線上で高度な AI 画像解析機能を組み込める点が特徴です。

まとめ

本記事では、GAS と Vertex AI (Gemini) を用いて画像解析スクリプトを作成する方法を解説しました。サービスアカウント認証による安全な API 接続、Google Drive からの画像取得と Base64 変換、そして Vertex AI API の呼び出しまでを実装することで、AppSheet と連携した画像解析ワークフローを構築できます。これにより、業務効率化や新たな価値創出の可能性が広がります。

出典: https://zenn.dev/west_river/articles/gas-vertex-ai-image-analyzer