GASでスプレッドシートの
セルにメモ（ノート）を設定・取得する方法

function addNote() {
  const ss = SpreadsheetApp.getActive();
  const sheet = ss.getSheetByName("在庫一覧");

  // B2セルにメモ（ノート）を付ける
  // セルの右上に黒い三角が付き、ホバーで吹き出しが出る
  sheet.getRange("B2").setNote("2026-07-23 棚卸しで数量を修正");

  // 値そのものは変わらない。メモは注釈として別に保持される
}

function readAndAppendNote() {
  const ss = SpreadsheetApp.getActive();
  const sheet = ss.getSheetByName("在庫一覧");
  const cell = sheet.getRange("B2");

  // 既存のメモを読み取る（メモが無ければ空文字 "" が返る）
  const current = cell.getNote();
  Logger.log("現在のメモ: " + current);

  // 既存のメモを消さずに、改行して追記する
  const stamp = Utilities.formatDate(new Date(), "Asia/Tokyo", "MM/dd HH:mm");
  const line = stamp + " 自動チェック済み";
  cell.setNote(current ? current + "\n" + line : line);
}

// 範囲全体のメモを二次元配列で一括設定する（1セルずつより速い）
function setNotesInBulk() {
  const ss = SpreadsheetApp.getActive();
  const sheet = ss.getSheetByName("在庫一覧");

  // 対象はデータ本体（見出しを除いた A2:C4 の3行3列とする）
  const range = sheet.getRange(2, 1, 3, 3);
  const values = range.getValues();

  // 値と同じ行数・列数のメモ配列を作る。メモ不要なセルは空文字
  const notes = values.map((row) => {
    const stock = Number(row[2]); // C列: 在庫数とする
    return [
      "",                                   // A列: メモなし
      "",                                   // B列: メモなし
      stock < 10 ? "在庫が少なめ。発注を検討" : "", // C列だけ条件付きでメモ
    ];
  });

  // 二次元配列を一度に書き込む（範囲の行数・列数と一致させる）
  range.setNotes(notes);
}

// すべてのメモを読み取り、付いているセルだけ一覧にする
function listAllNotes() {
  const ss = SpreadsheetApp.getActive();
  const sheet = ss.getSheetByName("在庫一覧");

  const range = sheet.getDataRange();
  const notes = range.getNotes(); // 各セルのメモの二次元配列
  const startRow = range.getRow();
  const startCol = range.getColumn();

  const found = [];
  notes.forEach((row, r) => {
    row.forEach((note, c) => {
      if (note === "") return; // メモが無いセルはスキップ
      const cellA1 = sheet.getRange(startRow + r, startCol + c).getA1Notation();
      found.push(cellA1 + " : " + note.replace(/\n/g, " / "));
    });
  });

  Logger.log(found.length ? found.join("\n") : "メモはありません");
}

function clearNotes() {
  const ss = SpreadsheetApp.getActive();
  const sheet = ss.getSheetByName("在庫一覧");

  // 1セルのメモを消す
  sheet.getRange("B2").clearNote();

  // 空文字を渡してもメモは消える（setNote("") と clearNote() は同じ結果）
  sheet.getRange("C2").setNote("");

  // 範囲をまとめて消す。値・書式は残り、メモだけがリセットされる
  sheet.getRange("A2:C100").clearNote();
}

// 入力チェックの結果を、値は変えずにメモとして各行に残す
function annotateValidation() {
  const ss = SpreadsheetApp.getActive();
  const sheet = ss.getSheetByName("申込一覧");

  // A:氏名 B:メール C:金額 の3列。見出しを除いたデータを取得
  const last = sheet.getLastRow();
  if (last < 2) return;
  const range = sheet.getRange(2, 1, last - 1, 3);
  const values = range.getValues();

  const notes = values.map((row) => {
    const [name, email, amount] = row;
    const errors = [];
    if (!name) errors.push("氏名が空です");
    if (!/^[^@\s]+@[^@\s]+$/.test(String(email))) errors.push("メール形式が不正");
    if (!(Number(amount) > 0)) errors.push("金額が0以下");

    const msg = errors.length ? "要確認: " + errors.join(" / ") : "";
    // 行の先頭セル（A列）にだけ結果メモを置く。他の列は空文字
    return [msg, "", ""];
  });

  range.setNotes(notes);
}