Googleビジネスプロフィールの月次レポートをGASでスプレッドシートに自動記録する——APIを使わずメールを読む

何を自動化したか

Googleビジネスプロフィール（以下GBP。Googleマップや検索結果に出る店舗情報）を持っていると、Googleから毎月、前の月の実績をまとめたメール（GBPの月次レポート。以下「実績メール」）が届く。通話数やルート検索数などが並ぶが、毎月開いて数字を控えるのは手作業になる。2026年8月の見直しで、実績メールを毎月人の手で読む運用は非効率だという結論になり、自動化した。

今は毎朝6時台に、前の月の行がまだ無ければ、Google Apps Script（GAS）がGmailからこのメールを探し、実績メールかどうかの判定と数字の抜き出しをGeminiに任せて、スプレッドシートの「GBP実績」シートに1か月1行で書き込んでいる。前の月の行が入った月は、その日から月末まで探さない。あわせて、毎週月曜にはGoogleマップの「最新情報」に載せる投稿文も自動で作っている（公開は人が貼り付ける）。

どちらもGBPのAPIは使っていない。GBPのAPIは、利用申請のフォームを出してGoogleの承認を受けるまで呼び出せない（公式ドキュメント）。一方、実績メールは申請しなくても毎月届いていて、GASなら GmailApp で読める。残したいのは月ごとの数字なので、申請と承認を待たずに、届いているメールを読むことにした。そのかわり、取れるのはメールに書かれている数字だけになる。

仕組み（データの流れ）

扱う処理は次の3つで、どれも既存の定期実行（ディスパッチャー）の中で動く。GBPのための新しいトリガーは作っていない（理由はトリガー集約の記事）。

いつ	処理	読むもの	書く先
毎朝 6時台（前の月の行が入るまで）	growthGbpMonthlyImport（月次の取り込み）	Gmailの直近35日分のメール	「GBP実績」シートに1か月1行
毎月1日 8時台	officeMonthlyReport（教室の月次レポート）	「GBP実績」シートの対象月と前月の行（対象月がまだ無ければ最新の月）	教室の月次レポートの材料（前月の行があれば前月比も）
毎週月曜 7時台	growthGbpWeeklyPost（週次の投稿文）	Threadsの投稿ログの直近7日分	通知メール（投稿文と貼り方）

毎月1日の8時台は、教室の月次レポートを作る直前にも取り込みを念のため1回呼んでいる（前の月の行があればすぐ終わる）。「GBP実績」シートは、月・インタラクション数・通話数・チャットクリック数・ルート検索数・ウェブサイト訪問数・プロフィール閲覧数・検索数・取込日時・メッセージIDの10列。メッセージIDは同じメールを二度取り込まないための目印だ。失敗時の通知も独自には作らず、例外はディスパッチャーの autoRunSafely が記録して毎晩のまとめ通知に載せる（同じ種類の失敗が続くときは、前回の通知から7日ごとにだけ通知する。詳しくはGemini APIの記事）。

コード（要点）

検索は件名や差出人を1つに決め打ちしていない。Google側の仕様変更で件名や送信元の表記が揺れることがあるためだ（コードのコメントより）。関係しそうなメールを2つの検索式で広めに拾い（1式につき15スレッドまで、失敗した式は飛ばす）、実績メールかどうかはGeminiに判定させる。広告メールの仕分けと同じ「検索は広く・判定はAIで絞る」作りだ。

function growthGbpSearchCandidates_() {
  var queries = [
    '(from:google.com OR from:business.google.com OR from:mybusiness.google.com) '
      + '(ビジネスプロフィール OR "Business Profile" OR パフォーマンス OR performance OR インサイト OR insights) newer_than:35d',
    'subject:(ビジネスプロフィール OR "Business Profile") (パフォーマンス OR performance OR 月次 OR monthly OR インサイト OR insights) newer_than:35d',
  ];
  var seenIds = {};
  var out = [];
  queries.forEach(function(q) {
    var threads;
    try { threads = GmailApp.search(q, 0, 15); } catch (e) { return; }
    // …（省略）…
  });
  return out;
}

省略した部分では、スレッドの中のメールを1通ずつ取り出し、両方の式に引っかかったメールはメッセージIDで1通にまとめている。

取り込みの本体は、まず前の月の行がもうあるかを見て、あればGmailもGeminiも使わずに終わる。無ければ、取り込み済みのメッセージID（シートのJ列）と、取り込まないと判定済みのメールID（スクリプトプロパティ GBP_JUDGED_IDS）を除いたメールを、1通ずつGeminiに渡す。本文に無い項目は0でなくnullで返させ、憶測で埋めさせないのが要点だ。

    // …（省略）…
    var subject = msg.getSubject() || '';
    var from = msg.getFrom() || '';
    var body = (msg.getPlainBody() || '').slice(0, 8000);

    var result = autoGeminiJson([
      'これはGmailのメールです。総合学習教室ブリッジ（学習塾）のGoogleビジネスプロフィール（GBP）宛に',
      'Googleから自動配信される「月次パフォーマンスレポート」（インタラクション数・通話数・チャットクリック数・',
      'ルート検索数・ウェブサイト訪問数・プロフィール閲覧数・検索数などの指標を含むメール）かどうかを判定し、',
      'そうであれば本文から数値を抽出してください。',
      '',
      '差出人: ' + from,
      '件名: ' + subject,
      '本文:\n' + body,
      '',
      '注意: 数値が本文に無い項目は0ではなくnullにする（憶測で埋めない）。対象月がわかれば "yyyy-MM" 形式で。',
      'JSON形式で回答: {"isGbpMonthlyReport": true/false, "targetMonth": "yyyy-MM"またはnull, '
        + '"interactions": 数値またはnull, "calls": 数値またはnull, "chatClicks": 数値またはnull, '
        + '"directionRequests": 数値またはnull, "websiteVisits": 数値またはnull, '
        + '"profileViews": 数値またはnull, "searches": 数値またはnull}',
    ].join('\n'));

    seen[id] = true;  // 判定できた時点で処理済み扱い（GBPレポートでなくても再判定を繰り返さない）
    if (!result || result.isGbpMonthlyReport !== true) {
      judged[id] = new Date().toISOString();  // 次の朝からはこのメールをGeminiへ送らない
      continue;
    }

autoGeminiJson は、GeminiにJSONだけを返させて取り出す共通の関数だ（Gemini APIの記事も参照）。実績メールではないと判定したメールと、下に出てくる「取り込み済みの月の再送」のメールは、IDを判定した日時と一緒にプロパティへ残し、60日たったら捨てる。検索は直近35日分なので、そのメールが検索に引っかかる間はずっと除かれ、毎朝Geminiへ送り直さずに済む。プロパティへの保存はループを try で囲んだ finally の中で行うので、途中でGeminiの呼び出しが失敗して例外で抜けても、それまでの判定は残る。

判定を通ったメールは対象月を決めて1行追記する。growthGbpNormalizeMonth_ は「2026-7」も「2026年7月」も 2026-07 の形にそろえ、読めなければnullを返す。そのときは受信日の前月を使う。

    // …（省略）…
    // 対象月をGeminiの抽出結果から。取れなければメール受信月の前月を仮定
    // （GBPの月次レポートは対象月の翌月に届く。2026年3〜8月分は翌月の7〜24日だった）
    var month = growthGbpNormalizeMonth_(result.targetMonth);
    if (!month) {
      var d = new Date(msg.getDate());
      d.setDate(1);
      d.setMonth(d.getMonth() - 1);
      month = Utilities.formatDate(d, 'Asia/Tokyo', 'yyyy-MM');
    }

    // 同じ月をすでに取り込んでいれば重複記帳しない（メールが再送・転送された場合の保険）。
    // 月の列は日付として保存されていることがあるので、yyyy-MM にそろえてから比べる
    if (growthGbpHasMonth_(sheet.getDataRange().getValues(), month)) {
      judged[id] = new Date().toISOString();  // 前月分が入るまでの毎朝、同じ再送メールをGeminiへ送り直さない
      continue;
    }

    // 数値が無い項目は空のセルにする（0 と区別するため。読む側は growthGbpNum_ で「データなし」扱い）
    var row = [month].concat(['interactions', 'calls', 'chatClicks', 'directionRequests', 'websiteVisits',
      'profileViews', 'searches'].map(function(k) {
        var n = growthGbpNum_(result[k]);
        return n === null ? '' : n;
      })).concat([new Date(), id]);
    var at = sheet.getLastRow() + 1;
    sheet.getRange(at, 1).setNumberFormat('@');  // 「2026-07」を日付に変換させない（書式なしテキスト）
    sheet.getRange(at, 1, 1, row.length).setValues([row]);

月を戻す前に日を1日にしているので、31日に受け取ったメールでも月がずれない。setMonth だけで戻すと、3月31日が「2月31日」扱いになって3月に繰り越される。書き込む前に月のセルだけ書式なしテキスト（@）にしているのは、「2026-07」という文字をスプレッドシートが日付として保存しないようにするためだ（理由は下の「ハマった点」）。

週次の投稿文は、Threadsの投稿ログから直近7日で閲覧数がいちばん多い投稿を選び、GBPの「最新情報」向けにGeminiで書き直させる。できた文章は投稿せず、貼り方を付けてメールで送る。

  // …（省略）…
  var formUrl = PropertiesService.getScriptProperties().getProperty('WEBAPP_URL');
  var post = autoGeminiText([
    RIKIMA_PROFILE,
    '',
    '以下のThreads投稿を、Googleビジネスプロフィール（Googleマップ）の「最新情報」投稿用に書き直してください。',
    '読者は「彦根市 塾」などで検索している地域の保護者です。',
    // …（省略）…
    '【条件】',
    '・150〜300字。地域の保護者に語りかける丁寧な標準語。',
    '・最後に「無料体験受付中」と一言入れる。',
    '・ハッシュタグなし。投稿文のみ出力。',
  ].join('\n'), { temperature: 0.5 });

  autoNotify('📍 今週のGoogleマップ投稿（コピペ用）',
    post
    + '\n\n--- 貼り方（スマホで2分） ---'
    + '\n1. Googleマップアプリで「ビジネス」→「投稿」'
    + '\n2. 上の文章を貼り付け、教室の写真を1枚添えて公開'
    + (formUrl ? '\n3. ボタンは「予約」→ ' + formUrl + '?app=trial を設定' : ''));
}

投稿ログはThreads自動投稿が書いているもので、RIKIMA_PROFILE は文体をそろえる人物像の定数だ。WEBAPP_URL が設定されていれば、体験予約フォーム（?app=trial）を予約ボタンの飛び先として添える。

ハマった点と回避策

1日の朝には、前の月のメールがまだ届いていなかった

最初は取り込みを毎月1日の朝8時台に1回だけ走らせ、その直後に教室の月次レポートを作っていた。ところが、届いた実績メールの受信日は、2026年3月分から8月分までの6通とも、翌月の7日から24日のあいだだった。1日の朝の時点で前の月のメールが届いていた月は一度も無い。1日に1回だけ取り込む作りでは、前の月の行はさらに次の月の1日まで入らない。教室の月次レポートも、対象月の行が無ければ何も書かない作りだったので、GBPの数字は一度も載らなかった。取り込みは毎朝の処理に足し、実績メールが届いた次の朝にはシートに入るようにした（1日の8時台の呼び出しも念のため残してある）。それでも1日の時点では前の月の分はまだ届いていないので、教室の月次レポートのほうは、対象月の行がまだ無ければ「○月分はGoogleからのメール待ち。最新の取り込み △月分」と書いて、いちばん新しい月の数字を載せるようにした。

空欄が「0」になり、「2026-07」が日付になっていた

数字の無い項目はnullのまま書いていたので、セルは空になる。ところが読む側が Number(セルの値) で数値にしていて、JavaScriptでは Number('') が0になる。空欄が「0」と表示され、インタラクション数が空の月は「前月比 -100%」とまで出る作りだった。もう1つ、GASから「2026-07」という文字を書くと、スプレッドシートはそれを日付として保存することがある。日付として読まれると String(セルの値) === '2026-07' は一致しない。空欄と数値でない値は growthGbpNum_ でnull（表示は「データなし」か「-」）にそろえ、月は growthGbpMonthKey_ で日付も文字も「yyyy-MM」にしてから比べ、新しく書く行は月のセルを書式なしテキストにしてから書くようにした。

メール本文は思ったより長い

届いたメールから数字を抜く方式で、この教室は一度つまずいている。noteの売上通知メールの金額を読む処理で本文を先頭2000字に切っていたら、長い計測用URLの並びに阻まれて金額まで届かず、金額不明のまま記帳されていた。上限を20000字に広げて直し、事故と教訓を書き留めている記録には、外部サービスの本文を解析する処理は「思ったより長い」前提で書く、と残した。GBPの取り込みは先頭8000字を渡している。取り込んだ行が空欄ばかりになったら、まずこの上限を疑う。

材料が無い週、メールが見つからない月は黙って終わる

事故と教訓を書き留めている記録には、「条件を満たさなければ静かにスキップ」する安全設計は、受け取る側から見ると「何も届かない故障」になる、という教訓もある（2026-07-06に直した、様子メモを読む週次の提案が黙って止まっていた件。詳しくは週次ダイジェストの記事）。週次の投稿文は今もこの形で、直近7日のThreads投稿が無ければログに1行書いて終わる。月次の取り込みも、メールが見つからない朝は「0件取込」で終わって通知は出ない。材料のThreadsも、2026-07-21にアクセストークンの期限切れで全投稿が止まったことがある（以後は毎週自動で更新）。今は、毎週月曜の週次ダイジェストに直近7日のThreads投稿数が載ることと、教室の月次レポートの「最新の取り込み」の月が古いまま進まないことで気づく、という間接的な手当てにとどまる。

導入手順

1. GBPを管理しているGoogleアカウントのGmailに、Googleから実績メールが届いているかを確かめる。GmailApp は実行したアカウントの受信箱しか読めないので、GASもそのアカウントで作る
2. 記録先を決める。この教室の autoSheet(シート名, 見出し) は、スクリプトプロパティ AUTOMATION_HUB_ID で指定したスプレッドシートにそのシートが無ければ、見出し付きで作る。プロパティが未設定だと新しいスプレッドシートを作ってそのIDを保存するので、手元で用意したスプレッドシートは、先にそのIDを入れておかないと使われない
3. Gemini APIのキーを取得し、スクリプトプロパティ GEMINI_API_KEY に入れる（コードには書かない）。メールの本文をGeminiに送るので、キーは課金を有効にした有料枠で使う（無料枠の扱いはGemini APIの記事の導入手順を参照）
4. 取り込みの関数と定数を.gsファイルに置く。関数は、検索の growthGbpSearchCandidates_、本体の growthGbpMonthlyImport、月を「yyyy-MM」にそろえて比べる growthGbpNormalizeMonth_・growthGbpMonthKey_・growthGbpIsDate_・growthGbpHasMonth_、数値にする growthGbpNum_。定数は、シート名の GBP_MONTHLY_SHEET、上の10列の見出しの GBP_MONTHLY_HEADERS、判定済みのIDを残すプロパティ名の GBP_JUDGED_PROP。検索式のキーワードは、届いているメールの件名に合わせて足し引きする
5. それが使う共通の関数も置く。シートまわりの autoHub・autoSheet・autoSeenSet、Geminiまわりの autoGeminiJson とその下で使う autoGeminiText・autoParseJson・autoGeminiFetch_ など（Gemini APIの記事参照）、通知の autoNotify（手順8の週次の投稿文で使う）
6. メールが届いてから35日以内に、GASエディタから growthGbpMonthlyImport を一度手動で実行して権限を許可し、シートに入った数字がメール本文と合っているかを目で確かめる
7. 毎朝動く時間トリガーに登録する。この教室は毎朝のディスパッチャー autoDailyMorning に autoRunSafely('GBP月次レポートの取り込み（前月分が入るまで毎朝）', growthGbpMonthlyImport); を1行足した。前の月の行が入った月はすぐ終わり、それまでの朝も、取り込み済みのメールと、取り込まないと判定済みのメール（実績メールではないもの・取り込み済みの月の再送）はGeminiへ送らない
8. 週次の投稿文も作るなら、growthGbpWeeklyPost を週1回の処理（この教室は autoWeeklyMonday）に足す。投稿ログは列の位置で読む（A列が日時、G列が閲覧数、J列が本文）ので、自分のログに合わせて番号を直す。ログのシートを返す関数（この教室は getLogSheet）と文体の定数 RIKIMA_PROFILE も要る。通知先はスクリプトプロパティ NOTIFY_EMAIL（未設定なら実行ユーザーのアドレス）

よくある質問

Q. 実績メールが遅く届いたらどうなりますか

前の月の分なら、その行が入るまで毎朝探しているので、届いた次の朝に取り込まれる。行の「月」はまず本文から決め、読めないときだけ受信日の前月を使うので、本文に対象月が書いてあれば、遅れて届いてもずれない。毎月1日の教室の月次レポートの時点で前の月の行がまだ無ければ、「メール待ち」と書いたうえで最新の月の数字を載せる。2026年3〜8月分の実績メールは翌月の7〜24日に届いていたので、1日の時点ではこれがふつうだ。

Q. Googleマップへの投稿まで自動にできませんか

この教室ではしていない。投稿の自動化にもGBPのAPIが要り、利用申請と承認が前提になるためだ。GASは文章を作るところまでで、公開は届いたメールの手順どおり人がスマホで貼り付ける。