GASドリル（実装演習）

function dailyReport() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("売上");
  const total = sheet.getRange("C2:C").getValues()
    .reduce(function (sum, row) { return sum + (Number(row[0]) || 0); }, 0);
  MailApp.sendEmail("[email protected]", "日次売上", "現時点の合計: " + total);
}

function setup() {
  // この setup を一度だけ手動実行すると、以後は毎日9時台に dailyReport が自動実行される
  ScriptApp.newTrigger("dailyReport")
    .timeBased()
    .atHour(9)
    .everyDays(1)
    .create();
}

ポイント：定期実行は インストーラブルトリガー（ScriptApp.newTrigger）。timeBased().atHour(9).everyDays(1) で毎日9時台に走ります。atHour は「その時間台」の意味で、分単位の厳密指定ではありません。トリガーは setup を一度実行して登録します（毎回作るとトリガーが増殖するので注意）。

function onFormSubmit(e) {
  const values = e.values;     // [タイムスタンプ, メール, 名前]
  const email = values[1];
  const name = values[2];
  MailApp.sendEmail(email, "受付完了", name + " 様\n回答を受け付けました。");
}

ポイント：e.values には1行ぶんの回答が 列の並び順 で配列として入ります。メール送信を伴うため、これは インストーラブルトリガー として登録します（単純トリガーの onFormSubmit では送信できません）。登録は、エディタ左の ［トリガー］→［トリガーを追加］ で、実行する関数に onFormSubmit・イベントの種類に 「フォーム送信時」 を選びます（コードからは ScriptApp.newTrigger("onFormSubmit").forSpreadsheet(SpreadsheetApp.getActive()).onFormSubmit().create()）。

function saveKey() {
  // 一度だけ実行してキーを保存（コードには値を残さず、後で消してよい）
  PropertiesService.getScriptProperties().setProperty("API_KEY", "ここに実際のキー");
}

function useKey() {
  const key = PropertiesService.getScriptProperties().getProperty("API_KEY");
  const res = UrlFetchApp.fetch("https://api.example.com/data", {
    headers: { Authorization: "Bearer " + key }
  });
  Logger.log(res.getContentText());
}

ポイント：PropertiesService.getScriptProperties() はスクリプトに紐づくキー値ストア。API キーやパスワードは コードに直書きせず ここに保存し、getProperty で取り出します。これで共有・公開してもコード中に機密が残りません。

function safeRun() {
  try {
    riskyTask();
  } catch (err) {
    MailApp.sendEmail("[email protected]", "処理エラー", String(err));
    // 必要なら再スローして実行ログにも残す: throw err;
  }
}

ポイント：自動実行（トリガー）は画面に張り付いていないため、try/catch で失敗を捕まえ、通知や記録に回すのが定石です。String(err) でエラー内容を文字列化して本文に入れます。握りつぶすだけにせず、通知やログを必ず伴わせましょう。

function processBatch() {
  const props = PropertiesService.getScriptProperties();
  const start = Number(props.getProperty("cursor") || 2); // 既定は2行目から
  const sheet = SpreadsheetApp.getActiveSheet();
  const last = sheet.getLastRow();
  if (start > last) { props.deleteProperty("cursor"); return; } // 完了

  const SIZE = 100;
  const end = Math.min(start + SIZE - 1, last);
  const rows = sheet.getRange(start, 1, end - start + 1, 1).getValues();
  rows.forEach(function (row) {
    // ここで1件ぶんの処理
  });

  if (end < last) {
    props.setProperty("cursor", String(end + 1)); // 続きの位置を保存
  } else {
    props.deleteProperty("cursor");                // 最後まで終わった
  }
}

ポイント：実行時間の上限を超えそうな処理は、一定件数ずつに区切り、進捗（次に処理する行）を PropertiesService に保存します。時間主導トリガーで processBatch を定期実行すれば、毎回「続きから」少しずつ進められます。上限の詳細は 公式のクォータ を参照。