【GAS×Gmail特集】GASでGmailラベルを操作する方法と活用例

2025年5月18日2025年5月25日

Google Apps Script（GAS）を使えば、Gmailのラベルを自動で作成・管理・削除することができます。

この記事では、GASによるGmailラベル操作の基本から具体的なコード例、実務への応用方法まで、わかりやすく解説します。

この記事でわかること

Gmailのラベル機能の基本とメリット
Google Apps Script を使ったラベルの作成・削除・取得方法
メールへのラベル追加・管理の自動化手順
業務効率化に役立つ応用アイデア

Gmailのラベルとは？フォルダとの違いと使い方

Gmailの「ラベル」は、メールを分類・整理するためのタグ機能です。フォルダと違い、1通のメールに複数のラベルを付けることが可能です。

ラベルの主なメリット：

メールの分類を柔軟に行える（例：「仕事」「プロジェクトA」「請求書」など）
色分けで視認性アップ
フィルタ機能と併用すれば自動振り分けも可能

Google Apps Script（GAS）の準備方法

Google Apps Script エディタにアクセス
新しいプロジェクトを作成
スクリプトエディタにコードを記述
初回実行時にGmailへのアクセス権限を許可

GASでできるGmailラベル操作

ラベルの作成（createLabel()）
ラベルの取得・一覧表示（getUserLabels()）
メールへのラベル付け（addLabel()）
ラベルの削除（deleteLabel()）

Gmailラベルを新規作成する

function createLabel() {
  const labelName = '自動作成ラベル';
  const label = GmailApp.createLabel(labelName);
  Logger.log('ラベルを作成しました: ' + label.getName());
}

未読メールにラベルを追加する

function addLabelToUnreadMails() {
  const label = GmailApp.getUserLabelByName('重要');
  const threads = GmailApp.search('is:unread');

  threads.forEach(thread => {
    thread.addLabel(label);
  });

  Logger.log('未読メールにラベルを追加しました。');
}

GASですべてのラベルを一覧表示する

function listLabels() {
  const labels = GmailApp.getUserLabels();
  labels.forEach(label => {
    Logger.log(label.getName());
  });
}

GASでラベルを削除する

function deleteLabel() {
  const label = GmailApp.getUserLabelByName('古いラベル');
  if (label) {
    label.deleteLabel();
    Logger.log('ラベルを削除しました。');
  } else {
    Logger.log('指定されたラベルが見つかりませんでした。');
  }
}