文法編2：各アプリの階層と記述法

スプレッドシート操作は、GAS学習の中心です。 ただし、GASは最初からセルを直接扱うわけではなく、 まずスプレッドシート全体、その中のシート、その中の範囲という順番で対象を絞っていきます。

// A1〜C10のデータを一気にとってくる書き方
const data = sheet.getRange("A1:C10").getValues();

// 2行目の3列目(C2)に書き込む書き方
sheet.getRange(2, 3).setValue("完了");

Gmailは、1通ずつ完全に独立しているように見えて、 実際には「会話のまとまり」であるスレッド単位で整理されています。 そのため、読む時もラベルを付ける時も、スレッドを意識する場面が多くあります。

// 送信の基本（宛先, 件名, 本文）
GmailApp.sendEmail("to@ex.com", "件名", "本文");

// 下書き作成（安全なテスト用）
GmailApp.createDraft("to@ex.com", "下書き", "確認中");

Drive操作では、「どこにあるか」が特に重要です。 同じ名前のファイルやフォルダが複数存在することがあるため、 実務では名前よりも ID を使って対象を特定する方が確実です。

// IDでフォルダを捕まえる
const folder = DriveApp.getFolderById("ID文字列");

// その中にファイルを作る
folder.createFile("2026_memo.txt", "内容");

Calendarでは、「どのカレンダーの」「どの期間の予定か」を指定する考え方が重要です。 スプレッドシートが場所を意識するのに対して、 カレンダーは時間範囲を意識するサービスだと考えると理解しやすくなります。

// 今日の全予定を取得する書き方
const today = new Date();
const events = CalendarApp.getEventsForDay(today);

// タイトル、開始、終了を指定して作成
CalendarApp.createEvent("MTG", startTime, endTime);

DocumentApp では、ドキュメント本体と本文が分かれています。 そのため、ただドキュメントを開いただけでは文字を書き込めず、 本文に対して段落や表を追加する必要があります。

// 本文(Body)を取得してから操作する
const body = DocumentApp.getActiveDocument().getBody();

// 本文内のテキストを置換する強力な命令
body.replaceText("{name}", "田中様");