今回の記事では、予定のゲストが予定のゲストリストを表示することができるかどうかの権限を変更するためのsetGuestsCanSeeGuests()メソッドをご紹介します。
予定のゲストがゲストリストを表示できる権限を変更する— setGuestsCanSeeGuests()
コピペで使えるサンプルコードを参照したい方はこちらをクリックすればサンプルコードまでジャンプできますので、手っ取り早くコードを確認したい方はクリックしてください。
以前、guestsCanSeeGuests()メソッドでゲストリストを表示することができる権限があるかどうかを確認するための方法をご説明しましたが、今回はその権限を設定するためのメソッドをご紹介します。GoogleカレンダーのUI上では、下記のスクリーンショットで示した場所で権限は編集可能です。
赤枠で囲われた部分にチェックが入っていればゲストは予定のゲストリストを表示することができ、このチェックボックスの下に招待済みのゲスト名が表示されるようになります。今回のメソッドでは、プログラムでこのチェックをつけたり外したりするやり方です。
『 引数に入れる値 』
『 関連するメソッド 』
合わせて覚えたいカレンダー予定の操作に関するメソッド
- setGuestsCanModify — 予定ゲストの予定変更権限を変更する
- setGuestsCanInviteOthers — 予定ゲストの他ユーザー招待権限を変更する
- guestsCanModify — ゲストが予定を編集できるか確認する
- guestsCanSeeGuests — 予定ゲストがゲストリスト表示できるか確認する
- guestsCanInviteOthers — 予定ゲストが他ユーザーを招待できるか確認する
setGuestsCanSeeGuests(guestsCanSeeGuests)サンプルコード
//ゲストが予定のゲストリストを表示する権限を変更するコード
function sampleCodeForCalendarAppSetGuestsCanSeeGuests() {
var calendar = CalendarApp.getDefaultCalendar();
var date = new Date();
var events = calendar.getEventsForDay(date);
var guestsCanSeeGuests = false;
for (var i in events) {
var event = events[i];
event.setGuestsCanSeeGuests(guestsCanSeeGuests);
}
}
『 変数の説明 』
calendar = デフォルトカレンダーを取得
date = プログラム実行日を代入
events = プログラム実行日の予定を取得
guestsCanSeeGuests = 招待権限をtrue/falseで設定
event = 個々予定を取得
『 setGuestsCanModify(guestsCanModify)サンプルコード 』に上記サンプルスクリプトを記載したスクリプトがあります。
今回のコードではプログラム実行日の予定に対して、ゲストがゲストリストを表示する権限を削除するコードを書いてみました。
上記処理を実行することに問題がなければ、スクリプトにアクセスして関数名を選択後に▶ボタンをクリックしてプログラムを実行してみましょう。プログラムの実行が完了したら、予定のゲスト権限を確認してみてください。
権限を付与したい場合は、false を trueに変更するだけで対応ができます。
まとめ
今回は予定のゲストがゲストリストを表示する権限を変更するsetGuestsCanSeeGuests()メソッドのご紹介をしました。切り替えはtrue/falseを指定するだけで良いので、とても簡単に切り替えを行うことができます。機会があれば活用してみましょう。