【GAS入門#77】Googleカレンダーに予定を自動作成!Calendar.createEvent() と createAllDayEvent() の使い方

前回(第76回)は、Googleカレンダー操作の第一歩として、CalendarApp.getCalendarById() を使って「札幌オフィス第1会議室カレンダー」などの特定のカレンダーを取得する方法を学びましたね!

「操作したいカレンダー(手帳)」をGASプログラムで準備できたら、次にやりたくなるのは「プログラムから自動でカレンダーに予定を書き込むこと」です。

  • 「スプレッドシートの会議日程リストから、Googleカレンダーへ一括で予定を登録したい」
  • 「定期的な『札幌オフィス月次報告会』の予定を自動で作成したい」
  • 「『札幌オフィス創立記念日』や『社内研修日』などの終日イベントを自動セットしたい」

手動でGoogleカレンダーを開いて1件ずつタイトルや時間を入力するのは、件数が増えるほど大変ですし、日時の入力ミスや重複登録の原因にもなります。

そこで第77回となる今回は、Googleカレンダーに予定を自動作成する2大必須メソッド Calendar.createEvent() と Calendar.createAllDayEvent() を徹底解説します!

北海道・札幌オフィスの実務(「月次報告会」の通常予定と「オフィス創立記念日」の終日予定)を題材に、コードの書き方から便利なオプション設定、初心者が絶対につまずくタイムゾーンや日付指定の罠まで、どこよりも分かりやすく解説していきます!

1. そもそも createEvent / createAllDayEvent とは?

GASでGoogleカレンダーに新しい予定を追加するとき、予定の種類(時間決めの予定か、1日中の予定か)によって以下の2つの命令(メソッド)を使い分けます。

メソッド名予定の種類主な用途指定する値(引数)
createEvent()通常予定(時間指定)ミーティング、来客対応、セミナー、打ち合わせなどタイトル, 開始日時, 終了日時
createAllDayEvent()終日予定(全日)創立記念日、祝日、出張日、終日研修、全社休業日などタイトル, 対象日付

システム手帳でイメージしてみよう!

本連載でおなじみの「家・部屋・家具」の例えや、身近なシステム手帳でイメージしてみましょう。

  • カレンダーオブジェクト(Calendar) = システム手帳そのもの
  • createEvent() = 手帳の「14:00〜15:30」の時間軸マス目にペンで予定を書き込む操作
  • createAllDayEvent() = 手帳の日付の1番上の「終日メモ欄」にマーカーで予定を書き込む操作

どちらも、取得した Calendar オブジェクトに対して呼び出すことで、Googleカレンダー上に新しいイベント(予定)をパッと作成してくれます。

2. STEP1:準備!操作するカレンダーを取得しよう

まずは第76回の復習として、予定を追加対象となるGoogleカレンダーをGASで取得しましょう。

今回は自分の「メイン(デフォルト)カレンダー」を使用するか、特定のアドレスで共有された「札幌オフィス第1会議室カレンダー」を使用します。

基本コード(カレンダーの取得)

// パターンA:自分自身のメインカレンダーを取得する場合
var calendar = CalendarApp.getDefaultCalendar();

// パターンB:IDを指定して特定のカレンダーを取得する場合(第76回の復習)
var calendar = CalendarApp.getCalendarById("sapporo-room1@example.com");

※今回のサンプルコードでは、手軽に試せる CalendarApp.getDefaultCalendar() を使用しますが、特定IDのカレンダーに変更しても全く同じように動作します。

3. STEP2:【実践1】時間指定の通常予定を作成する Calendar.createEvent()

それでは実際に、「札幌オフィス月次報告会」という時間指定の通常予定を作成してみましょう!

1. コードを入力する

Googleスプレッドシートや独立型GASのエディタを開き、以下のコードを貼り付けます。

function createMonthlyReportEvent() {
  // ① メインカレンダーを取得する(手帳を開く)
  var calendar = CalendarApp.getDefaultCalendar();
  
  // ② 予定の開始日時と終了日時(Dateオブジェクト)を用意する
  // 例:2026年10月15日の 14:00 〜 15:30
  var startTime = new Date("2026/10/15 14:00:00");
  var endTime = new Date("2026/10/15 15:30:00");
  
  // ③ 通常予定を作成する(タイトル, 開始日時, 終了日時)
  var event = calendar.createEvent("【札幌オフィス】月次報告会", startTime, endTime);
  
  // ④ 作成された予定のタイトルとIDをログに出力して確認する
  Logger.log("予定を作成しました!:「" + event.getTitle() + "」");
}

2. コードの1行ずつ詳細解説!

  • new Date("2026/10/15 14:00:00")
    • JavaScriptで「特定の年月日・時間」を扱うための Date(デイト)オブジェクト を作っています。
    • "YYYY/MM/DD HH:mm:ss" という形式の文字列を渡すだけで、直感的に指定の日時を作成できます。
  • calendar.createEvent(タイトル, 開始日時, 終了日時)
    • 第1引数に予定の件名(文字列)、第2引数に開始日時のDateオブジェクト、第3引数に終了日時のDateオブジェクトを渡します。
  • event.getTitle()
    • createEvent() は成功すると、作成された CalendarEvent(イベントオブジェクト) を返します。その .getTitle() メソッドを使うことで、正しく作成されたか件名を確認できます。

3. 保存して実行・確認する

  1. コードを保存(フロッピーアイコン)し、createMonthlyReportEvent を実行します。
  2. 初回の実行時にはアクセス承認ポップアップが出ますので、画面の案内に従ってアクセスを許可してください(第2回参照)。
  3. Googleカレンダーを開いてみましょう!2026年10月15日の14:00〜15:30 の枠に「【札幌オフィス】月次報告会」が自動で登録されていれば大成功です!

4. STEP3:【実践2】終日予定を作成する Calendar.createAllDayEvent()

次に、会議などの時間単位ではなく、1日全体にわたる予定(終日イベント)を作成してみましょう!

今回は「札幌オフィス創立記念日」を終日予定として登録します。

1. コードを入力する

function createAnniversaryEvent() {
  // ① メインカレンダーを取得する
  var calendar = CalendarApp.getDefaultCalendar();
  
  // ② 終日予定にしたい「日付」を用意する
  var anniversaryDate = new Date("2026/11/01");
  
  // ③ 終日予定を作成する(タイトル, 日付)
  var event = calendar.createAllDayEvent("札幌オフィス創立記念日", anniversaryDate);
  
  // ④ 実行確認ログを出力する
  Logger.log("終日予定を作成しました!:「" + event.getTitle() + "」");
}

2. ポイント解説!

  • calendar.createAllDayEvent(タイトル, 日付)
    • 時間(14:00など)を指定する必要はありません。new Date("2026/11/01") のように日付を指定するだけで、その日のカレンダー最上部(終日エリア)に予定が作成されます。

5. STEP4:複数日にわたる終日予定の作成

「札幌出張(11月10日〜11月12日の3日間)」のように、数日間にまたがる連続した終日イベントを作成したい場合もありますよね。

createAllDayEvent() は、引数を3つ渡すことで「期間(開始日〜終了日)」の終日予定を作成できます!

複数日終日イベントのコード例

function createMultiDayEvent() {
  var calendar = CalendarApp.getDefaultCalendar();
  
  // 開始日:2026年11月10日
  var startDate = new Date("2026/11/10");
  
  // 終了日:2026年11月13日(※ここが超重要な落とし穴!後述します)
  var endDate = new Date("2026/11/13");
  
  // 期間指定の終日予定を作成(タイトル, 開始日, 終了日)
  var event = calendar.createAllDayEvent("【出張】札幌出張&拠点視察", startDate, endDate);
  
  Logger.log("期間付き終日予定を作成しました!");
}

※「終了日」の指定方法にはプログラマ特有の超重要な注意点(罠)があります。STEP6のトラップ解説で詳しく紹介しますので、必ずチェックしてください!

6. STEP5:実務で差がつく!オプション引数(場所・詳細・招待者など)を設定しよう

タイトルと時間だけでなく、「会議室の場所」「Web会議のURL」「メモ(概要)」「参加メンバーの招待」などもまとめて登録したいですよね。

createEvent() や createAllDayEvent() の最後の引数に { オプション }(JavaScriptのオブジェクト形式) を渡すことで、詳細な情報を一度に設定できます!

実務で使える拡張コード例

function createDetailedMeetingEvent() {
  var calendar = CalendarApp.getDefaultCalendar();
  
  var startTime = new Date("2026/10/15 14:00:00");
  var endTime = new Date("2026/10/15 15:30:00");
  
  // オプション情報をまとめた連想配列(オブジェクト)を用意
  var options = {
    location: "札幌オフィス 第1会議室(および Google Meet)",
    description: "【議題】\n1. Q3実績報告\n2. 札幌オフィス設備更新について\n\n※遅れる場合はSlackの#generalへご連絡ください。",
    guests: "tanaka@example.com, sato@example.com", // カンマ区切りで招待者を指定
    sendInvites: true // 招待メールを自動送信する場合は true
  };
  
  // 第4引数に options を渡す!
  var event = calendar.createEvent("【札幌オフィス】月次報告会", startTime, endTime, options);
  
  Logger.log("詳細情報付きの予定を作成しました!ID: " + event.getId());
}

主なオプションプロパティ一覧

オプションキー型説明設定例
location文字列予定の「場所」を入力"札幌市中央区北1条... 第1会議室"
description文字列予定の「説明・メモ欄」を入力(改行は \n)"会議資料URL: https://..."
guests文字列招待するメンバーのメールアドレス(カンマ区切り)"user1@example.com, user2@..."
sendInvites真偽値招待者にメール通知を送るかどうかtrue(送る) / false(送らない)

7. 初心者が絶対につミスする「5大トラップ」と完全解決策

Googleカレンダー自動化で、初心者が直面しやすいトラブルとエラーの解決策を5つ厳選しました!

トラップ1:複数日の createAllDayEvent で最終日が1日足りない!

「11月10日〜11月12日の3日間」の予定を作りたいとき、以下のように書くと11月11日までの2日間しか登録されないという現象が発生します。

// ✕ 間違いの例(11/10〜11/11の2日間になってしまう!)
var startDate = new Date("2026/11/10");
var endDate = new Date("2026/11/12");
calendar.createAllDayEvent("札幌出張", startDate, endDate);

【原因と解決策】

createAllDayEvent(title, startDate, endDate) の endDate は 「その日の 00:00:00 まで(その日の開始時点まで)」 を意味します。つまり、「11月12日の0時まで」=「11月11日の終わりまで」となってしまうのです。

11月12日まで含めたい場合は、終了日に「11月13日(含めたい最終日の翌日)」を指定するのがGoogleカレンダーの仕様上の正解です!

// ◯ 正しい書き方(11/10, 11/11, 11/12 の3日間登録される)
var startDate = new Date("2026/11/10");
var endDate = new Date("2026/11/13"); // 最終日の翌日を指定!
calendar.createAllDayEvent("札幌出張", startDate, endDate);

トラップ2:JavaScriptの Date 指定で「月」が1ヶ月ズレる

JavaScriptの new Date(年, 月, 日) という数値指定の構文を使う際、プログラミングの「0始まり(0=1月, 1=2月… 11=12月)」ルールが適用されます。

// ✕ 間違い:10月15日のつもりが「11月15日」になってしまう!
var startTime = new Date(2026, 10, 15, 14, 0, 0); 

// ◯ 解決策①:文字列指定を使えば直感的に10月と書ける!(おすすめ)
var startTime = new Date("2026/10/15 14:00:00");

// ◯ 解決策②:数値指定の場合は「希望の月 - 1」を書く
var startTime = new Date(2026, 9, 15, 14, 0, 0); // 9が10月を意味する

間違いを防ぐためにも、初心者の方は new Date("YYYY/MM/DD HH:mm:ss") という文字列指定スタイルをおすすめします!

トラップ3:終了日時が開始日時より前になっているエラー

開始時間と終了時間を誤って逆に指定したり、同じ時間にしてしまうとエラーが発生します。

Exception: Invalid args: endDate cannot be before startDate
(訳:無効な引数です。終了日時を開始日時より前にすることはできません)

【解決策】

必ず endTime が startTime よりも未来の時間(1分以上後)になっているか、コードのロジックを確認してください。

トラップ4:タイムゾーンのズレで予定が9時間ズレて登録される

「14:00に登録したはずなのに、カレンダーを見ると朝の5:00に登録されている…」という場合、GASプロジェクトのタイムゾーン設定が「UTC(協定世界時)」になっている可能性があります。

【解決策】

  1. GASエディタの左メニューにある 「歯車マーク(プロジェクトの設定)」 をクリックします。
  2. 「appsscript.json 構文ファイルをエディタで表示する」にチェックを入れます。
  3. エディタに戻り appsscript.json を開き、"timeZone": "Asia/Tokyo" になっているか確認します(違っていたら修正して保存)。

トラップ5:書き込み権限がないカレンダーを指定してエラーになる

閲覧権限(予定の表示のみ)しか付与されていない共有カレンダーに対して createEvent() を実行すると、以下のような権限エラーが発生します。

Exception: You do not have permission to perform that action.
(訳:その操作を実行する権限がありません)

【解決策】

GoogleカレンダーのWeb画面を開き、対象のカレンダーの「設定と共有」から、あなたのアカウントに 「予定の変更権限」 または 「管理者権限」 が付与されているか確認してください。

8. まとめ&次回予告

今回は、Googleカレンダーに予定を自動作成する Calendar.createEvent() と Calendar.createAllDayEvent() を学びました!

今日の重要ポイントおさらい

  1. 時間指定の通常予定には createEvent(件名, 開始日時, 終了日時) を使う
  2. 終日の予定には createAllDayEvent(件名, 日付) を使う
  3. オプション引数 { location, description, guests } で詳細情報や会議室・招待者を一括設定できる
  4. 複数日の終日予定の終了日(endDate)は「最終日の翌日」を指定する
  5. 日時の指定は new Date("2026/10/15 14:00:00") の文字列形式が安全で分かりやすい

スプレッドシートのデータと組み合わせれば、数十件〜数百件の予定を一瞬でGoogleカレンダーへ登録する全自動ツールが作れるようになります!

次回(第78回)は、逆にGoogleカレンダーに登録されている予定をGASで読み出す Calendar.getEvents() を解説します!

カレンダーの空き状況チェックや、予定の自動集計に必須のテクニックですので、ぜひお楽しみに!