対象：初心者やエンジニアではないけど業務効率化でGASを書いている人

Google App Scirptを教えている時に、デバッグでログを表示するのに、いちいち

console.log(hoge);
Logger.log(hoge);

上記のコードを各所に仕込んで、いちいち変数の中身を表示している方がいました。
結構めんどくさいことしているなぁと思ったので、そういうやり方をしている人を撲滅しようと思います。

実運用でエラーが出た時のログを仕込みたい場合はこの限りではありません。
ぜひともログをたくさん仕込みましょう。

シート1

名前	        性別	  身長	     ホームページ
田中 太郎	男性	  175 cm	 https://tanaka.example.com
佐藤 花子	女性	  160 cm	 https://sato.example.com
鈴木 一郎	男性	  180 cm	 https://suzuki.example.com
高橋 直美	女性	  158 cm	 https://takahashi.example.com
伊藤 翔太	男性	  170 cm	 https://ito.example.com
山田 愛	    女性	  165 cm	 https://yamada.example.com
松本 大輔	男性	  178 cm	 https://matsumoto.example.com
小林 優子	女性	  162 cm	 https://kobayashi.example.com
斎藤 健	    男性	  173 cm	 https://saito.example.com
渡辺 美咲	女性	  159 cm	 https://watanabe.example.com

GAS

function myFunction() {
  const properties = PropertiesService.getScriptProperties();
  const spreadsheetId = properties.getProperty('SPREADSHEET_ID');
  
  const sheetName = 'シート1';
  
  // スプレッドシートとシートを取得
  const sheet = SpreadsheetApp.openById(spreadsheetId).getSheetByName(sheetName);
  
  // データ範囲を取得
  const dataRange = sheet.getDataRange();
  const data = dataRange.getValues();
  
  // ログに出力
  for (let i = 0; i < data.length; i++) {
    Logger.log('名前: ' + data[i][0] + ', 性別: ' + data[i][1] + ', 身長: ' + data[i][2] + ', ホームページ: ' + data[i][3]);
  }
}

開発中、変数の中身がどうなっているか console や Logger を使わって確認することがあるでしょう。
これをGASの標準機能の「デバッグ」を使って確認するようにしましょう。

想定ケース1：sheetの読み込みが出来ていない！

例えば以下のようなエラーが出たとします。

Exception: Unexpected error while getting the method or property openById on object SpreadsheetApp.
myFunction	@ コード.gs:8

どうやら以下のsheetの読み込みでエラーが出ているようです。

8行目

const sheet = SpreadsheetApp.openById(spreadsheetId).getSheetByName(sheetName);

ここでいつものあなたなら、sheetの変数代入の前に、

console.log(spreadsheetId, sheetName);
// or Logger.log(spreadsheetId, sheetName);

としていたことですが、デバッグ機能を使ってみましょう。
本来ログを出力したかった行番号のすぐ左をクリックすると、紫色のポチがつきます。

その後に、実行ボタンのすぐ右にある「デバッグ」ボタンを押しましょう。
すると右にデバッガが開き、その地点まで呼び出された変数のリストも一緒に表示されます。
出力したかった、spreadsheetId と sheetName もきちんと表示されています。

どうやらSPEADSHEET_IDが変な文字列になっていたようです。
ということで修正してめでたしです。
GASの開発の際にわざわざ conosle だったり Logger を使う必要はないのを理解してもらえましたか？

ケース2: 処理の流れを確認する

新たに「身長170cm以上の人の列の背景色を黄色にする」という要件を追加します。
以下のコードを追加しました。

背景色を追加

function highlightTallPeople() {
  const properties = PropertiesService.getScriptProperties();
  const spreadsheetId = properties.getProperty('SPREADSHEET_ID');
  
  const sheetName = 'シート1';
  
  const sheet = SpreadsheetApp.openById(spreadsheetId).getSheetByName(sheetName);
  
  // データ範囲を取得
  const dataRange = sheet.getDataRange();
  const data = dataRange.getValues();
  
  // 行数と列数を取得
  const numRows = dataRange.getNumRows();
  const numCols = dataRange.getNumColumns();
  
  // 背景色を設定するための範囲を初期化
  const rangeToHighlight = [];
  
  // データをループし、身長が170cmを超える行を見つける
  for (let i = 1; i < numRows; i++) { // i = 1 から始めるのは、ヘッダー行をスキップするため
    const height = data[i][2];
    // "cm"を取り除いて数値に変換
    const heightValue = parseInt(height.replace(' cm', ''));
    
    if (heightValue >= 170) {
      // ハイライトする行を範囲に追加
      rangeToHighlight.push(i);
    }
  }
  
  // ハイライトする範囲に背景色を設定
  rangeToHighlight.forEach(function(row) {
    sheet.getRange(row, 1, 1, numCols).setBackground('yellow');
  });
}

これを実行すると以下のようになりました。

ヘッダーに黄色が来たり、要件通りになっていない。これは困りました。
GASでスプレッドシートを扱う際にインデックスの取り扱いでこんがらがるの、あるあるですね。

条件分岐がうまく行ってるのか確かめるために、 if のところでブレイクポイントを貼ってみましょう。

ブレイクポイント

    if (heightValue >= 170) {
// → ここで貼ってみる
      rangeToHighlight.push(i);
    }

170cm以上判定はできていそうです。
次のループも見てみたいので、デバッガの|▶︎ みたなボタンを押します。これを押すと処理が再開します。ループが続く限り同じ箇所でまた処理が止まります。

このまま続けていきましたが、身長判定は正しくできていそうです。
では色を塗る場所がおかしいと見て、ブレイクポイントを設定します。

すると、getRange のrowが 1 になっているのが確認できます。 getRange は行/列番号で場所判定するので、1,1だとヘッダーに色が入ってしまいます。

ということで、以下の箇所がおかしかったので修正します。

ブレイクポイント

    if (heightValue >= 170) {
      rangeToHighlight.push(i+1); // シートの行は1から始まるため、インデックスを1加える
    }

そして実行すると、正しく背景色がセットされました。

このようにデバッグして、時間節約していきましょう。

GAS開発のデバッグログは Logger / consoleを使わないで、デバッグ機能を使おう。

想定ケース1：sheetの読み込みが出来ていない！

ケース2: 処理の流れを確認する