カレンダーへ予定を自動登録したり、メンバーを招待したりできるようになると、次に必ず直面するのが「予定の変更やキャンセルに伴う、旧予定の消し忘れ・重複問題」です。
「ミーティングの日時が変更になったのに、カレンダーに古い予定が残ったままで会議室がダブルブッキングしてしまった…」
「急きょキャンセルになった打合せの予定が残っていて、チームのスケジュールが見づらくなっている…」
手動で1つずつカレンダーを開いてゴミ箱アイコンをクリックして削除するのは面倒ですし、消し忘れによるヒューマンエラーも起こりやすくなります。
そこで第80回となる今回は、Googleカレンダー上の不要な予定や重複した旧予定を、プログラムから一瞬で自動キャンセル・削除できる必須メソッド CalendarEvent.deleteEvent() を徹底解説します!
今回も「札幌オフィス第1会議室カレンダー」を舞台に、基本の使い方から実務で役立つ応用例、初心者が必ずハマる落とし穴と安全対策まで、どこよりも分かりやすく解説していきますね!
1. そもそも CalendarEvent.deleteEvent() とは?
CalendarEvent.deleteEvent() は、取得した個別の予定(CalendarEvent オブジェクト)に対して実行することで、その予定をGoogleカレンダー上から完全削除(キャンセル)する命令(メソッド)です。
「カレンダーアプリ・カレンダー・予定」の階層構造で理解しよう!
第2回〜第4回で「家(ファイル)・部屋(シート)・家具(セル)」という階層構造を学びましたね。Googleカレンダーの操作でも、全く同じ考え方の階層構造が存在します。
- 【アプリ全体】=
CalendarApp
Googleカレンダーの機能全体を管理する親玉です。 - 【カレンダー(部屋)】=
Calendar(第76回で学習)
「札幌オフィス第1会議室カレンダー」や「自分のメインカレンダー」など、特定のカレンダー枠そのものを指します。 - 【予定カード(家具)】=
CalendarEvent(第77回〜第79回で学習)
カレンダー内に配置された1つひとつの「月次報告会」や「週次ミーティング」といった個別イベントのことです。
[ CalendarApp (アプリ全体) ]
↓
[ Calendar (カレンダー本体) ] ← 例: 札幌オフィス第1会議室
↓
[ CalendarEvent (個別の予定) ] ← ★今回の操作対象!
今回扱う CalendarEvent.deleteEvent() は、まさにこの「予定カード(CalendarEvent)をゴミ箱に捨てる/シュレッダーにかけて破棄する」操作にあたります。
基本的なコードの構文
// 1. カレンダーから目的の予定(CalendarEvent)を取得する
var events = calendar.getEvents(startTime, endTime);
var event = events[0]; // 最初の予定を選択
// 2. 取得した予定を削除する!
event.deleteEvent();
Calendar(カレンダー本体) ではなく、CalendarEvent(個別の予定) に対して呼び出すのが最大のポイントです。
2. STEP1:準備!「札幌オフィス第1会議室」とテスト用予定を用意しよう
それでは、実際にGASから予定を削除する練習用の環境を作っていきましょう!
手順
- Googleカレンダーを開く
ブラウザで Googleカレンダー を開きます。 - カレンダーIDを確認する(第76回の復習)
操作したいカレンダー(例:「札幌オフィス第1会議室」やテスト用カレンダー)の「設定と共有」を開き、「カレンダーの統合」欄にある カレンダー ID(例:c_xxxxxxx@group.calendar.google.com)をコピーしておきます。※ご自身のマイカレンダー(メインカレンダー)で試す場合は、カレンダーIDの代わりにCalendarApp.getDefaultCalendar()を使ってもOKです! - テスト用の予定をカレンダーに登録する
動作確認用に、本日の日付に以下の3つの予定を手動(または第77回のコード)で作成しておきましょう。
| 予定タイトル | 時間帯 | 状態 |
| 【旧】札幌チーム週次ミーティング | 本日 10:00 〜 11:00 | 削除したい旧予定 |
| 【確定】札幌チーム週次ミーティング | 本日 11:00 〜 12:00 | 残したい最新予定 |
| 【旧】札幌オフィス設備点検 | 本日 14:00 〜 15:00 | 削除したい旧予定 |
準備ができたら、スプレッドシートのメニューバー「拡張機能」>「Apps Script」からエディタ画面を開いておきましょう!
3. STEP2:【実践】重複・不要になった「旧ミーティング予定」を自動削除してみよう!
準備が整ったら、本日の予定の中からタイトルに「【旧】」と書かれた不要なミーティング予定だけを自動で見つけて削除するプログラムを書いていきましょう!
1. コードを入力する
GASのエディタ画面にあるコードをすべて消去し、以下のコードを貼り付けます。
function deleteOldMeetings() {
// ①「札幌オフィス第1会議室カレンダー」をIDで取得する(第76回)
var calendarId = "YOUR_CALENDAR_ID@group.calendar.google.com"; // ★ご自身のカレンダーIDに変更してください
var calendar = CalendarApp.getCalendarById(calendarId);
// ② 本日1日分の検索範囲を設定する
var now = new Date();
var startTime = new Date(now.getFullYear(), now.getMonth(), now.getDate(), 0, 0, 0);
var endTime = new Date(now.getFullYear(), now.getMonth(), now.getDate(), 23, 59, 59);
// ③ 本日の予定一覧を配列として取得する(第78回)
var events = calendar.getEvents(startTime, endTime);
Logger.log("本日の予定件数: " + events.length + "件");
// ④ 取得した予定を1つずつループしてチェックする
for (var i = 0; i < events.length; i++) {
var event = events[i];
var title = event.getTitle(); // 予定のタイトルを取得
// タイトルに「【旧】」という文字が含まれているか判定
if (title.indexOf("【旧】") !== -1) {
Logger.log("【削除対象を発見】: " + title);
// ★本日の主役!カレンダーから予定を削除する
event.deleteEvent();
Logger.log(" └ 予定を正常にキャンセル削除しました!");
} else {
Logger.log("【保持】: " + title);
}
}
}
2. コードを1行ずつ徹底解説!
var calendar = CalendarApp.getCalendarById(calendarId);
第76回で学んだ命令です。指定したIDのカレンダーオブジェクト(部屋)を取得しています。var events = calendar.getEvents(startTime, endTime);
第78回で学んだ命令です。本日一日の範囲(0:00〜23:59)に存在する予定を配列形式([event1, event2, ...])でまとめて取得しています。for (var i = 0; i < events.length; i++) { ... }
配列に入っている予定を1つずつ順番に取り出して処理するループ文です。if (title.indexOf("【旧】") !== -1)indexOf()は文字列の中に特定のキーワードが含まれているかを検索するJavaScriptの機能です。「【旧】」が含まれていれば-1以外の数値が返るため、削除対象だと判定できます。event.deleteEvent();
本日一番の重要ポイントです!判定条件に合致したCalendarEventオブジェクトに対して.deleteEvent()を実行することで、Googleカレンダーからその予定を一発削除します。
3. 保存して実行する
- コード内の
YOUR_CALENDAR_ID@group.calendar.google.comをご自身のカレンダーIDに書き換えます。 - エディタ上部の 「保存(フロッピーディスクマーク)」 を押し、関数を
deleteOldMeetingsに合わせて 「実行」 をクリックします。 - (初回実行時はGoogleカレンダーへのアクセス権限の承認ポップアップが出ますので許可してください)
4. 実行結果の確認
エディタ下部の「実行ログ」に以下のように表示されれば大成功です!
情報 本日の予定件数: 3件
情報 【削除対象を発見】: 【旧】札幌チーム週次ミーティング
情報 └ 予定を正常にキャンセル削除しました!
情報 【保持】: 【確定】札幌チーム週次ミーティング
情報 【削除対象を発見】: 【旧】札幌オフィス設備点検
情報 └ 予定を正常にキャンセル削除しました!
Googleカレンダーの画面に戻って確認してみましょう!
「【旧】札幌チーム週次ミーティング」と「【旧】札幌オフィス設備点検」がキレイに削除され、「【確定】札幌チーム週次ミーティング」だけが残っているはずです。
プログラムによって不要な予定だけが正確にキャンセル削除されましたね!
4. STEP3:実務で差がつく!deleteEvent() の応用パターン3選
deleteEvent() は、単に特定のタイトルを消すだけでなく、スプレッドシートや外部データと連携させることで実務の自動化に絶大な効果を発揮します。よく使う3つの応用パターンを見ておきましょう!
応用①:「【キャンセル】」や「【不要】」など複数キーワードを一括削除
タイトルに複数の特定キーワードが含まれている場合にまとめて削除するパターンです。
function deleteCanceledEvents() {
var calendar = CalendarApp.getDefaultCalendar();
var now = new Date();
var future = new Date(now.getTime() + (7 * 24 * 60 * 60 * 1000)); // 7日後まで
var events = calendar.getEvents(now, future);
events.forEach(function(event) {
var title = event.getTitle();
// 「キャンセル」または「延期」が含まれる予定を削除
if (title.includes("【キャンセル】") || title.includes("【延期】")) {
event.deleteEvent();
Logger.log("削除完了: " + title);
}
});
}
応用②:スプレッドシートの「予約キャンセル一覧」と連動してカレンダーから自動削除
スプレッドシートに入力されたキャンセル申請データ(例:第13回 Range.getValues() で取得)を読み込み、該当する予定をカレンダーから自動で削除する実用的な連携パターンです。
function syncCancellationsFromSheet() {
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var values = sheet.getDataRange().getValues(); // シート全データを取得
var calendar = CalendarApp.getCalendarById("YOUR_CALENDAR_ID@group.calendar.google.com");
// 2行目以降(データ行)をループ処理
for (var i = 1; i < values.length; i++) {
var status = values[i][3]; // D列: ステータス(「キャンセル希望」など)
var eventTitle = values[i][1]; // B列: 予約タイトル
if (status === "キャンセル希望") {
// 本日の対象予定を検索して削除
var events = calendar.getEventsForDay(new Date());
events.forEach(function(event) {
if (event.getTitle() === eventTitle) {
event.deleteEvent(); // カレンダーから削除
sheet.getRange(i + 1, 4).setValue("削除完了"); // 第6回のsetValueでステータス更新!
}
});
}
}
}
応用③:予定削除時に「メール通知」を自動送信して誤削除を防ぐ
予定を自動削除する際、関係者や自分宛てに「○時〜の予定をキャンセル削除しました」と第32回で学んだ GmailApp.sendEmail() でメール通知を送ることで、安全な運用が可能になります。
// 予定削除と同時にメールで報告するテクニック
event.deleteEvent();
GmailApp.sendEmail("sapporo-admin@example.com", "【自動通知】カレンダー予定削除完了", "以下の予定を自動削除しました:\n" + title);
5. 初心者が絶対につまずく!4大トラップと完全対処法
CalendarEvent.deleteEvent() を使う際、プログラミング初心者やGAS学習者が非常によく直面するエラーやトラブルを4つ厳選しました。あらかじめ知っておくことで、無駄なトラブルを回避できますよ!
トラップ1:calendar.deleteEvent() と書いて TypeError になる
初心者事故率No.1のミスです!
// ✕ NG:Calendar(カレンダー本体)に対して呼び出してしまう
var calendar = CalendarApp.getCalendarById(id);
calendar.deleteEvent(); // エラー発生! TypeError: calendar.deleteEvent is not a function
// ◯ OK:CalendarEvent(個別の予定)に対して呼び出す
var events = calendar.getEvents(start, end);
events[0].deleteEvent();
【原因と解決策】
deleteEvent() は Calendar(部屋) ではなく CalendarEvent(個別の予定カード) が持っている命令です。
「どの予定カードを削除するのか」を指定するために、必ず getEvents() などで取得した個別の CalendarEvent オブジェクトに対して実行しましょう。
トラップ2:繰り返し予定(定期イベント)の削除挙動に注意!
毎週月曜日に繰り返し設定されている「定期ミーティング」などの予定に対して deleteEvent() を実行すると、デフォルトでは「その日1回分のイベントだけ」が削除されます。
event.deleteEvent():選択した1回分の予定のみ削除(前後の週の予定は残る)event.getEventSeries().deleteEventSeries():繰り返し予定の「シリーズ全体(全日程)」を一括削除したい場合は、こちらのEventSeriesメソッドを使います。
目的(1回だけのキャンセルなのか、定期開催そのものの廃止なのか)に合わせて使い分けましょう!
トラップ3:権限(アクセス権)不足で「You do not have permission」と怒られる
自分以外のユーザーが所有する共有カレンダーや、閲覧権限(「予定の表示のみ」)しか付与されていないカレンダーの予定を削除しようとすると、アクセス権限エラーが発生します。
【解決策】
GASで予定を削除・操作するには、対象のカレンダーに対して「変更権限」または「権限の管理および変更権限」が必要です。Googleカレンダーの設定画面から権限設定を確認しておきましょう。
トラップ4:間違えて必要な予定まで全消去してしまう恐怖!(Ctrl + Z は効かない)
GASの処理全般に言える最大の注意点ですが、プログラムで削除したカレンダーの予定は Ctrl + Z(元に戻す)では復元できません!
条件指定が間違っていて「本日の重要な来客予定まで全部消えてしまった…」という悲劇を防ぐため、以下の「ドライラン(事前テスト)」手法を必ず実践しましょう。
【おすすめ安全対策:ドライラン(テスト実行)】
最初は event.deleteEvent() の行をコメントアウト(頭に // をつける)しておき、Logger.log() の表示だけで「本当に削除したい予定だけが判定されているか」を事前に確認する癖をつけましょう!
// 安全確認コードの例
if (title.indexOf("【旧】") !== -1) {
Logger.log("【テスト実行】削除される予定: " + title);
// event.deleteEvent(); // ←最初はコメントアウトしてログだけ確認!
}
ログを確認して問題がないと確信できてから、コメントアウト(//)を外して本番実行するのがプロのエンジニアも行う鉄則です!
6. 今回のまとめと次回予告
今回は、Googleカレンダー上の重複・不要な予定を自動削除する CalendarEvent.deleteEvent() について解説しました。
今日の重要ポイントおさらい
deleteEvent()はCalendarEvent(個別の予定)に対して呼び出す命令getEvents()で予定一覧を取得し、forループとタイトル判定(indexOf)を組み合わせて目的の予定を特定する- スプレッドシートのキャンセルリスト(
getValue)やメール送信(sendEmail)と組み合わせることで完全自動化が可能になる - GASで削除した予定は元に戻せないため、実行前に
Logger.log()で確認する「ドライラン」を行う
これで、フェーズ8「Googleカレンダー連携編(第76回〜第80回)」がすべて完了しました!
カレンダーの取得・作成・一覧取得・メンバー招待・削除までマスターしたあなたは、もうGoogleカレンダー自動化のプロフェッショナルです!
🚀 次回予告:フェーズ9「Webアプリ化編」スタート!
次回からは、いよいよ本連載のクライマックスの一つである 「フェーズ9:Webアプリ化編(第81回〜第90回)」 へ突入します!
これまでスプレッドシートやGASのエディタ画面で動かしていたプログラムを、ブラウザで誰もが使える「Webアプリケーション(画面)」に進化させていきます。
記念すべき第81回は、doGet(e) × 「札幌オフィス統合ダッシュボードWebアプリ」を開く入口を作成 をお届けします!
ブラウザのURLにアクセスしたときに画面(HTML)を表示させるための最も重要な基本関数 doGet(e) の仕組みを、わかりやすく紐解いていきます。自分だけのオリジナルWebシステムを作る第一歩となりますので、ぜひ楽しみに待っていてくださいね!
