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

icon_for_CalendarApp_ getOwnedCalendarsByName
URLをコピーする
URLをコピーしました!
目次

自分がオーナーのカレンダーからカレンダー名を指定して特定のカレンダーを取得するメソッド — getOwnedCalendarsByName

今回はアカウントに接続されているカレンダーのうち、自分がオーナーのカレンダーの中からカレンダー名を使って特定のカレンダーを取得するメソッドを紹介します。今回のメソッドはgetCalendarsByName()メソッドと似ていますが、getCalendarsByName()メソッドは他のアカウントがオーナーのカレンダーを含めてカレンダー名で取得することができるのですが、今回のgetOwnedCalendarsByName()メソッドは自分がオーナーのカレンダーのみ取得することができます。

早速メソッドの説明に移ります。

  1. getOwnedCalendarsByName(name)

『 引数に入れる値 』

  • name(カレンダー名) — 取得したいカレンダー名

getOwnedCalendarsByName(name)

サンプルコード1
//カレンダー名を指定してカレンダーを取得するコード
function sampleCode1() {
  var name = "新規のカレンダー"; //ご利用の際はご自身がオーナーのカレンダー名に置き換えて下さい。
  var calendars = CalendarApp.getCalendarsByName(name);
  for (var i in calendars) {
    var calendarName = calendars[i].getName();
    console.log(calendarName);
  }
}

『 変数の説明 』

name = カレンダー名を格納
calendars = カレンダー名を指定したカレンダーオブジェクトを配列で取得
calendarName = カレンダーの名前を格納

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

『スクリプトの説明』

変数calendarsにはカレンダー名で指定したカレンダーオブジェクトが配列で格納されます。配列で取得されることからもわかるかもしれませんが、このメソッドを利用した際に自分がオーナーのカレンダーに指定したカレンダー名が複数ある場合でもすべてのカレンダーを取得することができます。取得したカレンダー配列をforループで回してgetName()メソッドを使ってカレンダーオブジェクトからカレンダー名を取得して変数calendarNameに代入し、console.log(calendarName)でログにカレンダー名を出力させています。

まとめ

今回のコードでは、カレンダー名を自分で指定し、特定のカレンダーオブジェクトを取得するメソッドをご紹介しました。getOwnedCalendarById()メソッドと似ていますが、配列で取得される点には注意して下さい。

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

icon_for_CalendarApp_ getOwnedCalendarsByName

この記事が気に入ったら
いいね または フォローしてね!

よかったらシェアしてね!
URLをコピーする
URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

初心者でもわかるGoogle Apps Script活用のススメの管理人。
業務でラクをするという邪な目的のためにプログラムを独学で勉強し始め、初心者向けのGoogle Apps Scriptの使い方サイトを運営するに至る。
ラクをするためにはどんな苦労も厭わないという考えから、手っ取り早くスキルアップするためにCrowdWorksやLancersなどで仕事を受注し始め、過去にはTopClass PRO Crowd workerに認定された経験を持つ。
現在では、業務効率化システムの開発を行う会社の代表を務める。

コメント

コメントする

目次
トップへ
目次
閉じる