カレンダーの削除

Google Apps Script には、Google カレンダーを操作するためのライブラリであるCalendarAppクラスが標準で組み込まれています。

ここではCalendarAppクラスを使用して、対象アカウントから特定のカレンダーを削除する方法を解説します。

GAS から Google カレンダーにアクセスすることになるため、初回実行時に権限の設定が必要になります。

前提条件

カレンダーの削除にあたって、対象となるカレンダーを取得する必要があります。

以下は取得方法の一例です。

カレンダーIDからカレンダーを取得

const CALENDAR_ID = '___取得するカレンダーのID___';

/** @type { CalendarApp.Calendar | null }  */
const calendar = CalendarApp.getCalendarById(CALENDAR_ID);

カレンダーを取得する方法の詳細については、カレンダーの取得をご覧ください。

使用する関数

カレンダーの削除には、以下の関数を使用します。

関数の詳細

Calendar.deleteCalendar();

Calendarクラスに用意されている、deleteCalendarメソッドを使用します。

カレンダーは完全に削除され、元に戻すことはできません。削除できるのは、実行ユーザーが所有しているカレンダーだけです。また、インポートしたカレンダーに対して実行するとエラーになります。

返り値はありません。

サンプルコード

カレンダーを削除する

const CALENDAR_ID = '___削除するカレンダーのID___';

function myFunction() {
  const calendar = CalendarApp.getCalendarById(CALENDAR_ID);

  if (!calendar) {
    console.log('カレンダーが見つかりませんでした');
    return;
  }

  calendar.deleteCalendar();

  console.log(`id「${CALENDAR_ID}」のカレンダーを削除しました`);
}