【コピペで使える】GASでEmailで予定のゲストを取得してみる

icon_for_CalendarApp_ getGuestByEmail
URLをコピーする
URLをコピーしました!
目次

Eメールアドレスを指定してゲストを取得— getGuestByEmail()

今回のメソッドは、プログラムを使ってEメールアドレスを指定してゲストを取得するメソッドを紹介します。

指定するEメールアドレスはGmailでなくても問題はありません。アドレスを指定してゲストにそのアドレスのユーザーが存在すればGuestオブジェクトを返します。Guestオブジェクトで使用できるメソッドはこちらの一覧ページに記載されているものが利用可能です。もし指定したアドレスのユーザーがゲストに存在しなければ返り値はnullとなります。これによって、複数の予定を検索して指定するユーザーが存在する予定に対してのみ実行される処理などを行うことができます。

    1. getGuestByEmail(email)

『 引数に入れる値 』

  • email(文字列) — チェック対象のEメールアドレスを指定

getGuestByEmail()

サンプルコード1
//アドレスを指定してゲストを取得するコード
function sampleCode1() {
  var calendar = CalendarApp.getDefaultCalendar();
  var date = new Date(); 
  var events = calendar.getEventsForDay(date);
  var email = ""; //対象のEメールアドレスを指定
  for (var i in events) {
    var event = events[i];
    /*イベントIDで指定するときには下記のコード
      var eventId = events[i].getId();
      var event = calendar.getEventById(eventId);
    */
    var guest = event.getGuestByEmail(email);
    console.log(guest);
  }
}

『 変数の説明 』

calendar = デフォルトカレンダーを取得
date = プログラム実行日を代入
events = プログラム実行日に作成済みのイベントを取得
guest = ゲストオブジェクトを代入

スクリプトができたら▶ボタンでプログラムを実行してみましょう。プログラムが終了すればguestという変数にGuestオブジェクトが代入されます。ログを確認するとEventGuestと表示されていればゲストオブジェクトが取得されています。指定したアドレスがなければnullが表示されます。ちなみに、ゲストだけでなく、オーナーもこのアドレスで指定すればGuestオブジェクトとして取得することができます。

まとめ

今回はEメールアドレスを指定してゲストを取得するメソッドを紹介しました。Guestオブジェクトからはアドレスやゲストの名前、ゲストのステータス(出席、欠席など)を取得できますので、組み合わせることでより複雑な処理を実行できるようになります。

icon_for_CalendarApp_ getGuestByEmail

この記事が気に入ったら
いいね または フォローしてね!

よかったらシェアしてね!
URLをコピーする
URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

初心者でもわかるGoogle Apps Script活用のススメの管理人。
業務でラクをするという邪な目的のためにプログラムを独学で勉強し始め、初心者向けのGoogle Apps Scriptの使い方サイトを運営するに至る。
ラクをするためにはどんな苦労も厭わないという考えから、手っ取り早くスキルアップするためにCrowdWorksやLancersなどで仕事を受注し始め、過去にはTopClass PRO Crowd workerに認定された経験を持つ。
現在では、業務効率化システムの開発を行う会社の代表を務める。

コメント

コメント一覧 (1件)

コメントする

目次
トップへ
目次
閉じる