Google Apps Scriptで、GoogleカレンダーのcreateEvent()がうまくいかない

Question

Google Apps Scriptで、Googleカレンダーに予定を追加するスクリプトを作っています。

下記抜粋ソースのうち、cal.createEvent()を実行すると、下記エラーが表示されます。

TypeError: オブジェクト Calendar で関数 createEvent が見つかりません。

// 抜粋ソース
var sheet = SpreadsheetApp.getActiveSheet();
var calendarName = sheet.getRange(2, 16).getValue();
// カレンダーの取得(ない場合nullとなる)
var cal = CalendarApp.getCalendarsByName(calendarName);
// 日時取得
var startDatetime = sheet.getRange(8, 4).getValue();
var endDatetime = sheet.getRange(8, 5).getValue();
// 予定の登録
// 現在は書式「日時」のセルを取得してセットしている
cal.createEvent('yotei', startDatetime, endDatetime);

開始/終了日時がDate型にできていないのかと思い

1. 日時をバラバラに取得して、new Date()でDate型にしてみる
2. セルの書式を「日時」に変更してみる
3. セル書式「日時」が実はstringなのではと疑い、new Date(セルの値)をしてみる
4. new Date()に日付文字列のリテラルをセットしてみる

など、試行錯誤しておりました。

しかし、現状同じエラーが発生しており、cal.createEvent()が正常終了しません。

どのようにすれば、本エラーを回避し、開始/終了日時を設定した予定を登録できるのでしょうか？

なおシートは下記のようなものを使用しております。

Googleスプレッドシート

宜しくお願いします。

Answer 1

CalendarApp.getCalendarsByName() は、 getCalendar "s" と関数名が複数形なことからも分かるように、 Calendar ではなく Calendar を要素に持つ配列を返す 仕様かと思います。同じ名前のカレンダーが複数あっても、全て取得できるようになっているわけです。

なので、 cal.createEvent() と呼び出すのではなく、 cal[0].createEvent() のようにして、 配列の中のどの Calendar に対して予定を作成したいのかを明示する書き方にする必要があるかと存じます。うまく行かない場合は試行錯誤する前に、リファレンスとエラー文をよく御読み下さい。

Comments

[lis]

ご指摘の内容を反映し、cal[0]のオブジェクトを参照することで、予定を追加することができました。

> Calendar ではなく Calendar を要素に持つ配列を返す
デバッガで確認したところ

----------
cal[1] Array (1948814416) [Calendar]
0 Object (1948813191)
----------

と、確かに配列で取得していました。

対象のカレンダー名が1つしかない場合、単発オブジェクトになると、勝手に勘違いしてしまっていました。

> うまく行かない場合は試行錯誤する前に、リファレンスとエラー文をよく御読み下さい。
リファレンスとエラー文を読み直して、調査するよう改めて心掛けたいと思います。

大変助かりました。ありがとうございました！