GASでGmailの必要なメールだけ
取得する検索クエリ7選

function searchBasic() {
  // 検索クエリはGmailの検索窓に入れる文字列と同じ書き方
  const query = 'from:info@example.com is:unread';

  // 返ってくるのは「スレッド（会話）」の配列
  const threads = GmailApp.search(query);
  Logger.log('ヒットしたスレッド数: ' + threads.length);

  threads.forEach((thread) => {
    // 1スレッドの中に往復した複数のメッセージが入っている
    const messages = thread.getMessages();
    messages.forEach((message) => {
      Logger.log([
        message.getDate(),
        message.getFrom(),
        message.getSubject(),
      ].join(' / '));
    });
  });
}

// 1. 差出人で絞る
'from:billing@example.co.jp'

// 2. 件名に特定の語を含む（日本語やスペース入りは引用符で囲む）
'subject:"請求書"'

// 3. 添付ファイル付きだけ
'has:attachment'

// 4. 拡張子・ファイル名で絞る
'filename:pdf'

// 5. 特定ラベルのみ / 特定ラベルを除外（処理済みの除外に必須）
'label:受注 -label:処理済み'

// 6. 期間で絞る（newer_than は d=日 / m=月 / y=年）
'newer_than:7d'

// 7. アーカイブ済み・全フォルダを対象にする
'in:anywhere'

// 組み合わせは半角スペースでAND、OR は大文字で書く
'from:billing@example.co.jp subject:"請求書" has:attachment -label:処理済み newer_than:30d'

function buildDateRangeQuery(daysAgo) {
  const tz = 'Asia/Tokyo';
  const now = new Date();
  const from = new Date(now.getTime() - daysAgo * 24 * 60 * 60 * 1000);

  // after: / before: は「yyyy/MM/dd」形式の文字列を渡す
  const afterStr = Utilities.formatDate(from, tz, 'yyyy/MM/dd');
  const beforeStr = Utilities.formatDate(now, tz, 'yyyy/MM/dd');

  return `subject:"請求書" after:${afterStr} before:${beforeStr}`;
}

function searchLastWeek() {
  const query = buildDateRangeQuery(7);
  Logger.log('query = ' + query);

  const threads = GmailApp.search(query);
  Logger.log('件数: ' + threads.length);
}

const DONE_LABEL = '処理済み';

function processUnhandledMails() {
  // 処理済みラベルが付いたスレッドは検索の時点で除外する
  const query = `label:受注 -label:${DONE_LABEL} newer_than:30d`;
  const threads = GmailApp.search(query, 0, 50);
  if (threads.length === 0) return;

  const label = getOrCreateLabel_(DONE_LABEL);

  // 各スレッドのメッセージをまとめて取得（1件ずつより速い）
  const messagesByThread = GmailApp.getMessagesForThreads(threads);

  threads.forEach((thread, i) => {
    const messages = messagesByThread[i];
    const latest = messages[messages.length - 1];

    try {
      handleMessage_(latest);
      // 成功したときだけラベルを付ける（失敗分は次回また拾える）
      thread.addLabel(label);
    } catch (err) {
      console.error('処理に失敗: ' + latest.getSubject() + ' / ' + err);
    }
  });
}

function getOrCreateLabel_(name) {
  return GmailApp.getUserLabelByName(name) || GmailApp.createLabel(name);
}

function handleMessage_(message) {
  const sheet = SpreadsheetApp.getActive().getSheetByName('受注ログ');
  sheet.appendRow([
    message.getDate(),
    message.getFrom(),
    message.getSubject(),
    message.getPlainBody().slice(0, 500),
  ]);
}

function searchAllThreads(query) {
  const PAGE_SIZE = 100; // 1回の上限は500。安全側に100程度が扱いやすい
  const all = [];
  let start = 0;

  while (true) {
    // 第2引数=開始位置、第3引数=取得件数
    const threads = GmailApp.search(query, start, PAGE_SIZE);
    if (threads.length === 0) break;

    all.push(...threads);
    start += threads.length;

    // 取得数がページサイズ未満なら最終ページ
    if (threads.length < PAGE_SIZE) break;

    // 6分の実行時間制限に当たらないよう上限を決めておく
    if (all.length >= 500) {
      Logger.log('上限に達したため打ち切り。続きは次回実行で処理する');
      break;
    }
  }

  return all;
}

function saveInvoicePdfToDrive() {
  const folder = DriveApp.getFolderById('フォルダIDをここに');
  const query = 'subject:"請求書" has:attachment filename:pdf -label:保存済み newer_than:14d';

  const threads = GmailApp.search(query, 0, 30);
  const label = getOrCreateLabel_('保存済み');
  const messagesByThread = GmailApp.getMessagesForThreads(threads);

  threads.forEach((thread, i) => {
    messagesByThread[i].forEach((message) => {
      // 画像などのインライン添付は除外する
      const attachments = message.getAttachments({
        includeInlineImages: false,
        includeAttachments: true,
      });

      attachments
        .filter((file) => file.getContentType() === 'application/pdf')
        .forEach((file) => {
          const name = Utilities.formatDate(message.getDate(), 'Asia/Tokyo', 'yyyyMMdd')
            + '_' + file.getName();
          folder.createFile(file.copyBlob()).setName(name);
        });
    });
    thread.addLabel(label);
  });
}