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