【GAS入門#39】本日のメール送信残り上限数をチェック!MailApp.getRemainingDailyQuota()の使い方と送信エラー防止テクニック

前回(第38回)は、GmailThread.addLabel() を使って、特定のメールのやり取りに「スープカレー部」などのラベルを自動で付与し、受信トレイを綺麗に整理するテクニックを学びましたね!

GAS(Google Apps Script)を使ったメール操作の学習もいよいよ大詰めです。第31回から始まった「フェーズ4:Gmail連携・メール自動配信」では、下書き作成やメール送信、検索、添付ファイルの取り出しなど、さまざまな自動化テクニックを身につけてきました。

しかし、GASでメール自動送信システムを運用する際、多くのエンジニアや担当者が一度はぶつかる最大の壁があります。

それが、「Googleが設定している1日あたりのメール送信制限(クォータ)」です。

「札幌オフィスの特産品キャンペーン案内メールを顧客150名に一括送信しようとしたら、途中でエラーが発生して処理が止まってしまった…!」

「何通目まで送信できて、誰に送信できていないのか分からなくなって大混乱…」

そんな大惨事を未然に防ぐために用意されているのが、今回解説する MailApp.getRemainingDailyQuota() です!

この命令を使えば、「本日、自分のGoogleアカウントであと何通メールを送れるか」という残りの送信上限数をプログラム内で一瞬で確認できます。

今回は、この MailApp.getRemainingDailyQuota() の基本的な使い方から、送信前の「安全チェック機能」の組み込み方、アカウントごとの送信制限数の違い、初心者がハマりやすい注意点まで、どこよりも分かりやすく徹底解説していきます!

1. そもそも MailApp.getRemainingDailyQuota() とは?

MailApp.getRemainingDailyQuota() は、GASからメールを送信する際に「今日あと何通のメールを送信できるか(残りの送信枠)」を取得する命令(メソッド)です。

コードの構造を分解してみよう

var remainingQuota = MailApp.getRemainingDailyQuota();
  • MailApp(メール・アップ)Google Apps Scriptでメール送信に関する基本機能を提供する標準クラスです。
  • .getRemainingDailyQuota()(ゲット・リメイング・デイリー・クォータ)直訳すると「1日の残りの割り当て量を取得する」という意味です。
    • Remaining = 残りの
    • Daily = 1日の
    • Quota = 割り当て・上限数

なぜ送信上限数のチェックが必要なの?

Googleでは、スパム(迷惑メール)の大量送信やサーバーへの過度な負荷を防ぐため、1つのGoogleアカウントが1日に送信できるメールの通数に上限を設けています。

もし上限を超えてメールを送信しようとすると、GASは以下のような赤文字のエラーを出してプログラムの実行を強制停止してしまいます。

Exception: 1 日の送信数の上限に達しました。

(または Exceeded daily total email recipients limit.)

プログラムが途中で止まってしまうと、次のような問題が発生します。

  1. どこまで送信できたかが分からなくなる(重複送信や送信漏れの原因に)
  2. エラー発生以降の処理(スプレッドシートへの記録など)が実行されない

だからこそ、メールを一括送信する前に 「今から送ろうとしている件数に対して、本日の残り送信枠は足りているか?」 を getRemainingDailyQuota() で確認し、足りない場合は処理を安全にストップさせる「ブレーキ機能(安全装置)」を組み込むことが極めて重要なのです!

2. 本日使う命令「MailApp.getRemainingDailyQuota()」の基本ルール

まずは文法と特徴をしっかり押さえておきましょう。

基本文法

MailApp.getRemainingDailyQuota()
  • 引数(カッコの中身):不要(空っぽでOK)
  • 戻り値(返ってくる結果):数値(Number)(例:100 や 1498 など、残りの送信可能通数)

💡 疑問:GmailApp と MailApp は何が違うの?

GASを学んでいると、第32回で登場した GmailApp.sendEmail() のように GmailApp を使う場合と、今回の MailApp を使う場合がありますよね。

実は、GmailApp.getRemainingDailyQuota() という書き方も存在し、どちらを実行しても同じアカウントの残り送信上限数が返ってきます。

クラス名主な特徴getRemainingDailyQuota() の動き
MailAppシンプルなメール送信・上限確認に特化した軽量クラス全く同じ残り数が返る(よく使われる)
GmailApp下書き作成、検索、ラベル操作などGmailの高度な機能を持つクラス全く同じ残り数が返る

一般的に「残り上限枠の確認」や「単純なメール送信」では歴史の古い MailApp が使われることが多いですが、どちらを使っても問題ありません。

3. STEP1:【実践】自分のアカウントの「本日残り送信可能数」を確認してみよう!

まずは、あなたのGoogleアカウントで本日あと何通メールが送信できるのか、実際のコードを動かしてログに表示させてみましょう!

1. スプレッドシートとエディタの準備

  1. 新しいGoogleスプレッドシートを開き、タイトルを 「札幌オフィス_メール送信管理」 にします。
  2. 上部メニューの 「拡張機能」 > 「Apps Script」 をクリックしてエディタを開きます。

2. コードを入力する

エディタ内の既存コードをすべて消去し、以下のコードを貼り付けます。

function checkEmailQuota() {
  // ① 本日のメール送信残り上限数を取得する
  var remainingQuota = MailApp.getRemainingDailyQuota();
  
  // ② 取得した数値をログ画面に表示する
  Logger.log("■ 本日あと送信できるメール通数: " + remainingQuota + " 通");
}

3. 保存して実行する

  1. 上部の 「保存(フロッピーマーク)」 ボタンを押します。
  2. 実行する関数が checkEmailQuota になっていることを確認し、「実行」 ボタンをクリックします。
  3. 初回実行時は権限の承認画面が出ることがありますので、画面の指示に従って許可してください(第2回の承認手順を参照)。

4. 実行結果を確認する

画面下部の「実行ログ」エリアに、以下のように表示されれば大成功です!

情報    ■ 本日あと送信できるメール通数: 100 通

(※無料の @gmail.com アカウントの場合は 100、有料のGoogle Workspaceアカウントの場合は 1500 やそれに近い数値が表示されます)

たったこれだけのコードで、自分が今日あと何通メールを送れるのかが一目で把握できましたね!

4. STEP2:【応用実践】メール一括送信前の「自動安全チェックシステム」を作ろう!

それでは、実務で使える実践的なシステムを構築してみましょう!

今回は、「札幌オフィスの秋の味覚感謝セール(スープカレー&ラーメンセット)」 の案内メールを、スプレッドシートの宛先リストに基づいて一括送信するシナリオを考えます。

送信処理に入る前に MailApp.getRemainingDailyQuota() でチェックを行い、「送信予定数 > 残り送信可能数」 になっている場合は、送信を実行せずに安全に処理を打ち切る(ストップする)プログラミングを作成します。

1. スプレッドシートの準備

シート名を 「宛先リスト」 に変更し、以下のように顧客データを入力してください。

ABC
1顧客名メールアドレス商品案内
2札幌 太郎sample1@example.com濃厚スープカレーセット
3小樽 花子sample2@example.com旭川醤油ラーメンセット
4函館 次郎sample3@example.com函館塩ラーメンセット

(※テスト送信する場合は、ご自身が受信できるテスト用メールアドレスを入力しておくと安心です)

2. 実践コードを入力する

GASのエディタ画面に、以下のコードを貼り付けます。

function sendSafetyBulkEmails() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheetByName("宛先リスト");
  
  // ① 送信対象のデータ行数をカウント(見出し行を除く)
  var lastRow = sheet.getLastRow();
  var sendCount = lastRow - 1; // 2行目からなので「最終行 - 1」が送信件数
  
  if (sendCount <= 0) {
    Logger.log("送信対象の顧客データがありません。処理を終了します。");
    return;
  }
  
  // ② 本日の残り送信可能上限数をチェック
  var remainingQuota = MailApp.getRemainingDailyQuota();
  
  Logger.log("【チェック開始】");
  Logger.log("・送信予定件数: " + sendCount + " 件");
  Logger.log("・本日の残り送信可能枠: " + remainingQuota + " 通");
  
  // ③【最重要】送信予定数が残り枠を超えているかチェック(安全装置)
  if (sendCount > remainingQuota) {
    Logger.log("⚠️【エラー防止】送信予定数 (" + sendCount + "件) が本日の残り上限枠 (" + remainingQuota + "通) を超えています!");
    Logger.log("メールの送信を安全に中止しました。明日以降に再実行してください。");
    return; // ここで処理を強制終了!
  }
  
  // ④ 上限枠に問題がなければ、1通ずつメールを送信(第32回の復習)
  var data = sheet.getRange(2, 1, sendCount, 3).getValues(); // A2:C4のデータを取得
  
  for (var i = 0; i < data.length; i++) {
    var customerName = data[i][0]; // 顧客名
    var email = data[i][1];        // メールアドレス
    var item = data[i][2];         // 商品案内
    
    var subject = "【札幌オフィス】秋の味覚感謝セールのご案内";
    var body = customerName + " 様\n\n" +
               "いつも大変お世話になっております。札幌オフィスです。\n" +
               "本日のおすすめ商品は「" + item + "」です!\n\n" +
               "ぜひこの機会にお買い求めください。";
    
    // メール送信を実行
    MailApp.sendEmail(email, subject, body);
    Logger.log("・" + customerName + " 様 (" + email + ") へメール送信完了");
  }
  
  // ⑤ 送信完了後の残り枠を再確認して表示
  var updatedQuota = MailApp.getRemainingDailyQuota();
  Logger.log("🎉 すべてのメール送信が正常に完了しました!");
  Logger.log("・送信後の残り送信可能枠: " + updatedQuota + " 通");
}

3. コードのポイント解説

  • return; による処理の中断if (sendCount > remainingQuota) の条件に当てはまった場合、return; を書くことで、それ以降のメール送信ループ(for 文)を1通も実行させずにプログラムを安全に脱出させています。
  • 送信前後のクォータの変化メールを1通送信するごとに、MailApp.getRemainingDailyQuota() の値は 1 ずつ減っていきます。処理の最後に再度クォータを取得することで、正しく消費されたことをログで確認できます。

5. 知っておくべき!Googleアカウントの種類と1日のメール送信制限(クォータ)一覧

「そもそも、1日に何通まで送れるの?」という疑問をお持ちの方のために、Googleアカウントの種類ごとの送信上限数を表にまとめました。

アカウントの種類メールアドレスの例1日あたりのGAS送信上限数(クォータ)
無料Googleアカウント@gmail.com100 通 / 日
Google Workspace(有料)@company.co.jp など1,500 通 / 日
Google Workspace(試用期間中)同上100 通 / 日 (※制限される場合あり)

(※Googleの仕様変更により数値が改定される場合があります。最新情報はGoogle公式ドキュメントをご確認ください)

💡 クォータがリセットされるタイミングはいつ?

「1日100通」の上限は、メールを送信した瞬間から24時間後、または米国太平洋時間(PST)の日付変更タイミング(日本時間の午後4時〜5時頃)に順次回復・リセットされます。

「夜中に100通送ってエラーになったから、翌朝9時に再実行しよう!」としても、まだ24時間が経過していなくてクォータが回復していない場合があります。上限に達した場合は、丸1日(24時間)あけてから再実行するのが最も確実です。

6. 初心者が絶対につまずく!4大トラップと完全解決策

MailApp.getRemainingDailyQuota() を使う際に、初心者がよくハマってしまう落とし穴と解決策をまとめました。

トラップ1:末尾のカッコ () をつけ忘れて謎の文字が表示される

// ✕ NGな書き方(カッコがない)
var quota = MailApp.getRemainingDailyQuota;

// ◯ OKな書き方(カッコがある)
var quota = MailApp.getRemainingDailyQuota();

カッコを忘れちゃうと、ログに 100 などの数値ではなく、function getRemainingDailyQuota() { [native code] } という不気味な文字列が出力されてしまいます。

getRemainingDailyQuota は動きを伴うメソッド(関数)ですので、必ず末尾に () をセットでつけましょう!

トラップ2:1通のメールに複数人の CC や BCC を指定した時のカウントミス

「1通のメールに TO: 1人、CC: 2人、BCC: 2人 を指定して送信したから、消費されるクォータは 1通分 だよね?」と思いがちですが、これは間違いです!

Googleの送信制限は「送信したメールの通数」ではなく、「受信者(宛先)の総人数」でカウントされます。

  • TO (1人) + CC (2人) + BCC (2人) = 合計 5人➡ クォータは「5」消費されます!

大量送信システムを作る際は、宛先(TO・CC・BCC)の合計人数が残りクォータを超えないように計算する必要があります。

トラップ3:TypeError: MailApp.getRemainingDailyQuota is not a function と叱られる

大文字・小文字の打ち間違い(タイポ)で発生するエラーです。

  • ✕ getremainingdailyquota() (すべて小文字)
  • ✕ getRemainingDailyquota() (q が小文字)
  • ◯ getRemainingDailyQuota() (R, D, Q が大文字)

GASの慣例(キャメルケース)に従い、単語の区切りである Remaining, Daily, Quota を大文字で書きましょう。

トラップ4:上限に達しているのに MailApp.sendEmail() を実行してしまいプログラムがクラッシュする

残りクォータが 0 の状態で MailApp.sendEmail() を実行すると、GASは実行時エラーを出して止まります。

これを防ぐためには、本記事のSTEP2で紹介したように、必ず sendEmail() を呼び出す前の行で if (sendCount > remainingQuota) による条件判定を挟むことが鉄則です!

7. フェーズ4(Gmail連携)の振り返りと過去記事リファー

第31回から始まった「フェーズ4:Gmail連携・メール自動配信」も、今回の第39回で主なテクニックが出揃いました!ここで一度、これまで学んだメール機能の流れをおさらいしてみましょう。

  • 第31回:GmailApp.createDraft() で安全に下書きを作成して確認する
  • 第32回:GmailApp.sendEmail() でスプレッドシートのデータからメールを自動送信する
  • 第33回:GmailApp.search() で条件に合うメール(例: 未読通知)を自動検索する
  • 第34回:GmailThread.getMessages() でスレッド内のやり取りを一括取得する
  • 第35回:GmailMessage.getSubject() / getBody() で件名や本文のテキストを解析する
  • 第36回:GmailMessage.getAttachments() で届いたメールの添付ファイルを取り出す
  • 第37回:GmailMessage.markRead() で処理済みのメールを既読化する
  • 第38回:GmailThread.addLabel() でメールにラベルを自動付与して整理する
  • 第39回(今回):MailApp.getRemainingDailyQuota() で送信上限をチェックしシステムを安全に守る!

これらの機能を組み合わせることで、「届いた問い合わせメールを解析し、Google Driveに添付ファイルを保存し、残り枠を確認しながら自動で返信メールを送る」というような高度な完全自動化システムが作れるようになります!

8. まとめ&次回予告

今回は、本日のメール送信残り上限数をチェックしてシステムエラーを防ぐ MailApp.getRemainingDailyQuota() について解説しました。

今日の重要ポイント

  1. MailApp.getRemainingDailyQuota() は本日の残りメール送信可能数(数値)を返す
  2. 無料アカウントは1日100通、Google Workspaceは1日1,500通が上限の目安
  3. メール送信(sendEmail)を実行する前に残り数をチェックし、足りない場合は return; で安全停止させる
  4. 送信上限は「通数」ではなく「宛先人数(TO + CC + BCC)」でカウントされる

自動化ツールを実務で安心して運用するためには、「正常に動かすコード」と同じくらい「エラーを防ぐ安全コード」を書くことが大切です。ぜひ今回の安全チェックロジックをご自身のスクリプトに取り入れてみてくださいね!