【コピペで使える】GASでカレンダーの詳細説明を取得してみる

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

カレンダーの説明文を取得するメソッド — getDescription

今回のメソッドではアカウントのカレンダーの説明文を取得するgetDescription()メソッドの説明を致します。そもそも説明文ってどこ?という疑問をお持ちの方もいるかと思いますので、説明文の場所も説明しようと思います。

説明文の内容を分岐の条件などに使えるかもしれませんね。

それでは、まずは説明文がどこなのかをスクリーンショットを確認しながら見ていきましょう。

カレンダー名の右にある『︙』をクリックして表示されるメニューから『設定と共有』クリックして設定画面を表示させて下さい。

カレンダーIDの取得方法①

カレンダーIDの取得方法②

表示された設定画面の初期画面に説明と書かれたテキストフィールドが確認できると思いますが、こちらがカレンダーの説明文になります。カレンダー毎に設定することが出来ますので、どのカレンダーに何が入っているのかという情報や、カレンダーと連携させているスプレッドシートのIDなどを格納しておくと条件分岐の際に効果があります。

カレンダーの説明文を確認

説明文を変更するときには、テキストフィールドに直接タイピングして内容を変更してみて下さい。今回の投稿では、デフォルトカレンダーの説明文を取得するコードと任意のカレンダーの説明文を取得するコードをご紹介します。とりあえず、デフォル卜カレンダーになんでも良いので文字を入力しておきましょう。

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

  1. getDescription()

『 引数に入れる値 』

今回のメソッドに関しては引数は必要ありません。

getDescription()(デフォルトカレンダーの説明文を取得)

サンプルコード1
//デフォルトカレンダーの説明文を取得するコード
function sampleCode1() {
  var description = CalendarApp.getDescription();
  console.log(description);
}

『 変数の説明 』

description = デフォルトカレンダーの説明文を取得して代入

スクリプトができたら▶ボタンでプログラムを実行してみましょう。実行が終了したらログを確認してみましょう。ログに表示される文字が入力した説明文と一致していればプログラム処理は成功しています。

getDescription()(全てのカレンダーの説明文を取得)

サンプルコード2
//全てのカレンダーの説明文を取得するコード
function sampleCode2() {
  var calendars = CalendarApp.getAllCalendars();
  for (var i in calendars) {
    var description = calendars[i].getDescription();
    console.log(description);
  }
}

※説明文を入力していない場合は空白がログに出力されます。

まとめ

カレンダーの説明文を取得するメソッドをご紹介しました。説明文を利用してプログラム用の情報を記載しておけば、一時的に値を格納できる変数と違い、長期的にもデータを保持させることが可能になりますので、使いみちは色々とありそうですね。機会があればこの部分を利用したコードを後ほど共有したいと思います。

Google Apps Scriptにはカレンダーの説明文の他、色々なところに長期的なデータを保存できる場所がありますので、そういったものを活用すれば時間トリガーで自動起動するコードにも出来ることの幅を広げることが可能だと思います。ぜひ頭に入れておいて下さい。

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

icon_for_CalendarApp_ getDescription

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

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

この記事を書いた人

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

コメント

コメント一覧 (1件)

コメントする

目次
トップへ
目次
閉じる