図1-1：メルマガ配信システムの全体アーキテクチャとデータ連携フロー

Google Workspaceを活用したメルマガ配信システムの利点

自前でメルマガ配信システムを構築する際、Google Workspaceのエコシステムを活用することには以下の大きなメリットがあります。

システム全体アーキテクチャと連携構造

本システムは、ユーザーが操作するブラウザ画面（フロントエンド）、業務ロジックを担うGAS（バックエンド）、そしてGoogle各種サービス（Docs、Sheets、Gmail）の3層構造で構成されています。

全体の処理の流れは以下の通りです：

宛先を管理する「送信リスト」シートの設計仕様

メルマガの宛先マスタとなる「送信リスト」シートは、シンプルながら確実な追跡ができるように設計します。

多様なステータス入力を統一する安全な正規化ロジック

スプレッドシートを手動で運用していると、E列（配信状況）に「○ / ×」「1 / 0」「TRUE / FALSE」「配信可 / 配信停止」など、人によって異なる表記が入力されるケースが多発します。

誤送信や除外漏れを防ぐため、バックエンド側で厳格な正規化関数を用意し、どのような表記であってもプログラム上では確実に「配信」または「停止」の2値として扱います。

/**
 * 配信状況の文字列を「配信」または「停止」に厳格に正規化する関数
 */
function getDeliveryStatus(value) {
  if (value === null || value === undefined) return DELIVERY_STATUS_ACTIVE;
  var str = String(value).trim().toLowerCase();
  
  // 停止を表す代表的な表記をすべて網羅
  if (
    str === '停止' ||
    str === 'false' ||
    str === '0' ||
    str === '×' ||
    str === 'x' ||
    str === 'no' ||
    str === 'stop' ||
    str === '無効' ||
    str === '配信停止' ||
    str === '除外'
  ) {
    return DELIVERY_STATUS_STOPPED;
  }
  
  return DELIVERY_STATUS_ACTIVE;
}

/**
 * 配信停止状態かどうかを判定する関数
 */
function isUnsubscribed(value) {
  return getDeliveryStatus(value) === DELIVERY_STATUS_STOPPED;
}

さらに、スプレッドシートが開かれた際やWebアプリ起動時に「ensureDeliveryStatusColumn()」を実行し、E列のヘッダーを「配信状況」に自動統一した上で、スプレッドシートのデータ入力規則（プルダウン: 配信 / 停止）を自動付与する仕組みを組み込みます。

配信結果と予約を記録する「配信履歴」シートの設計仕様

配信履歴シートは、いつ・誰が・どのような件名で何通送信したのかを正確に記録し、万が一の障害時に原因を究明するためのブラックボックスとしての役割を果たします。

環境変更に強いグローバル定数の管理設計

システムを運用するにあたり、コード内の随所にシート名やIDを直接書き込む（ハードコードする）と、シート名変更やテスト環境への移行時に予期せぬ不具合を招きます。

「Code.gs」の先頭にグローバル定数を集約し、汎用的に変更できる構成にしておきます。

/**
 * ==============================================================================
 * メルマガ配信システム グローバル設定定数
 * ==============================================================================
 */

// スプレッドシート設定
var SPREADSHEET_ID = 'YOUR_SPREADSHEET_ID_HERE'; // 顧客リスト管理スプレッドシートのID
var SHEET_NAME = '送信リスト';                     // 宛先一覧シート名
var SCHEDULE_SHEET_NAME = '配信履歴';             // 履歴・予約管理シート名

// Googleドキュメント設定
var TEMPLATE_DOC_ID = 'YOUR_TEMPLATE_DOC_ID_HERE'; // メール本文原稿ドキュメントのID

// メール送信設定
var SENDER_NAME = '自社メルマガ事務局';              // メールの差出人表示名
var FROM_EMAIL = 'newsletter@example.com';          // 送信元メールアドレス（厳格照合対象）
var PLAIN_FALLBACK = 'お使いのメールソフトはHTMLメールに対応しておりません。';

// ステータス定数
var DELIVERY_STATUS_ACTIVE = '配信';
var DELIVERY_STATUS_STOPPED = '停止';

var SCHEDULE_STATUS_PENDING = '待機中';
var SCHEDULE_STATUS_COMPLETED = '送信済み';
var SCHEDULE_STATUS_CANCELLED = 'キャンセル';
var SCHEDULE_STATUS_FAILED = '配信失敗';

var DELIVERY_TYPE_IMMEDIATE = '即時配信';
var DELIVERY_TYPE_SCHEDULED = '配信予約';

var HISTORY_MAX_ROWS = 10; // 管理画面に表示する最新履歴件数

宛先リストを一括取得するGASバックエンド処理

スプレッドシートから宛先データを取得する際は、セルを1行ずつ読み込むのではなく、「getDataRange().getValues()」で全データをメモリ上に一括ロードして配列処理を行うのがGASの定石です。

/**
 * 送信リストシートから宛先一覧を取得し、正規化して返す
 */
function getRecipients() {
  try {
    var ss = SpreadsheetApp.openById(SPREADSHEET_ID);
    var sheet = ss.getSheetByName(SHEET_NAME);
    if (!sheet) {
      throw new Error('シート「' + SHEET_NAME + '」が見つかりません。');
    }

    var data = sheet.getDataRange().getValues();
    if (data.length <= 1) {
      return []; // ヘッダーのみの場合は空配列
    }

    var recipients = [];
    // 2行目（インデックス1）から走査
    for (var i = 1; i < data.length; i++) {
      var row = data[i];
      var ownerId = String(row[0] || '').trim();
      var name = String(row[1] || '').trim();
      var email = String(row[2] || '').trim();
      var lastSent = row[3];
      var statusRaw = row[4];

      // メールアドレスが不正な行はスキップ
      if (!email || email.indexOf('@') === -1) {
        continue;
      }

      var formattedLastSent = '';
      if (lastSent instanceof Date) {
        formattedLastSent = Utilities.formatDate(lastSent, Session.getScriptTimeZone(), 'yyyy/MM/dd HH:mm');
      } else if (lastSent) {
        formattedLastSent = String(lastSent);
      }

      recipients.push({
        ownerId: ownerId,
        name: name,
        email: email,
        lastSent: formattedLastSent,
        status: getDeliveryStatus(statusRaw),
        unsubscribed: isUnsubscribed(statusRaw)
      });
    }

    return recipients;
  } catch (error) {
    Logger.log('getRecipients エラー: ' + error.toString());
    throw new Error('宛先リストの取得に失敗しました: ' + error.message);
  }
}

まとめと次回予告

次回（第2回）は、「GoogleドキュメントをHTMLメルマガに変換する仕組み 本文生成とインライン画像埋め込みの解説」をお届けします。
非エンジニアでも直感的に作成できるDocs原稿を、GmailのMIMEマルチパート仕様（CID埋め込みインライン画像）に自動変換する高度なサニタイズ＆画像抽出ロジックを詳しく解説します。