【GAS】setGuestsCanModifyメソッドを完全マスター

予定のゲストが予定を変更できる権限を変更する— setGuestsCanModify()

今回のメソッドは、予定のゲストが他ユーザーを招待できる権限を変更するためのsetGuestsCanInviteOthers()メソッドをご紹介します。

以前、guestsCanModify()メソッドで予定を変更する権限の有無を確認するための方法をご説明しましたが、今回はその権限を設定するためのメソッドをご紹介します。GoogleカレンダーのUI上では、下記のスクリーンショットで示した場所で権限は編集可能です。

赤枠で囲われた部分にチェックが入っていればゲストは予定の内容を変更することができます。今回のメソッドでは、プログラムでこのチェックをつけたり外したりするやり方です。

1. 1. 1. 1. setGuestsCanModify(guestsCanModify)

『 引数に入れる値 』

• guestsCanModify（Boolean） — true/falseで指定

setGuestsCanModify(guestsCanModify)

//ゲストが予定の内容を変更する権限を変更するコード
function sampleCodeForCalendarAppSetGuestsCanModify() {
  var calendar = CalendarApp.getDefaultCalendar();
  var date = new Date(); 
  var events = calendar.getEventsForDay(date);
  var guestsCanModify = true;
  for (var i in events) {
    var event = events[i];
    event.setGuestsCanModify(guestsCanModify);
  }
}

『 変数の説明 』

calendar = デフォルトカレンダーを取得
date = プログラム実行日を代入
events = プログラム実行日の予定を取得
guestsCanModify = 招待権限をtrue/falseで設定
event = 個々予定を取得

スクリプトができたら▶ボタンでプログラムを実行してみましょう。今回のコードではプログラム実行日の予定に対して、ゲストが予定の内容を変更する権限を付与するコードを書いてみました。プログラムの実行が完了したら、予定のゲスト権限を確認してみましょう。権限を削除したい場合は、true を falseに変更するだけで対応ができます。新規予定を作成するとデフォルトではこの項目にはチェックが入っていない状態で作成されるため、今回のコードでは、チェックをつけるためのコードにしてあります。

対象の予定を確認すると、上記のように『予定を変更する』にチェックが入っているかと思います。その他の『他のユーザーを招待する』と『ゲストリストを表示する』がグレーアウトしてクリックできなくなりますが、こちらはGoogleカレンダーの仕様です。おそらく、予定を変更する権限は他の2つの権限を内包するためにこのような表現になるのだと思います。

まとめ

今回は予定のゲストが予定の内容を変更する権限を変更するsetGuestsCanModify()メソッドのご紹介をしました。切り替えはtrue/falseを指定するだけで良いので、とても簡単に切り替えを行うことができます。機会があれば活用してみましょう。