GASで複数のスプレッドシートを集約：列は見出しの名前で探す

Google Apps Script（GAS。スプレッドシートなどを動かす Google のプログラム）で複数のスプレッドシートを集約する時は、列を位置（C列、F列）ではなく、見出しの名前で探すのが答えです。列の位置で読むと、誰かが列を1つ足しただけで右の数字が全部ずれ、しかもエラーにならないからです。

私たちのグループでは、7つの店舗がそれぞれ自分のスプレッドシートで、日々の記録を付けています。これを Google Apps Script（GAS。Google のスプレッドシートなどを動かすプログラム）で1つにまとめ、全店の数字を並べて見られるようにしています。

まとめる仕組みを作る時に、一番気をつけたのは「列の探し方」です。列の位置で読むと、店舗の誰かが列を1つ足しただけで、数字がずれてしまいます。この記事は、見出しの名前で列を探す作りにした理由と、ほかに決めたことの記録です。

7店舗のシートを、集約の GAS が見出しの名前で列を探して読み、まとめた表を毎晩全部書き直す。集客の経路の分け方は、設定のシートで決める — 集約の流れ。列は位置ではなく、見出しの名前で探す

GAS で列の位置で読むと、何が起きるか

GAS でシートを読む時、いちばん簡単なのは「C列が日付、F列が金額」のように、列の位置を決め打ちにすることです。

方眼の紙の上に、水色の鉛筆が置かれた写真 — 列は、位置ではなく見出しの名前で探す（イメージ写真）

7店舗もあると、すべての店舗のシートの形を、ずっと同じに保ってもらうのは現実的ではありません。

列を位置で読むと、メモの列を1つ足しただけで金額の列に別の値が入る。見出しの名前で探すと、正しい金額を読める、という比較の図 — メモの列を足した時の、2つの読み方の違い

見出しの名前で、列を探す

Google Apps Script見出しの名前で列を探す（仕組みが分かる短い見本）

function readRows(sheet, names) {
  const values = sheet.getDataRange().getValues();
  const header = values[0].map(String).map(s => s.trim());
  const index = {};
  for (const name of names) {
    const i = header.indexOf(name);
    if (i < 0) throw new Error(sheet.getName() + ' に「' + name + '」の列がありません');
    index[name] = i;
  }
  return values.slice(1).map(row => {
    const obj = {};
    for (const name of names) obj[name] = row[index[name]];
    return obj;
  });
}