【GAS】CalendarApp.setTitleメソッドを完全マスター

  • このエントリーをはてなブックマークに追加
  • Pocket
  • LINEで送る
icon_for_CalendarApp_setTitle

予定のタイトルを設定する— setTitle()

今回のメソッドは、予定のタイトルを設定するsetTitle()メソッドを紹介します。

今回は作成済みの予定に対し、予定のタイトルを設定するsetTitle()メソッドを紹介します。予定のタイトルとは、下記のスクリーンショットで赤枠で囲われた部分です。

予定のタイトル

この部分にタイトルを入力すると、詳細画面表示前の画面でも、タイトルが表示されます。下記のスクリーンショットで赤枠で囲った部分に表示されますので、予定をひと目で区別するためには重要な情報になります。

予定のタイトル

今回は、このタイトル部分をプログラムを使って設定/変更を行っていきます。

      1. setTitle(title)

『 引数に入れる値 』

    • title(文字列) — 設定したいタイトルを文字列で指定

setTitle(title)

サンプルコード1
//予定のタイトルを設定するコード
function sampleCodeForCalendarAppSetTitle() {
  var calendar = CalendarApp.getDefaultCalendar();
  var date = new Date(); 
  var events = calendar.getEventsForDay(date);
  var title = "プログラムでタイトル入れました";
  for (var i in events) {
    var event = events[i];
    event.setTitle(title);
  }
}

『 変数の説明 』

calendar = デフォルトカレンダーを取得
date = プログラム実行日を代入
events = プログラム実行日の予定を取得
title = 予定のタイトルを代入

プログラム実行日に複数予定が設定されている場合はすべての予定のタイトルが変更されてしまうので、ご注意下さい。
スクリプトができたら▶ボタンでプログラムを実行してみましょう。今回のコードではプログラム実行日の予定のタイトルに『プログラムでタイトル入れました』と設定するコードを書いてみました。タイトルには文字列を何でも設定することができます。予定を一言で表現するタイトルを設定して他の予定と見分けがつくようにしておきましょう。

setTitle

上記のコードをコピーして実行したあとにご自身のカレンダーを開いて予定を確認してみましょう。

もしすでにカレンダーを開いていてプログラム実行後も予定のタイトルが設定されていなければ、一度ページをリロードして確認してみて下さい。

まとめ

今回は予定のタイトルを設定するsetTitle()メソッドをご紹介しました。タイトルが設定できれば他の予定区別がしやすくなりますので、予定がわかりやすいですね。区別がしやすくなる他にも、ステータスによってタイトルを変更したり、プログラムを実行した人の名前を入れたりと様々な使い方が考えられます。プログラムの書き方を身に着けた後はやはり発想力が大事になってきますね。

SNSでもご購読できます。

コメントを残す

*