【3分で簡単】GASでカレンダーに予定を追加する方法

2022年9月2日2024年3月17日

お仕事おつにゃッス🐈

文系未経験から社内SEになった、あっきょ（@daily_code_JP）です！

Google カレンダーの当日の予定を1クリックで登録できたら便利だと思いませんか。

GASではとあるメソッドをたった1つ使うだけで簡単に複数の予定を登録できます。

この記事ではそんなあったらいいなをGoogle Apps Scriptで解決します。

こんな人におすすめ！

1日のスケジュールを1クリックで登録したい
Googleカレンダーをもっと賢く使いたい
プログラミングでJavaScriptを学んだけど何を作っていいかわからない

誰でも無料で簡単にできますので気軽に学んでいきましょう！

GASでカレンダーに予定を登録するイメージ

GASでカレンダーに予定を登録します。

一気に予定を羅列することで時短可能。

例えば、10件以上の予定を追加する場合はGASで登録した方がミスを減らせます。

結果として業務効率化につながります。

あっきょ

GASの基本構文なので覚えておいて損はないッス！

GASでカレンダーに予定を登録する準備

Google Apps Scriptでカレンダーのスケジュールを登録する準備をします。

ファイルを1点を用意します。

必要なファイル

Google Apps Script…コードの入力

サンプルコードを貼り付ける場所

ソースコードはGoogle Apps Scriptのファイルにコピペします。

メニュー画面で右クリックしてオプションを開きます。

1番下の「その他」を選択し、その中の「Google Apps Script」を選択します。

以下のような画面が現れるので、ここにコードをコピペします。

カレンダーに予定を登録するサンプルコード

Google Apps Scriptでカレンダーに予定を登録するサンプルコードを掲載します。

解説の項目

createEventメソッド | カレンダーに予定を登録
サンプルコード
A, 現在使っているGoogleカレンダーを取得
B, カレンダーに登録する内容を定義
C, Googleカレンダーに予定を登録

createEventメソッド | カレンダーに予定を登録

カレンダーに予定を登録するにはcreateEventメソッドを使用。

3つの引数を入れて実行すると自動でカレンダーにスケジュールを登録できます。

GASでカレンダーに予定を登録するcreateEvent(value, startDate, endDate)の詳細

引数	詳細
value	予定のタイトル
startTime	予定を開始する時刻(Data型)
endTime	予定を終了する時刻(Data型)

サンプルコード

右上にあるマークを押すとコードのコピペが一瞬でできます。

また、コード内で文頭にアルファベットが付いているコメントごとに詳細を説明していきます。

function registerSchedule() {
  //A, 現在使っているGoogleカレンダーを取得
  const calendar = CalendarApp.getDefaultCalendar();

  //B, カレンダーに登録する内容を定義
  const title = "登録する予定のタイトル";  //予定のタイトル
  const startTime = new Date("2022/08/13 13:00"); //開始時間
  const endTime = new Date("2022/08/13 13:30"); //終了時間

  //C, Googleカレンダーに予定を登録
  calendar.createEvent(title, startTime, endTime);
}

A, 現在使っているGoogleカレンダーを取得

//A, 現在使っているGoogleカレンダーを取得
const calendar = CalendarApp.getDefaultCalendar();

デフォルトカレンダーを取得。

デフォルトカレンダーとは、あなたがGoogleアカウントで管理しているGoogleカレンダーを意味します。

B, カレンダーに登録する内容を定義

//B, カレンダーに登録する内容を定義
const title = "登録する予定のタイトル";  //予定のタイトル
const startTime = new Date("2022/08/13 13:00"); //開始時間
const endTime = new Date("2022/08/13 13:30"); //終了時間

カレンダーに登録する予定の詳細を3つ定義。

このコードでは、2022年8月13日の13時から13時半に「登録する予定のタイトル」という予定を登録します。

時間に関わる定数ではDateオブジェクトを使って時間を定義します。

C, Googleカレンダーに予定を登録

//C, Googleカレンダーに予定を登録
calendar.createEvent(title, startTime, endTime);

Googleカレンダーに定義した予定を登録。

createEventメソッドの中に予定を引数に入れて実行します。

コードの説明は以上です。

【応用】オプションを付けて登録する場合

GASではGoogleカレンダーにオプションを付けて登録することも可能。

例えば、場所やメモなどを追加で登録できます。

GASでカレンダーに予定をオプションを設定して登録するcreateEvent(value, startDate, endDate, options)の詳細

引数	詳細
value	予定のタイトル
startTime	予定を開始する時刻(Data型)
endTime	予定を終了する時刻(Data型)
options	場所などのその他のデータ(Object型)

サンプルコード

先ほどのサンプルコードとほぼ同じです。

ただ、定数optionsを定義してcreateEventメソッドの4番目の引数に追加されている点が異なります。

function registerSchedule() {
  //A, 現在使っているGoogleカレンダーを取得
  const calendar = CalendarApp.getDefaultCalendar();

  //B, カレンダーに登録する内容を定義
  const title = "登録する予定のタイトル";  //予定のタイトル
  const startTime = new Date("2022/08/13 13:00"); //開始時間
  const endTime = new Date("2022/08/13 13:30"); //終了時間

  //オプションを付けて送信
  const options = {
    description: "詳細な情報を記入できます。", //詳細
    location: "新宿" //場所
  }

  //C, Googleカレンダーに予定を登録
  calendar.createEvent(title, startTime, endTime, options);
}

この例ではoptionsに2つの要素を定義しましたが、他にも追加で登録することが可能です。

項目	型	詳細
description	String	予定の詳細
location	String	予定を行う場所
guests	String	コンマで区切った参加者のメールアドレス
sendInvites	Boolean	trueで guests にメールを送信 (初期値 : false)