今回のメソッドは、予定のゲストリストを表示できるか取得するguestsCanSeeGuests()メソッドをご紹介します。
このメソッドでは、予定のゲストの権限設定で予定のゲストリストを表示できる権限が付与されているかどうかを真偽値（true / false）で取得することができます。
権限が付与されていれば予定に招待されているゲストがリスト表示で確認できます。
予定のゲストリストを表示できるか取得する— guestsCanSeeGuests()
コピペで使えるサンプルコードを参照したい方はこちらをクリックすればサンプルコードまでジャンプできますので、手っ取り早くコードを確認したい方はクリックしてください。
予定の詳細画面では、下記スクリーンショットの赤枠部分で設定が変更できます。
『ゲストリストを表示する』にチェックが入っていれば『true』、入っていなければ『false』が返り値として取得できます。
それでは、具体的なサンプルコードで説明をします。
『 引数に入れる値 』
今回のメソッドに関しては引数は必要ありません。
『 関連するメソッド 』
合わせて覚えたい予定のゲスト権限操作に関するメソッド
- setGuestsCanModify — 予定ゲストの予定変更権限を変更する
- setGuestsCanSeeGuests — 予定ゲストのゲストリスト表示権限を変更する
- setGuestsCanInviteOthers — 予定ゲストの他ユーザー招待権限を変更するする
- guestsCanModify — ゲストが予定を編集できるか確認する
- guestsCanInviteOthers — 予定ゲストが他ユーザーを招待できるか確認する
guestsCanSeeGuests()サンプルコード
//予定のゲストリストが表示できるか取得するコード
function sampleCodeForCalendarAppGuestsCanSeeGuests() {
var calendar = CalendarApp.getDefaultCalendar();
var date = new Date();
var events = calendar.getEventsForDay(date);
for (var i in events) {
var event = events[i];
console.log(event.guestsCanSeeGuests());
}
}
『 変数の説明 』
calendar = デフォルトカレンダーを取得
date = プログラム実行日を代入
events = プログラム実行日の予定を取得
event = 個々予定を取得
『 guestsCanSeeGuests()サンプルコード 』に上記サンプルスクリプトを記載したスクリプトがあります。
今回のコードではプログラム実行日の予定でゲストが予定を変更できるかどうかを取得してログに表示するコードを書いてみました。
上記処理を実行することに問題がなければ、スクリプトにアクセスして関数名を選択後に▶ボタンをクリックしてプログラムを実行してみましょう。プログラムの実行が完了したら、予定のゲスト権限を確認してみてください。
私の環境では、2つの予定を作成し、『ゲストリストを表示する』にチェックを入れたものと入れていないものを準備してあります。
下記のスクリーンショットを確認すると、『true』と『false』が出力されていることが確認できます。
ご自身の予定のゲストリストの表示権限があるかないかがログに出力されていればプログラムは問題なく動作しています。（実行日の予定がなにもない場合は何も表示されません）
まとめ
今回は予定のゲストリストを表示できるかどうかを取得するguestsCanSeeGuests()メソッドのご紹介をしました。今回で予定のゲストリストの表示権限を取得する方法が身に付いたと思いますので、覚えたメソッドを活用してコードを書いてみましょう。