【GAS】Gmailの添付ファイル名を取得する方法

2025年1月2日GASgetAttachments,getName,GmailApp

Google Apps Script（GAS）を使えば、Gmailの添付ファイル名を自動で取得し、リスト化したり、条件に応じて処理を実行することが可能です。この機能は、添付ファイルの管理や、特定のファイルを操作する際に役立ちます。この記事では、添付ファイル名を取得する具体的な方法を解説します。

1. Gmailの添付ファイル名を取得する方法
- 1.1. 基本構文
2. 具体例2: 添付ファイル名をスプレッドシートに記録
3. 具体例3: 特定のファイル名に一致する添付ファイルを抽出
4. 注意点
5. まとめ

Gmailの添付ファイル名を取得する方法

GASでは、GmailAppクラスのgetAttachmentsメソッドを使用してメールに添付されたファイルを取得し、その名前を取得できます。

基本構文

function getAttachmentNames() {
  // 件名に「レポート」を含むメールを検索
  const threads = GmailApp.search("subject:レポート");

  threads.forEach(thread => {
    const messages = thread.getMessages();

    messages.forEach(message => {
      const attachments = message.getAttachments();

      attachments.forEach(attachment => {
        const fileName = attachment.getName(); // ファイル名を取得
        Logger.log("添付ファイル名: " + fileName);
      });
    });
  });
}

実行結果

添付ファイル名: report_2025.pdf
添付ファイル名: summary.xlsx
添付ファイル名: data_chart.png

具体例2: 添付ファイル名をスプレッドシートに記録

以下のスクリプトは、取得した添付ファイル名をスプレッドシートに記録する例です。

function saveAttachmentNamesToSheet() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const threads = GmailApp.search("has:attachment"); // 添付ファイルありのメールを検索
  let row = 1; // スプレッドシートの開始行

  threads.forEach(thread => {
    const messages = thread.getMessages();

    messages.forEach(message => {
      const attachments = message.getAttachments();

      attachments.forEach(attachment => {
        const fileName = attachment.getName();
        sheet.getRange(row, 1).setValue(fileName); // ファイル名を記録
        row++;
      });
    });
  });
}

スプレッドシート例

添付ファイル名
report_2025.pdf
summary.xlsx
data_chart.png

具体例3: 特定のファイル名に一致する添付ファイルを抽出

以下は、特定のファイル名（例: report_2025.pdf）に一致する添付ファイルを抽出する例です。

function filterAttachmentByName() {
  const threads = GmailApp.search("has:attachment");

  threads.forEach(thread => {
    const messages = thread.getMessages();

    messages.forEach(message => {
      const attachments = message.getAttachments();

      attachments.forEach(attachment => {
        if (attachment.getName() === "report_2025.pdf") {
          Logger.log("一致する添付ファイル: " + attachment.getName());
        }
      });
    });
  });
}