【コピペで使える】GASで自分のカレンダーをIDで取得してみる

自分がオーナーのカレンダーからカレンダーIDで特定のカレンダーを取得するメソッド — getOwnedCalendarById

今回はアカウントに接続されているカレンダーのうち、自分がオーナーのカレンダーをカレンダー毎に割り振られた一意のカレンダーIDを使って特定のカレンダーを取得するメソッドを紹介します。今回のメソッドはgetCalendarById()メソッドと似ていますが、getCalendarById()メソッドは他のアカウントがオーナーのカレンダーを含めてIDで取得することができるのですが、今回のgetOwnedCalendarById()メソッドは自分がオーナーのカレンダーのみ取得することができます。

カレンダーIDを手動で確認する方法はgetCalendarById()メソッドのページをご確認下さい。

それでは、メソッドの説明に移ります。

1. getOwnedCalendarById(id)

『 引数に入れる値 』

• id（カレンダーID） — 取得したいカレンダーのID

getOwnedCalendarById(id)

//カレンダーIDからカレンダーを取得するコード
function sampleCode1() {
  var id = "calendarId"; //ご利用の際はご自身がオーナーのカレンダーのIDに置き換えて下さい。
  var calendar = CalendarApp.getOwnedCalendarById(id);
  var calendarName = calendar.getName();
  console.log(calendarName);
}

『 変数の説明 』

id = カレンダーIDを格納
calendar = カレンダーIDを指定したカレンダーオブジェクトを格納
calendarName = カレンダーの名前を格納

スクリプトができたら▶ボタンでプログラムを実行してみましょう。実行が終了したらログを確認してみましょう。指定したIDのカレンダー名が出てくればプログラムは無事終了しています。

『スクリプトの説明』

変数calendarにはカレンダーIDで指定したカレンダーオブジェクトが格納され、getName()メソッドを使ってカレンダーオブジェクトからカレンダー名を取得して変数calendarNameに代入し、console.log(calendarName)でログにカレンダー名を出力させています。

まとめ

今回のコードでは、カレンダーIDを自分で指定し、特定のカレンダーオブジェクトを取得するメソッドをご紹介しました。

すべてのサンプルコードはコピーしてスクリプトエディタに貼り付けることでそのまま利用が可能です。