2021年8月5日 / 最終更新日時 : 2022年7月12日 officeの杜 Google

Google Apps ScriptでHTMLメルマガ配信システムを作る【GAS】

Google Apps Scriptを使って本格的な社内システムを作る登竜門となるのが、メールの配信。但し同一の内容ではなく、人に合わせて内容を差し替える必要があるケースが殆どです。

その場合、一個ずつ手動で作って送信はあまりにも非生産的。さらに素っ気ないテキストメールだと読み手に伝わらないので、HTMLメールで送りつけたい。こんなケースに使えるのが今回のHTMLメルマガ配信システム。但しあまりにも大量に送ると、MailAppの制限に引っかかってしまうので、そこを考慮して作る必要があります。

過去には同じような仕組みでレスポンシブなメールを送る仕組みを作ってます。

Google Apps Scriptでレスポンシブメールを送ってみた

1 今回使用するスプレッドシート
2 使い方
3 ソースコード
- 3.1 GAS側コード
- 3.2 HTML側コード
4 大量に送信したい場合には
5 関連リンク

今回使用するスプレッドシート

差し込みHTMLメール - Google Spreadsheet

個人毎に1通づつ送るので、いわゆるbccにせずに送って情報漏えいであったり、間違った人の所へ別の人の内容を送るといった事が低減できるのが今回の仕組みです（但し、スプレッドシートに書き込む内容を間違えれば意味がないですが）

使い方

実行方法

スプレッドシートを開くと、メニューに「メルマガ」というものが表示されるので、スプレッドシートの所定の欄を入力してから、「メルマガ」-> 「一斉送信」を実行すると、送信確認が出ます。実行するとスプレッドシートの内容を差し込んだHTML形式のメールが送られる仕組みになっています。

※一斉送信2は、createTemplateFromFileにて生成時に差し込みデータもつけて渡す場合の事例になります。どちらも同じ結果が得られます。

図：送信アラートが出るようになってます

制限

Google Apps Scriptに於いて、メール送信は結構厳しい送信制限が課せられています。

ドメイン内の場合は、2000通/1日まで。
外部宛の場合は、1500通/1日まで。
メールの読み書きだけならば、50000回/1日まで。
メール本文のサイズは400KB/1通まで。
メールの添付ファイルは合計25MB/1通まで。
メールの添付ファイルは250個/1通まで。
メールの受信者は50宛先/1通まで。

以上のようになっています。また、表向き制限値が掛けられていませんが、一度に大量のメールを連続送信すると、429エラーなどが起きる可能性があります（UrlfechAppはそういった制限があるのは確認）。よって、1分間に3通程度になるように、1通送信毎にウェイトを入れておくと良いでしょう。

今回は1人ずつ送るので、メールの受信者制限に掛かることはありませんが、同一メールを送りつける場合には宛先を50個毎に区切って送る必要があるので、要注意です。

//次のUrlFechApp実行まで待ちまでしばらくスリープさせる(3秒間)
Utilities.sleep(3000);

1 2	//次のUrlFechApp実行まで待ちまでしばらくスリープさせる(3秒間) Utilities.sleep(3000);

メール本文の改造

メール本文は今回はHTMLメールであるため、GASのコード内には存在しません。index.html内に構築していく必要があります。HTMLメールですので、CSSが使えたり、リンクを張ったり自在に作れる為、通常のメールを送るよりも遥かに広い表現力を実現できるのが今回の仕組みの魅力ですね。

今回は差し込みメールであるため、詳細な仕組みはソースコードの項目のHTML側コードを参照してください。body以下にメール本文、Head部分にCSSを記述したりします。JavaScriptは記述しても意味がない（ブロックされます）ので、本当にメールのテンプレート内での利用に限られます（テンプレート整形処理でjavascriptを使うことはあります）

図：body以下にメール本文をHTML形式で記述する

ソースコード

GAS側コード

//グローバル変数
var mailarr;

function mailman() {
  //送信アラートを出す
  var ui = SpreadsheetApp.getUi();

  var re = ui.alert("送信アラート", "一斉送信しますか？", ui.ButtonSet.YES_NO);
  switch(re){
    case ui.Button.YES:
      //処理を継続する
      break;
    case ui.Button.NO:
      ui.alert("送信をキャンセルしました");
      return 0;
      break;
  } 

  //スプレッドシートのデータを取得
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("mailman");
  var ss = sheet.getRange("A2:D").getValues();

  //メール本文を差し込んで送信
  for(var i = 0;i<ss.length;i++){
    try{
      //1行データを取り出す
      mailarr = ss[i];

      //メアドが空なら処理を終了
      if(mailarr[0] == ""){
        break;
      }

      //差し込んで本文を取得
      let html = HtmlService.createTemplateFromFile('index').evaluate().getContent();

      //メールを送信
      MailApp.sendEmail({
        to: mailarr[0],
        subject: mailarr[1],
        htmlBody:html,
      });
    }catch(e){
      ui.alert("失敗しました。\n" + e.message)
      return;
    }
  }

  //終了メッセージ
  mailarr = [];
  ui.alert("送信完了");
}

//グローバル変数

var mailarr;

function mailman() {

//送信アラートを出す

var ui = SpreadsheetApp.getUi();

var re = ui.alert("送信アラート", "一斉送信しますか？", ui.ButtonSet.YES_NO);

switch(re){

case ui.Button.YES:

//処理を継続する

break;

case ui.Button.NO:

ui.alert("送信をキャンセルしました");

return 0;

break;

}

//スプレッドシートのデータを取得

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("mailman");

var ss = sheet.getRange("A2:D").getValues();

//メール本文を差し込んで送信

for(var i = 0;i<ss.length;i++){

try{

//1行データを取り出す

mailarr = ss[i];

//メアドが空なら処理を終了

if(mailarr[0] == ""){

break;

}

//差し込んで本文を取得

let html = HtmlService.createTemplateFromFile('index').evaluate().getContent();

//メールを送信

MailApp.sendEmail({

to: mailarr[0],

subject: mailarr[1],

htmlBody:html,

});

}catch(e){

ui.alert("失敗しました。\n" + e.message)

return;

}

//終了メッセージ

mailarr = [];

ui.alert("送信完了");

}

冒頭に1レコード分のデータを格納するためのグローバル変数mailarrを用意しておきます。HTML側から変数にアクセスするには、HTML側でスクリプトレットで変数を取ってくる関数をGASで用意しておくか？グローバル変数で入れておくか？また、createTemplateFromFileでHTML呼び出し時に同時に値を渡す必要があります。メール送信の関数内の変数を取り出しても、HTML側からは参照できません。
forループで取得したスプレッドシートのデータの内、1レコード分をmailarrに格納
createTemplateFromFileを使ってindex.htmlの内容を取得。この時、mailarrの内容が差し込まれて、結果のHTMLをgetContentで取得しています。
送信時はMailAppを使いますが、htmlbodyに対して取得したHTMLを割り当てます。
送信エラーなどの対処のために、エラートラップを用意してあります。
実際にはスプレッドシート側に送信ステータスの列を用意して、送信完了したら送信済みが入るようにし、エラー時には未送信のものを継続して次回から送信するような仕組みを用意しておくとベターです。
また、返信されると困る場合には、noReplyオプション（Google Workspaceのみ利用可能）を付け加えたり、またreplyToオプションで返信先を自身ではなく別のメアド宛にしておくのも業務ではよく利用するテクニックです。

createTemplateFromFileで呼び出し時に同時に変数を渡す場合は以下のような感じで渡す事が可能です。HTML側は普通に<?=mailarr[0] ?>で渡された変数から取り出せます。

//HTML生成と同時に配列情報を渡す
var output = HtmlService.createTemplateFromFile('index')
  
//変数dataをつけてevaluateで渡す
output.mailarr = mailarr;
 
//ページを生成する
var html = output.evaluate().getContent();

//HTML生成と同時に配列情報を渡す

var output = HtmlService.createTemplateFromFile('index')

//変数dataをつけてevaluateで渡す

output.mailarr = mailarr;

//ページを生成する

var html = output.evaluate().getContent();

HTML側はこの変数を直接スクリプトレットで指定すれば取り出せます。

HTML側コード

<!DOCTYPE html>
<html>
  <head>
    <base target="_top">
  </head>
  <body>
    <p>今日のお題：<?=mailarr[1] ?></p><br>
    <p><?=mailarr[3] ?> <?=mailarr[2] ?>様　こんにちは、メルマガ太郎です。</p>

    <div>
      今日は素敵な情報をお届けいたします。
    </div>
  </body>
</html>

<!DOCTYPE html>

<html>

<head>

</head>

<body>

<p>今日のお題：<?=mailarr[1] ?></p><br>

<p><?=mailarr[3] ?> <?=mailarr[2] ?>様　こんにちは、メルマガ太郎です。</p>

<div>

今日は素敵な情報をお届けいたします。

</div>

</body>

</html>

createTemplateFromFileにて呼び出されてるので、GAS側の変数をスクリプトレットを使って参照が可能です
スクリプトレットを使って差し込みたい場所に変数を呼び出させて入れ込んでいます。

createTemplateFromFileやスクリプトレットについては、以前のエントリーで記述しているので、以下のリンク先を参照してみてください。

Google Apps Scriptでウェブアプリケーション作成入門

大量に送信したい場合には

本当のメルマガのように大量に送信したい場合には、Google Apps ScriptのMailAppで送るのは現実的ではないでしょう。あくまでも社内の少数のメンバーに対して通知で送る場合には非常に有効ですが、外部のメンバーに対して大量に送信したい場合には向いていません。

Microsoft365のGraph APIを利用した場合には、10000通/1日くらい送信可能であったり、送信制限も緩やかであり、またUrlfetchAppは10万回/1日利用可能であるため、メール利用ならばMicrosoft365を別途用意しておくのも良いです（とはいえ、UrlfetchAppは10秒間に3回くらいしかアクセスできず、またGASは6分の制限があるのでちょっとね・・・・）。以下のリンク先では、GASからGraph APIのOutlookサービスでメールを送る仕組みを作っています（実際に自分も社内でNode.js + Graph APIでメール通知システムは作ってます）

また、同一内容で送りたい場合は、まぐまぐなどが昔から利用されていますね。但し、REST APIが用意されてるわけじゃないので、月額有料のメール配信システムを利用するほうがREST APIも使えるケースがあるので、そちらを利用したほうが良いかと。

Google Apps ScriptとMicrosoft Graph APIの連携 – Outlook編