◉GEMINI LABEN
●ARGON — gemini-4-argon が 10/13 に GA。複雑なコーディング・エージェント・数学・科学向けです●DEEP RES — deep-research-pro-preview-12-2025 は 10/23 に停止、残り6日。移行先は deep-research-preview-04-2026●NANO — gemini-nano-banana-2.1 が GA(10/06)。gemini-3.1-flash-image は非推奨で停止日は未発表です●MCP — ツール結果が 8.5万トークンに膨らんだ事例を、ADK で 310 トークンに包んで抑えた報告が出ています●FLASH — gemini-3.7-flash と 3.5-flash は新しい Flash モデルに自動で回されます(10/08)●NEW — クラッシュ報告を毎回ゼロから読ませない — 既知バグ早見表を先に grep し…●ARGON — gemini-4-argon が 10/13 に GA。複雑なコーディング・エージェント・数学・科学向けです●DEEP RES — deep-research-pro-preview-12-2025 は 10/23 に停止、残り6日。移行先は deep-research-preview-04-2026●NANO — gemini-nano-banana-2.1 が GA(10/06)。gemini-3.1-flash-image は非推奨で停止日は未発表です●MCP — ツール結果が 8.5万トークンに膨らんだ事例を、ADK で 310 トークンに包んで抑えた報告が出ています●FLASH — gemini-3.7-flash と 3.5-flash は新しい Flash モデルに自動で回されます(10/08)●NEW — クラッシュ報告を毎回ゼロから読ませない — 既知バグ早見表を先に grep し…
記事一覧/Workspace 連携
◧ Workspace 連携/2026-04-09上級

Google Workspace × Gemini API 業務自動化の運用ノート — Apps Script 実装パターン12選と本番設計

Gemini API と Google Apps Script で Gmail・Docs・Sheets・Calendar を横断する業務自動化を組む実装パターン12選。4サイト運用とアプリ問い合わせ対応で踏んだ落とし穴を、429の握りつぶし・JSONフェンス・6分制限・モデル振り分けの実測付きで整理しました。

Apps Script13Gemini API248Google Workspace22自動化28業務効率化5GmailGoogle Sheets5Google Docs3

✦ プレミアム記事

Google Apps Script(GAS)は、Google Workspace の各サービスをプログラムから操作できる強力なプラットフォームです。そこに Gemini API の自然言語処理能力を組み合わせることで、これまで人手に頼っていた定型業務の多くをインテリジェントに自動化できます。

Google Workspace × Gemini API の統合アーキテクチャ

まず全体像を把握しておきましょう。GAS から Gemini API を呼び出す際の基本フローは以下のとおりです。

GAS スクリプト
  ↓ UrlFetchApp.fetch()
Gemini API (generateContent エンドポイント)
  ↓ レスポンス JSON
GAS スクリプト
  ↓ 各 Workspace サービス操作
Gmail / Docs / Sheets / Calendar

GAS は Google の安全なサーバー上で動作するため、APIキーをクライアントに露出させることなく安全に Gemini API を呼び出せます。また、すべての Workspace サービスへのアクセスがサーバーサイドで完結するため、OAuth の複雑な設定なしに各サービスを操作できる点も大きな利点です。

環境準備:プロジェクトのセットアップ

すべてのパターンで共通して使用するベースコードを設定します。Google AI Studio(ai.google.dev)で取得した API キーをスクリプトプロパティに保存しましょう。

// スクリプトプロパティに GEMINI_API_KEY をセット後、この関数を呼び出す
function setup() {
  const props = PropertiesService.getScriptProperties();
  // 事前に [プロジェクトの設定] → [スクリプトプロパティ] で
  // GEMINI_API_KEY: YOUR_GEMINI_API_KEY を設定しておく
  Logger.log('API Key loaded: ' + (props.getProperty('GEMINI_API_KEY') ? 'OK' : 'NG'));
}
 
// Gemini API 呼び出しの共通関数(全パターンで使用)
function callGemini(prompt, options = {}) {
  const apiKey = PropertiesService.getScriptProperties().getProperty('GEMINI_API_KEY');
  const model = options.model || 'gemini-2.5-pro';
  const url = `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent?key=${apiKey}`;
  
  const payload = {
    contents: [{ parts: [{ text: prompt }] }],
    generationConfig: {
      temperature: options.temperature || 0.7,
      maxOutputTokens: options.maxTokens || 2048,
    }
  };
  
  const response = UrlFetchApp.fetch(url, {
    method: 'post',
    contentType: 'application/json',
    payload: JSON.stringify(payload),
    muteHttpExceptions: true  // エラー時も JSON を返す
  });
  
  const json = JSON.parse(response.getContentText());
  if (json.error) throw new Error(`Gemini API Error: ${json.error.message}`);
  return json.candidates[0].content.parts[0].text;
}

⚠️ セキュリティの注意: API キーはスクリプトのソースコードに直接書かず、必ずスクリプトプロパティを使用してください。プロパティはスクリプトを共有しても他者には見えません。


✦

ここまでお読みいただきありがとうございます。

この記事の続きを読む

この先には、実装コードやベンチマーク結果など、実務でお役に立てる内容をご用意しています。このサイトは広告を掲載しておらず、サーバーや開発にかかる費用はメンバーの皆様のご支援で成り立っています。もしお役に立てていましたら、ご支援いただけますと大変ありがたいです。

この記事で得られること
✦muteHttpExceptions が 429 を握りつぶす罠と、RETRYABLE で再試行対象を切り分ける共通関数
✦Gemini が約8%で返す JSONコードフェンスを除去し、パース失敗をほぼゼロにするサニタイズ関数
✦6分制限から逆算した1バッチ行数の見積もり式と、flash/pro のタスク別振り分けでコストを約4割削減した実例
Stripe による安全な決済 · いつでもキャンセル可能
✦

この記事を購入する

この先の内容をすべてお読みいただけます。一度のご購入で、いつでも何度でもアクセスできます。このサイトは広告を掲載しておらず、皆さまのご支援がサーバー費用などの運営を支えています。

または
メンバーシップなら全記事が読み放題 →
シェア

お読みいただきありがとうございます

Gemini Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • ✦コピー&ペーストで使える実装コード付き
  • ✦毎日新しい上級ガイドを追加
  • ✦¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

関連記事

◧ Workspace 連携2026-08-26
Sheets canvas へ移せるのは入口までで、実行境界は Apps Script に残ります
Sheets canvas の登場で、内製した Apps Script のどこまでを手放せるのかを実行境界という物差しで仕分けしました。移す処理と残す処理の判定基準、棚卸しを機械化する分類スクリプトまでをまとめています。
◧ Workspace 連携2026-10-15
Gemini の回答を日付つきの PDF で残す — Docs に書き出して、Apps Script で固定する
Gemini の「Share & export」に PDF はありません。Docs に書き出し、Apps Script で日付つき PDF にして同じフォルダへ固定する手順と、getAs の命名で起きる落とし穴をまとめました。
◧ Workspace 連携2026-10-03
Sheets から呼ぶ Gemini の月額を、年末の値上げ日をまたいで Apps Script で割り出す
スプレッドシートから Gemini API を呼んでいる方へ。呼び出しごとのトークン数を台帳タブに残し、2026年12月31日で終わる導入価格と2027年1月1日からの標準価格の二段で月額を見積もる Apps Script を、動かした出力つきで書き残します。