Google Apps ScriptのGeminiが一般提供|スプレッドシートの集計コードをエディタ内で作る

公開 更新 9 分で読了
Google Apps ScriptのGeminiが一般提供|スプレッドシートの集計コードをエディタ内で作る

Google Apps ScriptのGeminiサイドパネルで、スプレッドシートの売上を月別に集計する方法を紹介します。対応プラン、設定、コード生成の頼み方、元データを残す権限の確認、空行・月またぎ・ゼロ円を含むダミー表と検算方法をまとめました。

Google Apps Scriptのエディタでは、一般提供が始まったGeminiのサイドパネルから、Googleスプレッドシートの集計コードを生成・修正できます。職場ではBusiness Standardなどの対象Workspace契約、個人では有料のGoogle AI ProまたはUltraで利用できます。ダミーの売上表で試すと、元の明細を残したまま月別の合計を別シートに出し、期待値と照合できます。

Gemini in Apps Scriptの一般提供で使える機能

コードの追加と削除を差分で確認

Googleは2026年11月16日付のApps Scriptリリースノートで、エディタ内のGeminiサイドパネルの一般提供を案内しました。コードの生成・変更・デバッグやApps Scriptについての質問ができ、生成した変更は差分を見ながら提案ごとに採用または却下できます。

アカウント Googleの一般提供告知に記載された対象
職場 Google Workspace Business Standard/Plus、Enterprise Standard/Plus、AI Expanded Access
教育機関 Google AI Pro for Education
個人 Google AI Pro、Google AI Ultra

職場や学校では、組織のApps Scriptサービスと生成AIのアクセス設定が適用されます。Googleの一般提供告知によると、即時リリースと計画的リリースの両ドメインで11月12日から段階展開が始まり、表示まで最大15日かかります。

新規契約の費用は、Workspaceの料金ページかGoogle Oneの日本向けプランページで確認できます。日本でのGemini料金プランの比較では、契約を選ぶときの確認点を扱っています。

GoogleスプレッドシートからGeminiのサイドパネルを開く

元ファイルから切り離したテスト用シートを準備

  1. テスト用のスプレッドシートを用意します。既存の運用ファイルから始める場合は、コピーを作り、元の明細や既存スクリプトを持ち込む必要がなければ空のファイルを使います。シートのタブ名を「売上明細」にし、A列を日付、B列を売上にします。
  2. 下のデータをA1から入力します。日付列を日付として扱えるようにし、売上には「円」や桁区切りを入れず、数値として入力します。表の4行目にあたるA4・B4は空欄にして、空行の後にもデータが残る状態にします。
  3. スプレッドシートの[拡張機能]→[Apps Script]を選びます。開いたエディタで右上の星形のGeminiアイコンを選び、右側に入力欄が見えれば準備完了です。導線はGoogleのサイドパネルガイドとSheets向け開発者ガイドで確認できます。
行番号 A列 日付 B列 売上
1 日付 売上
2 2026/10/31 1200
3 2026/11/01 2500
4
5 2026/10/15 800
6 2026/11/30 1500
7 2026/12/01 600
8 2026/11/10 0

月末と翌月初を並べ、途中に空行を入れています。10月15日を11月1日より後ろに置いているため、入力順のまま処理しても同じ月を正しくまとめられるか確かめられます。

ゼロ円の明細は、空欄と区別するために入れています。ゼロ円を落としても月の総額は変わらないので、集計結果には明細の件数も出します。

Geminiで月別集計のApps Scriptを作って試す

明細を月ごとにまとめて別シートに書き出す

手順1 Geminiの入力欄に、以下の指示を貼り付けて送信します。読み込む列、書き込み先、同じ名前のシートがすでにある場合の扱いまで指定しておくと、コードの差分を確認しやすくなります。

このスプレッドシートに紐づく Apps Script の関数
summarizeMonthlySales を作ってください。

「売上明細」シートのA列は日付、B列は数値の売上(円)です。
1行目は見出しで、2行目からA列とB列を読み取ってください。
両列が空欄の行は飛ばし、片方だけが空欄の行や型が違う行が
あれば、行番号を示して書き込み前に停止してください。
数値の0は有効な売上として数えてください。

スプレッドシートのタイムゾーンで日付を yyyy-MM に変換し、
年と月ごとに売上合計と明細件数を求めてください。
月の昇順に並べ、A列の月は文字列として表示してください。

全行の検証が終わったら「月別集計_テスト」シートを新規作成し、
A1:C1に「月」「売上合計」「明細件数」、2行目以降に結果を出してください。
同名シートがすでにあれば変更を加える前に停止してください。
「売上明細」やほかの既存シートへの書き込み・削除はしないでください。

ファイルレベルに @OnlyCurrentDoc を付け、現在の
スプレッドシートに対する読み取りと結果の書き込みだけを行ってください。
外部通信、ほかのファイルへのアクセス、トリガーは不要です。

手順2 エディタに出た差分を確認します。入力は「売上明細」のA・B列、出力は新規の「月別集計_テスト」だけに絞られているか確認します。既存シートのクリアや削除、UrlFetchApp、DriveApp、GmailAppなどが含まれる場合は、提案を却下して条件に沿った修正を頼みます。

手順3 意図に合う提案を採用して保存し、エディタ上部の関数選択欄で summarizeMonthlySales を選んで[実行]します。初回に権限確認が表示されたら、現在のファイルを読み書きする作業に合うか確認します。実行が終わったら、スプレッドシートに戻って「月別集計_テスト」タブを開きます。

差分で見落としやすいのは、出力タブの作成が入力検証より先になっている場合です。コードを上から追い、読み取りと集計を終えてから insertSheet を呼び出す順番になっているか確認します。

日付を年・月に変換するときは、スプレッドシートのタイムゾーンを使う条件がコードに残っているかも確認します。たとえば日付をUTCの文字列に変換して先頭7文字を切り出す処理だと、タイムゾーンによって月初の日時が前月に寄ることがあります。

ここでの用途は、Apps Scriptエディタ内でのコード作成です。定型の指示をほかの作業にも再利用したい場合はGeminiのGemsとスキルの使い方、チャット側のモデルを比較したい場合はGemini 4のモデルの使い分けで確認できます。

Apps Scriptの実行結果と必要権限を確認する

月別の件数と売上合計を照合

手順1 「月別集計_テスト」のA1:C4に、次の見出しと3か月分の結果があるか確認します。売上合計は全月で6,600円、明細は合計6件です。月ごとの内訳まで照合すると、別の月にずれて計上された明細を見つけられます。

月 売上合計(円) 明細件数
2026-10 2000 2
2026-11 4000 3
2026-12 600 1

手順2 「売上明細」タブに戻り、空行とゼロ円の行が入力時のままか確認します。さらに、結果タブを残したまま同じ関数を手動実行し、既存の結果が上書きされず、同名タブがある旨のエラーで停止すれば、上書き防止の条件も確認できます。

手順3 結果が違う場合は、まずズレ方から入力とコードを切り分けます。11月が4,000円で2件ならゼロ円の行が落ちた可能性があり、10月が1,200円だけなら空行以降が読み込まれていない可能性があります。合計6,600円と件数6件が合うのに月別の値が違う場合は、月のキーを作る処理とタイムゾーンを確認します。

Apps Scriptはコードに含まれるサービスをもとに権限を判定します。現在のファイルへのアクセスに絞るには、コード先頭のファイルレベルのコメントに @OnlyCurrentDoc があるかと、プロジェクト内のほかのコードも確認します。想定していないサービスを求められた場合は許可する前に差分を見直します。GoogleのApps Script権限ガイド

状況 先に確認すること
Geminiのアイコンが出ない 対象ライセンス、プロジェクトの編集権限、段階展開の状況を確認します。職場・学校ではApps Scriptサービスと生成AIの設定を管理者に確認します。
アイコンはあるがパネルが読み込まれない 対象Googleアカウントだけが有効なブラウザプロファイルで確認します。サイドパネルの公式ガイドに記載された英語または既定の言語設定も確認します。
パネルは開くが実行時に止まる エディタの実行ログで、権限不足か、シート名や入力形式のエラーかを確認します。ログの内容を使ってGeminiに修正を頼む場合も、適用前に差分を確認します。

よくある質問

対応アカウント、パネル表示、元データ、手動実行の確認

初回は対応アカウントでテスト用のファイルを開き、手動実行で出力を確認します。元データの保護と繰り返し実行の条件は、以下のFAQで確認できます。

よくある質問

Q. 個人アカウントで使えますか?
Googleの一般提供告知には、有料のGoogle AI ProとGoogle AI Ultraが記載されています。無料の個人アカウントとGoogle AI Plusは対象一覧に含まれていません。
Q. Geminiが出ないときは何を確認しますか?
対象ライセンス、編集権限、段階展開を確認します。職場や学校では管理者にも確認し、読み込みに失敗するときは対象アカウントだけが有効なブラウザプロファイルと、英語または既定の言語設定で試します。
Q. 元データを保護できますか?
元ファイルと切り離したテスト用ファイルを使います。生成コードは明細を読むだけにし、書き込み先を新規タブに限定して、同名タブがある場合は処理を止めます。
Q. 自動実行の設定は必要ですか?
今回の検算では、エディタで関数を選んで手動で実行します。トリガーの追加やウェブアプリとしてのデプロイは不要です。

出典・参考データ

  1. [1] Google Workspace Updates:一般提供と展開日程
  2. [2] Google for Developers:Apps Script リリースノート
  3. [3] Google for Developers:Gemini サイドパネル
  4. [4] Google for Developers:Google スプレッドシートの拡張
  5. [5] Google for Developers:Google サービスの承認
  6. [6] Google One:日本向け Google AI プラン

この記事を書いた人

水島 翔吾

株式会社kairos 代表取締役 / AgentSignal 開発者

AI クローラー・AI 流入計測と AIO 診断ツール AgentSignal を開発。実測データを元に AI 検索時代の計測と対策を書いています。

関連記事