【GAS入門#40】セルにメモを自動追加!Range.setNote()の使い方とメール送信ログへの活用法

前回(第39回)は、GASから1日に送信できるメールの残り上限数をチェックする MailApp.getRemainingDailyQuota() について学びましたね。

メール自動送信の仕組みが完成すると、次に欲しくなるのが「いつ、どんな内容で送信が完了したか」という確実なログ(記録)です。

送信ステータスとしてセルに「送信完了」と書き込む(第6回 setValue())のも良いですが、「具体的に何時何分に送ったのか」「誰にどんな本文で送ったのか」といった詳細情報までセルの中に直に書いてしまうと、スプレッドシートの表が文字で溢れかえり、見づらくなってしまいますよね。

そこで今回登場するのが、指定したセルの右上にひょっこり現れる黄色い付箋「メモ(Note)」をプログラムから自動付与する Range.setNote() です!

セル本文の見た目をスッキリ保ったまま、マウスをホバー(カーソルを重ねる)したときだけ詳細な送信ログやエラー履歴をポップアップ表示させることができるため、実務の業務自動化ツールで大活躍します。

今回は、「札幌オフィスのイベント案内メール配信」を題材に、Range.setNote() の基礎から実務的な応用テクニック、初心者がハマりやすい落とし穴まで、どこよりも詳しく・わかりやすく解説していきます!

1. そもそも Range.setNote() とは?

Range.setNote() は、指定したセル(Rangeオブジェクト)に対して、スプレッドシートの「メモ」機能(右上に黒い三角マークがつく黄色い付箋)を自動でセット・書き込みする命令(メソッド)です。

「家・部屋・家具」の例えで理解する位置づけ

本連載でおなじみの「家・部屋・家具」の例えでおさらいしてみましょう。

  • 【家】= スプレッドシートファイル全体(SpreadsheetApp.getActiveSpreadsheet() / 第2回)
  • 【部屋】= 個別のシートタブ(ss.getActiveSheet() / 第3回)
  • 【家具】= セル・セル範囲(sheet.getRange("D2") / 第4回)

Range.setNote() は、まさにこの「家具(引き出しやデスク)の角に、詳細な情報を書いた小さな付箋ペタッと貼る操作」にあたります。

基本的なコードの構文

// 1. メモを貼りたいセル(家具)を指定する
var range = sheet.getRange("D2");

// 2. セルにメモを付与する
range.setNote("2026/01/23 10:00 送信完了\n宛先: info@example.com");

ドット(.)でつないで sheet.getRange("D2").setNote("メモの内容"); と1行で記述することも可能です。

2. セルの「メモ(Note)」と「コメント(Comment)」の違い

スプレッドシートには「メモ」とよく似た機能として「コメント」があります。初心者の方が混同しやすいため、違いをすっきり整理しておきましょう。

項目メモ(Note)★今回の主役コメント(Comment)
目印セルの右上にある**「黒い小さな三角」**セルの右上にある**「黄色または黄緑の小さな三角」**
表示方法マウスカーソルを重ねるだけで表示されるクリックするとスレッドが開く
やり取り一方的なテキスト表示のみメンバー同士で返信や「解決」ができる
主な用途システムログ、補足説明、入力補足チーム内の議論、確認依頼、レビュー
GASでの命令Range.setNote("内容")Range.setComment("内容")

自動化ツールやシステムから「実行結果のログ」「エラー内容」を機械的に残したい場合は、クリックの手間なくマウスホバーだけでスッと確認できる「メモ(setNote())」が最適です!

3. STEP1:準備!「札幌オフィス メール送信管理表」を作成しよう

それでは、実際のコードを動かすための練習用スプレッドシートを用意しましょう!

手順

  1. ブラウザで新しいGoogleスプレッドシートを作成し、ファイル名を 「札幌オフィス_自動メール配信管理」 にします。
  2. 画面下のシートタブ名を 「一括送信リスト」 に変更します。
  3. 1行目に見出しを設定し、2行目以降に以下のようなサンプルデータを入力してください。
ABCD
1宛先メールアドレス氏名イベント名送信ステータス
2yamada@example.com山田 太郎札幌スープカレー部 親睦会未送信
3sato@example.com佐藤 花子定山渓温泉 社員旅行の下調べ未送信
4study@example.com鈴木 一郎道産子GAS活用セミナー未送信
  1. 入力が完了したら、「一括送信リスト」のシートタブを選択した状態(アクティブ)にしておきます。

4. STEP2:【実践】メール送信と同時に「詳細ログメモ」を自動付与してみよう!

準備ができたら、GASのエディタを開いてコードを書いていきましょう。

今回は、D列のステータスを「送信完了」(第6回 setValue())にしつつ、そのD列のセルに「送信日時」「宛先」「件名」をまとめた改行入りのメモ(setNote())を自動付与するプログラムを作成します。

1. コードを入力する

スプレッドシートのメニューバーから 「拡張機能」 > 「Apps Script」 を開き、エディタ画面にあるコードをすべて消去して、以下のコードを貼り付けます。

function sendEmailWithLogNote() {
  // ①「家(ファイル)」と「部屋(シート)」を取得する
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getActiveSheet();
  
  // ② 送信対象のデータ(2行目〜4行目)をループ処理する
  for (var i = 2; i <= 4; i++) {
    var email = sheet.getRange(i, 1).getValue();   // A列:宛先
    var name = sheet.getRange(i, 2).getValue();    // B列:氏名
    var event = sheet.getRange(i, 3).getValue();   // C列:イベント名
    
    // メールの件名と本文を組み立てる
    var subject = "【札幌オフィス】" + event + "のご案内";
    var body = name + " 様\n\nお疲れ様です!札幌オフィス事務局です。\n" + 
               event + " の詳細についてご連絡いたしました。\nご確認よろしくお願いします!";
    
    // ③ メールを送信する(第32回 GmailApp.sendEmail)
    // ※テスト実行時は自分のメールアドレスに差し替えて試すのが安全です
    GmailApp.sendEmail(email, subject, body);
    
    // ④ 送信ステータスセル(D列)を取得する
    var statusRange = sheet.getRange(i, 4);
    
    // ⑤ D列のセルに「送信完了」と書き込む(第6回 setValue)
    statusRange.setValue("送信完了");
    
    // ⑥ 送信完了の詳細ログテキストを組み立てる(\nで改行)
    var now = Utilities.formatDate(new Date(), "JST", "yyyy/MM/dd HH:mm:ss");
    var logNote = "【送信ログ】\n" +
                  "・送信日時: " + now + "\n" +
                  "・宛先: " + email + "\n" +
                  "・件名: " + subject;
    
    // ⑦ D列のセルにメモとして付与する!
    statusRange.setNote(logNote);
  }
  
  // ⑧ 完了ログ
  Logger.log("全件送信およびメモログの付与が完了しました!");
}

2. コードを1行ずつ丁寧に解説!

  • GmailApp.sendEmail(email, subject, body);
    • 第32回で学んだGmail送信メソッドです。指定したアドレスへメールを届けています。
  • statusRange.setValue("送信完了");
    • 第6回で学んだ命令ですね。D列の見た目としてはシンプルな「送信完了」の4文字だけが入ります。
  • Utilities.formatDate(new Date(), "JST", "yyyy/MM/dd HH:mm:ss");
    • 第29回で学んだ日付フォーマット関数です。現在日時を「2026/09/23 10:15:30」のように読みやすい形式に変換しています。
  • statusRange.setNote(logNote);
    • 本日の主役! 組み立てたログ文字列(logNote)を、D列のセルの「メモ」としてセットしています。

3. 保存して実行する

  1. エディタ上部の 「保存アイコン(フロッピーディスク)」 をクリックします。
  2. 実行する関数が sendEmailWithLogNote になっていることを確認し、「実行」 ボタンをクリックします。
  3. (初回実行時は権限承認ポップアップが出ますので許可してください)
  4. 処理が完了したらスプレッドシートの画面に戻り、結果を確認してみましょう!

【実行結果の確認】

  • D列(D2:D4)のセルに「送信完了」と入力されている!
  • D列のセルの右上部分に黒い小さな三角マーク(メモの目印)がついた!
  • D2セルにマウスカーソルを重ねると、黄色いポップアップが表示され、「送信日時」「宛先」「件名」が綺麗に改行されて表示された!

シートの見た目を汚さずに、必要なときにだけマウスホバーで詳細ログを確認できるスマートなツールになりましたね!

5. STEP3:実務で差がつく!setNote() の応用パターン3選

単にメモを貼るだけでなく、実務でよく使われる発展的な書き方を3つ押さえておきましょう。

応用①:既存のメモを消さずに「追記」する(getNote() + setNote())

setNote() は標準で「上書き(以前のメモを消して書き換える)」処理を行います。

過去の実行履歴やメモを残したまま末尾に追記したい場合は、第5回で学んだ getValue() のように、事前に getNote() で現在のメモを取得してから結合します。

function appendNoteExample() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  var range = sheet.getRange("D2");
  
  // 1. 現在セットされているメモを取得する
  var existingNote = range.getNote();
  
  // 2. 新しい追記ログを作成する
  var newLog = "【再送ログ】" + Utilities.formatDate(new Date(), "JST", "yyyy/MM/dd HH:mm:ss") + " 再度案内を送信";
  
  // 3. 既存のメモがあれば改行して結合、なければそのままセット
  var updatedNote = existingNote ? existingNote + "\n----------------\n" + newLog : newLog;
  
  // 4. メモを更新セット
  range.setNote(updatedNote);
}

応用②:条件(送信失敗・エラー)に応じてメモ内容とセル背景色を変える(Try…Catch 連携)

第30回で学んだ Try...Catch と組み合わせることで、「成功時は送信ログメモ」「失敗時はエラー原因のメモ+セルを赤色(第9回 setBackground)」という高度な判定処理が作れます。

function sendWithTryCatchLog() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  var range = sheet.getRange("D2");
  
  try {
    // メール送信処理
    GmailApp.sendEmail("invalid-email-address", "テスト", "本文");
    
    range.setValue("送信完了");
    range.setNote("送信日時: " + new Date());
  } catch (error) {
    // 送信失敗時の処理
    range.setValue("送信エラー");
    range.setBackground("#f4ccd3"); // 第9回:薄い赤色に塗る
    range.setNote("【エラー詳細】\n" + error.message); // エラー理由をメモに残す!
  }
}

エラーが起きた際、なぜ失敗したのか(メールアドレスの形式不正など)がメモを見れば一目瞭然になります!

応用③:メモを完全に消去(クリア)する(setNote("") または clearNote())

テストで貼ったメモや、再処理時に古いメモをリセットしたい場合は、空文字 "" をセットするか、第8回で少し紹介した clearNote() メソッドを使います。

function clearNoteExample() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  var range = sheet.getRange("D2:D4");
  
  // パターンA:空文字をセットして消す
  range.setNote("");
  
  // パターンB:専用メソッドでメモだけを一括クリアする(第8回参照)
  range.clearNote();
}

6. 初心者が絶対につまずく!5大トラップと完全対処法

Range.setNote() を使う際、プログラミング初心者やGAS学習者がよく遭遇するエラーやトラブルを5つ厳選しました。

トラップ1:setNote() と setNotes()(複数形)の押し間違い!

GASには、今回学ぶ setNote()(単数形)のほかに、setNotes()(複数形・最後にsがつく) というメソッドが存在します。

  • setNote("文字列")(単数形):1つのセル(または指定範囲全体)に単一の文字列をメモとしてセットする。
  • setNotes([["メモ1", "メモ2"]])(複数形):2次元配列を使って、複数セルにそれぞれ異なるメモが一括書き込みできる。

1つのセルに対して間違えて setNotes("メモ") と渡してしまうと、「Argument cannot be converted to Object[][](2次元配列ではありません)」というエラーが発生します。

トラップ2:sheet.setNote() と書いて TypeError になる

// ✕ エラーになる書き方
sheet.setNote("D2", "メモ内容");
// エラーメッセージ:TypeError: sheet.setNote is not a function

setNote() は Sheet(部屋)が持っている命令ではなく、Range(セル・家具)が持っている命令 です。

必ず sheet.getRange("D2").setNote("メモ内容") のように、「シート ➡ セル指定 ➡ メモ付与」 の順番を守って記述しましょう!

トラップ3:改行を入れたいのに \n を入れずに1行で潰れてしまう

メモの中に複数の情報を書き込む際、改行コードである \n(バックスラッシュ n または 円マーク n) を入れ忘れると、ログが1行にずらっとつながってしまい非常に読みづらくなります。

// ✕ 読みづらい書き方
var note = "送信日時: " + now + " 宛先: " + email + " 件名: " + subject;

// ◯ 見やすい書き方(\n で改行をはさむ)
var note = "送信日時: " + now + "\n宛先: " + email + "\n件名: " + subject;

トラップ4:setNote() は上書き処理!過去のメモが消える

前述の応用①でも触れた通り、setNote() は実行するたびにセルに既にあるメモを上書き消去して新しい内容に置き換えます。

「実行するたびにログをどんどん溜めていきたい」という場合は、必ず getNote() で元のメモを取得してから結合する処理を挟みましょう。

トラップ5:複数セル範囲(A1:B5)に setNote("共通") を使うと全セルに同じメモがつく

sheet.getRange("A1:B5").setNote("確認済み"); のように範囲指定して実行すると、指定したすべてのセルに全く同じメモが付与されます。

「セルごとに異なるメモをつけたい」という場合は、for ループの中で1セルずつ setNote() を実行するか、setNotes()(複数形+2次元配列)を使用しましょう。

7. 今回のまとめ&次回予告

今回は、セルに詳細な付箋ログを残せる Range.setNote() について徹底解説しました!

今日の重要ポイントおさらい

  1. Range.setNote("テキスト") はセルの右上に黄色い付箋メモをセットする命令
  2. 見た目のセル本文(setValue)を汚さずに、マウスホバーで詳細な送信ログやエラー理由を確認できる
  3. 改行を入れたいときは文字列の中に \n を挟む
  4. 既存のメモに残したい場合は getNote() で取得してから結合して setNote() する
  5. メモのみを消去したい場合は clearNote() または setNote("") を使う

これで、フェーズ4「Gmail連携・メール自動配信」(第31回〜第40回)の全10回が完結しました!

下書き作成から送信、自動検索、添付ファイル取り出し、既読化、ラベル付与、送信上限チェック、そして今回の送信ログメモ付与まで、メール業務自動化に必要なスキルが完璧に身につきましたね。