公開日：3日前最終更新日：7時間前

Gmailの配信解除リンクを開く前に確認｜GASで候補メールをdry-run監査

Xでシェア facebookでシェア LINEでシェア

ツールおじ｜GoogleアカウントをAIエージェント化

このサンプルでできること・できないこと
準備するもの
コピーして使える最小コード
実行手順
ログの見方
失敗しやすい点と制限
公開前チェックリスト
まとめ

「不要なメルマガを減らしたい。でも、メール内の解除リンクを片っ端から開くのは不安」ということはありませんか。

この記事では、Gmailの標準的な `List-Unsubscribe` ヘッダーを読み取り、配信解除候補をドメイン別に集計します。解除URLへのアクセス、メール送信、削除、既読化、ラベル変更は一切行いません。まず安全な候補だけを絞り、最終判断は人が行うための無料サンプルです。

このサンプルでできること・できないこと

Gmail検索で対象を最大30スレッドに限定します。
配信解除用ヘッダーの有無と、HTTPS・メール送信・ワンクリック方式への対応を確認します。
件名、本文、送信者の完全なメールアドレス、メッセージID、解除URLはログへ出しません。
配信解除リンクは開かず、解除メールも送りません。
正規の送信元か、解除してよい契約・通知かは自動判定しません。

配信解除ヘッダーがないメールや、サービス利用に必要な通知もあります。結果が出ても即実行せず、送信元の公式画面で契約状況を確認してください。

準備するもの

Google Apps Scriptで新しいプロジェクトを作ります。
左側の「サービス」から Gmail API を追加します。
下のコードを貼り付けます。
最初は `QUERY` と `MAX_THREADS` を変えず、少量で試します。

検索条件は `category:promotions older_than:14d` です。受信トレイ全体ではなく、14日より前のプロモーション候補だけを確認します。

コピーして使える最小コード

const CONFIG = Object.freeze({
  DRY_RUN: true,
  QUERY: 'category:promotions older_than:14d',
  MAX_THREADS: 30,
  LOG_DETAILS: false
});

function auditGmailUnsubscribeHeadersFree() {
  validateConfig_();

  const threads = GmailApp.search(CONFIG.QUERY, 0, CONFIG.MAX_THREADS);
  const summaryByDomain = new Map();

  threads.forEach(thread => {
    const messages = thread.getMessages();
    if (!messages.length) return;

    // スレッド内の最新メッセージだけを確認する
    const message = messages[messages.length - 1];
    const metadata = Gmail.Users.Messages.get('me', message.getId(), {
      format: 'metadata',
      metadataHeaders: [
        'From',
        'List-Unsubscribe',
        'List-Unsubscribe-Post'
      ]
    });

    const headers = metadata.payload && metadata.payload.headers
      ? metadata.payload.headers
      : [];
    const fromHeader = getHeader_(headers, 'From');
    const unsubscribeHeader = getHeader_(headers, 'List-Unsubscribe');
    const unsubscribePostHeader = getHeader_(headers, 'List-Unsubscribe-Post');
    const domain = extractDomain_(fromHeader);

    const current = summaryByDomain.get(domain) || {
      domain,
      checked: 0,
      httpsHeader: 0,
      mailtoHeader: 0,
      oneClickHeader: 0,
      headerMissing: 0
    };

    current.checked += 1;
    if (!unsubscribeHeader) {
      current.headerMissing += 1;
    } else {
      if (/<https:\/\//i.test(unsubscribeHeader)) current.httpsHeader += 1;
      if (/<mailto:/i.test(unsubscribeHeader)) current.mailtoHeader += 1;
    }
    if (/list-unsubscribe=one-click/i.test(unsubscribePostHeader)) {
      current.oneClickHeader += 1;
    }

    summaryByDomain.set(domain, current);
  });

  const result = {
    status: 'REVIEW',
    dryRun: CONFIG.DRY_RUN,
    query: CONFIG.QUERY,
    checkedThreads: threads.length,
    domains: [...summaryByDomain.values()]
      .sort((a, b) => b.checked - a.checked)
  };

  // 件名・本文・完全なメールアドレス・解除URLは出力しない
  Logger.log(JSON.stringify(result));

  if (CONFIG.LOG_DETAILS === true) {
    Logger.log('注意: 詳細ログは実装していません。個人情報を追加しないでください。');
  }
}

function validateConfig_() {
  if (CONFIG.DRY_RUN !== true) {
    throw new Error('安全のためDRY_RUNはtrue固定です');
  }
  if (typeof CONFIG.QUERY !== 'string' || !CONFIG.QUERY.trim()) {
    throw new Error('QUERYを空欄にしないでください');
  }
  if (!Number.isInteger(CONFIG.MAX_THREADS) ||
      CONFIG.MAX_THREADS < 1 || CONFIG.MAX_THREADS > 30) {
    throw new Error('MAX_THREADSは1〜30で指定してください');
  }
}

function getHeader_(headers, name) {
  const target = headers.find(header =>
    String(header.name || '').toLowerCase() === name.toLowerCase()
  );
  return target ? String(target.value || '') : '';
}

function extractDomain_(fromHeader) {
  // 表示名や完全なメールアドレスは保持せず、ドメインだけ返す
  const match = String(fromHeader).toLowerCase()
    .match(/@([a-z0-9.-]+\.[a-z]{2,})/i);
  return match ? match[1] : 'unknown';
}