photo credit: wuestenigel December 7th, Pearl Harbor Day. Calendar 2019 via photopin (license)
みなさん、こんにちは！
タカハシ(@ntakahashi0505)です。
GAS、Googleカレンダー、スプレッドシートを活用して、これまでの仕事の生産性を測定する方法についてシリーズでお伝えしています。
前回の記事はこちらです。
生産性を測定するためのGoogleカレンダーの使い方についてお伝えしました。
今回から、いよいよGoogle Apps Scriptを触っていきます。
まずは、Googleカレンダーの操作方法ということで、Google Apps ScriptでGoogleカレンダーを扱う最初の一歩をお伝えしていきます。
では、行ってみましょう！
プロジェクトを作成する
まず、GASのスクリプトを書くためのプロジェクトを準備します。
最終的にはスプレッドシートにデータを書き出して集計するので、スプレッドシートと紐づくタイプの「コンテナバインドスクリプト」としてプロジェクトを作成します。
新規のスプレッドシート「カレンダー実績」を作り、メニューから「ツール」→「スクリプトエディタ」とたどります。
すると別タブで、スクリプトエディタに新規プロジェクトが開きます。
このスクリプトエディタの画面でGASのコードを編集していきます。
プロジェクト名はこちらもカレンダー実績などとしておきましょう。
GoogleカレンダーのカレンダーIDの調べ方
次に、GoogleカレンダーのカレンダーIDの調べ方を見ていきましょう。
というのも、GASからGoogleカレンダーを操作するためには、操作対象となるカレンダーのカレンダーIDをコード内で使用する必要があるのです。
まず、Googleカレンダーを開いて、メインメニューの対象となるカレンダーのオーバーフローメニュー（三点リーダーアイコンです）から、「設定と共有」を選択します。
設定画面では「カレンダーの統合」をクリックします。
ページ内リンクで移動し、その一番上に「カレンダーID」が表示されていますので、それをコピーしておきましょう。
ちなみに、アカウントのメインのカレンダーであれば、アカウント名がそのままカレンダーIDになっているはずです。
カレンダーを操作する最初のスクリプト
では、このカレンダーIDを使って、GASからアクセスしてみましょう。
スクリプトエディタで以下のようなコードを入力して、実行してみてください。
const CALENDAR_ID = '**********'; //カレンダーID
function getCalendarEvents() {
const calendar = CalendarApp.getCalendarById(CALENDAR_ID);
console.log(calendar.getName());
}
カレンダーIDの「**********」の箇所には、みなさんのカレンダーIDをペーストして入力してください。
実行すると、以下のような「Authorization required」という画面が表示されますので、「許可を確認」から、カレンダーへのアクセスを許可してください。
実行後、ログを確認すると以下のように、対象のカレンダー名が表示されるはずです。
つまり、カレンダーへのアクセス成功ですね！
カレンダーIDでカレンダーを取得する
コードの解説をしていきましょう。
3行目ですが、カレンダーIDを使ってカレンダーを取得しています。
使用しているのは、CalendarAppクラスのgetCalendarByIdメソッドです。
カレンダーIDを渡すことで、対象のカレンダーをCalendarオブジェクトとして取得します。
ちなみに、CalendarAppオブジェクトは、GASのCalendarサービスのトップレベルオブジェクトで、カレンダーの操作はまずこのオブジェクトからスタートします。
カレンダー名を取得する
4行目のgetNameメソッドは、Calendarオブジェクトのカレンダー名を取得するものです。
Calendarオブジェクトには他にもさまざまなメソッドが用意されていますので、それを使って操作をしていくことになります。
まとめ
以上、Google Apps ScriptでGoogleカレンダーを扱う最初の一歩についてお伝えしました。
カレンダーの操作…けっこう楽しそうですよね！
次回は、Google Apps Scriptを使用して取得する方法をお伝えします。
どうぞお楽しみに！