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