1
/
5
Wantedly
About 株式会社スタジオ・アルカナ
株式会社スタジオ・アルカナ
https://www.s-arcana.co.jp

東京都

GASを使ってGoogleカレンダーに特定の予定があったときに前営業日にSlackに通知を送る仕組みを作ってみる

大川 峻
大川 峻
開発部
on 2024-12-05

概要

GASを使い、Googleカレンダーに特定の予定があった時にSlackに通知を送る仕組みを作ってみたので方法を簡単にまとめる。

注意

すべての予定をSlack通知したい場合、GASなんか使わずにSlackのGoogleカレンダーのアプリを使ったほうがはるかに楽

前提

  • 下記の内容を実施しSlack通知用のSlackアプリの作成が完了していること。

https://qiita.com/miriwo/items/cbb4b37b3f5abecc835f

  • GAS作成時に下記の内容を実施し、タイムゾーンが日本に設定されていること。

https://qiita.com/miriwo/items/cf21884c3f907df08e47

  • 下記の方法でチェック対象のGoogleカレンダーのカレンダーIDが確認できること。

https://qiita.com/miriwo/items/b00b3282cc428fc1c480

方法

  1. 下記のようにそれぞれのファイルでコードを記載する。
    • main.gs
      function noticeSpecificEvent() {
        const config = getConfig();
        const today = new Date();

        // 日本の祝日カレンダーのID（固定）
        const holidayCalendarId = "ja.japanese#holiday@group.v.calendar.google.com";
        const holidayCalendar = CalendarApp.getCalendarById(holidayCalendarId);

        const targetCalender = CalendarApp.getCalendarById(config.checkTargetCalendarId);

        if (!getIsNoticeDay(today, holidayCalendar, config)) {
          const message = "本日は通知対象日ではないため、通知は行いません。";
          console.log(message);
          return false;
        }

        if (!getIsLastBusinessDayBeforeSpecificEvent(today, holidayCalendar, targetCalender, config)) {
          let message = `本日は「${config.specificEventTitle}」の予定前の最終営業日ではないため通知は行いません。`;
          console.log(message);
          return false;
        }

        const memberInfo = getMemberInfo();
        const slackUserIds = memberInfo.slackUserIds;

        let text = "";
        slackUserIds.forEach(function (slackUserId) {
          text += "<@" + slackUserId + "> ";
        });
        text +=
          "\\\\n" +
          `本日は「${config.specificEventTitle}」の予定前の最終営業日です！\\\\n予定を忘れないようにしましょう！`;

        let payload = JSON.stringify({ text: text });

        sendSlackMessage(payload, config);
      }

      function getStartOfDay(date) {
          return new Date(date.getFullYear(), date.getMonth(), date.getDate());
      }

      /**
       * 通知対象日かどうかのboolを返却
       *
       * @param {Date} today
       * @param {Calendar} holidayCalendar
       * @param {Object} config
       * @returns {Boolean}
       */
      function getIsNoticeDay(today, holidayCalendar, config) {
        return !getIsHolidayOrWeekend(today, holidayCalendar, config);
      }

      /**
       * 指定された日付が祝日か休日かどうかのboolを返却
       *
       * @param {Date} day
       * @param {Calendar} holidayCalendar
       * @param {Object} config
       * @returns {Boolean}
       */
      function getIsHolidayOrWeekend(day, holidayCalendar, config) {
        const isHoliday = holidayCalendar.getEventsForDay(day).length > 0;
        const isWeekend =
          day.getDay() === config.dayOfWeeks.saturday.id ||
          day.getDay() === config.dayOfWeeks.sunday.id;
        return isHoliday || isWeekend;
      }

      /**
       * 指定予定前の最終営業日かどうかのboolを返却
       *
       * @param {Date} today
       * @param {Calendar} holidayCalendar
       * @param {Calendar} targetCalender
       * @param {Object} config
       * @returns {Boolean}
       */
      function getIsLastBusinessDayBeforeSpecificEvent(today, holidayCalendar, targetCalender, config) {
        let specificEventDates = getSpecificEventDates(today, targetCalender, config);
        let isLastBusinessDayBeforeSpecificEvent = false;

        if (specificEventDates.length === 0) {
          const message = "指定された予定が見つかりませんでした。";
          console.log(message);
          return isLastBusinessDayBeforeSpecificEvent;
        }

        const subDayNumber = 1;
        let lastBusinessDayBeforeSpecificEventDates = [];

        specificEventDates.forEach(function (specificEventDate) {
          while (true) {
            const specificEventBeforeDate = new Date(specificEventDate);
            // 指定された予定の前日を算出
            const specificEventBeforeDay = specificEventDate.getDate() - subDayNumber;
            specificEventBeforeDate.setDate(specificEventBeforeDay);
            if (!getIsHolidayOrWeekend(specificEventBeforeDate, holidayCalendar, config)) {
              lastBusinessDayBeforeSpecificEventDates.push(specificEventBeforeDate);
              break;
            }
            // falseだった場合、特定の予定の前日を特定の予定の日としてセットして本ループを再度実行
            specificEventDate = specificEventBeforeDate;
          }
        });

        // 年、月、日が完全に一致するかどうかを確認
        lastBusinessDayBeforeSpecificEventDates.forEach((lastBusinessDayBeforeSpecificEventDate) => {
          if (getIsSameDate(today, lastBusinessDayBeforeSpecificEventDate)) {
            isLastBusinessDayBeforeSpecificEvent = true;
          }
        });
        return isLastBusinessDayBeforeSpecificEvent;
      }

      /**
       * 2つの日付が完全に一致するかどうかのboolを返却
       *
       * @param {Date} dateOne
       * @param {Date} dateTwo
       * @returns {Boolean}
       */
      function getIsSameDate(dateOne, dateTwo) {
        return dateOne.getFullYear() === dateTwo.getFullYear() &&
          dateOne.getMonth() === dateTwo.getMonth() &&
          dateOne.getDate() === dateTwo.getDate();
      }

      /**
       * 指定された予定の日付を取得
       *
       * @param {Date} today
       * @param {Calendar} targetCalender
       * @param {Object} config
       * @returns {Array}
       */
      function getSpecificEventDates(today, targetCalender, config) {
          const oneMonthLater = getOneMonthLater(today);
          const targetCalenderEvents = targetCalender.getEvents(today, oneMonthLater);

          let specificEventDates = [];
          targetCalenderEvents.forEach(function (targetCalenderEvent) {
              if (targetCalenderEvent.getTitle() === config.specificEventTitle) {
                  specificEventDates.push(targetCalenderEvent.getStartTime());
              }
          });
          return specificEventDates;
      }

      /**
       * 指定された日付の1ヶ月後の日付を取得
       *
       * @param {Date} date
       * @returns {Date}
       */
      function getOneMonthLater(date) {
          const newDate = new Date(date);
          newDate.setMonth(newDate.getMonth() + 1);
          return newDate;
      }

      /**
       * Slackにメッセージを送信
       *
       * @param {String} payload
       * @param {Object} config
       */
      function sendSlackMessage(payload, config) {
        try {
          const webhookUrl = config.webhookUrl;

          let options = {
            method: "post",
            contentType: "application/json",
            payload: payload,
          };

          UrlFetchApp.fetch(webhookUrl, options);
        } catch (e) {
          console.log(e);
          throw e;
        }
      }

      function noticeSpecificEvent() {
        const config = getConfig();
        const today = new Date();

        // 日本の祝日カレンダーのID（固定）
        const holidayCalendarId = "ja.japanese#holiday@group.v.calendar.google.com";
        const holidayCalendar = CalendarApp.getCalendarById(holidayCalendarId);

        const targetCalender = CalendarApp.getCalendarById(config.checkTargetCalendarId);

        if (!getIsNoticeDay(today, holidayCalendar, config)) {
          const message = "本日は通知対象日ではないため、通知は行いません。";
          console.log(message);
          return false;
        }

        if (!getIsLastBusinessDayBeforeSpecificEvent(today, holidayCalendar, targetCalender, config)) {
          let message = `本日は「${config.specificEventTitle}」の予定前の最終営業日ではないため通知は行いません。`;
          console.log(message);
          return false;
        }

        const memberInfo = getMemberInfo();
        const slackUserIds = memberInfo.slackUserIds;

        let text = "";
        slackUserIds.forEach(function (slackUserId) {
          text += "<@" + slackUserId + "> ";
        });
        text +=
          "\\\\n" +
          `本日は「${config.specificEventTitle}」の予定前の最終営業日です！\\\\n予定を忘れないようにしましょう！`;

        let payload = JSON.stringify({ text: text });

        sendSlackMessage(payload, config);
      }

      function getStartOfDay(date) {
          return new Date(date.getFullYear(), date.getMonth(), date.getDate());
      }

      /**
       * 通知対象日かどうかのboolを返却
       *
       * @param {Date} today
       * @param {Calendar} holidayCalendar
       * @param {Object} config
       * @returns {Boolean}
       */
      function getIsNoticeDay(today, holidayCalendar, config) {
        return !getIsHolidayOrWeekend(today, holidayCalendar, config);
      }

      /**
       * 指定された日付が祝日か休日かどうかのboolを返却
       *
       * @param {Date} day
       * @param {Calendar} holidayCalendar
       * @param {Object} config
       * @returns {Boolean}
       */
      function getIsHolidayOrWeekend(day, holidayCalendar, config) {
        const isHoliday = holidayCalendar.getEventsForDay(day).length > 0;
        const isWeekend =
          day.getDay() === config.dayOfWeeks.saturday.id ||
          day.getDay() === config.dayOfWeeks.sunday.id;
        return isHoliday || isWeekend;
      }

      /**
       * 指定予定前の最終営業日かどうかのboolを返却
       *
       * @param {Date} today
       * @param {Calendar} holidayCalendar
       * @param {Calendar} targetCalender
       * @param {Object} config
       * @returns {Boolean}
       */
      function getIsLastBusinessDayBeforeSpecificEvent(today, holidayCalendar, targetCalender, config) {
        let specificEventDates = getSpecificEventDates(today, targetCalender, config);
        let isLastBusinessDayBeforeSpecificEvent = false;

        if (specificEventDates.length === 0) {
          const message = "指定された予定が見つかりませんでした。";
          console.log(message);
          return isLastBusinessDayBeforeSpecificEvent;
        }

        const subDayNumber = 1;
        let lastBusinessDayBeforeSpecificEventDates = [];

        specificEventDates.forEach(function (specificEventDate) {
          while (true) {
            const specificEventBeforeDate = new Date(specificEventDate);
            // 指定された予定の前日を算出
            const specificEventBeforeDay = specificEventDate.getDate() - subDayNumber;
            specificEventBeforeDate.setDate(specificEventBeforeDay);
            if (!getIsHolidayOrWeekend(specificEventBeforeDate, holidayCalendar, config)) {
              lastBusinessDayBeforeSpecificEventDates.push(specificEventBeforeDate);
              break;
            }
            // falseだった場合、特定の予定の前日を特定の予定の日としてセットして本ループを再度実行
            specificEventDate = specificEventBeforeDate;
          }
        });

        // 年、月、日が完全に一致するかどうかを確認
        lastBusinessDayBeforeSpecificEventDates.forEach((lastBusinessDayBeforeSpecificEventDate) => {
          if (getIsSameDate(today, lastBusinessDayBeforeSpecificEventDate)) {
            isLastBusinessDayBeforeSpecificEvent = true;
          }
        });
        return isLastBusinessDayBeforeSpecificEvent;
      }

      /**
       * 2つの日付が完全に一致するかどうかのboolを返却
       *
       * @param {Date} dateOne
       * @param {Date} dateTwo
       * @returns {Boolean}
       */
      function getIsSameDate(dateOne, dateTwo) {
        return dateOne.getFullYear() === dateTwo.getFullYear() &&
          dateOne.getMonth() === dateTwo.getMonth() &&
          dateOne.getDate() === dateTwo.getDate();
      }

      /**
       * 指定された予定の日付を取得
       *
       * @param {Date} today
       * @param {Calendar} targetCalender
       * @param {Object} config
       * @returns {Array}
       */
      function getSpecificEventDates(today, targetCalender, config) {
          const oneMonthLater = getOneMonthLater(today);
          const targetCalenderEvents = targetCalender.getEvents(today, oneMonthLater);

          let specificEventDates = [];
          targetCalenderEvents.forEach(function (targetCalenderEvent) {
              if (targetCalenderEvent.getTitle() === config.specificEventTitle) {
                  specificEventDates.push(targetCalenderEvent.getStartTime());
              }
          });
          return specificEventDates;
      }

      /**
       * 指定された日付の1ヶ月後の日付を取得
       *
       * @param {Date} date
       * @returns {Date}
       */
      function getOneMonthLater(date) {
          const newDate = new Date(date);
          newDate.setMonth(newDate.getMonth() + 1);
          return newDate;
      }

      /**
       * Slackにメッセージを送信
       *
       * @param {String} payload
       * @param {Object} config
       */
      function sendSlackMessage(payload, config) {
        try {
          const webhookUrl = config.webhookUrl;

          let options = {
            method: "post",
            contentType: "application/json",
            payload: payload,
          };

          UrlFetchApp.fetch(webhookUrl, options);
        } catch (e) {
          console.log(e);
          throw e;
        }
      }

    • config.gs
      function getConfig() {
        return {
          checkTargetCalendarId: "参照するGoogleカレンダーのカレンダー ID",
          specificEventTitle: "特定の予定のタイトル",
          webhookUrl:
            "用意したSlackアプリのWebhook URL",
          dayOfWeeks: {
            sunday: {
              name: "sunday",
              id: 0,
            },
            monday: {
              name: "monday",
              id: 1,
            },
            tuesday: {
              name: "tuesday",
              id: 2,
            },
            wednesday: {
              name: "wednesday",
              id: 3,
            },
            thursday: {
              name: "thursday",
              id: 4,
            },
            friday: {
              name: "friday",
              id: 5,
            },
            saturday: {
              name: "saturday",
              id: 6,
            },
          },
        };
      }

      function getConfig() {
        return {
          checkTargetCalendarId: "参照するGoogleカレンダーのカレンダー ID",
          specificEventTitle: "特定の予定のタイトル",
          webhookUrl:
            "用意したSlackアプリのWebhook URL",
          dayOfWeeks: {
            sunday: {
              name: "sunday",
              id: 0,
            },
            monday: {
              name: "monday",
              id: 1,
            },
            tuesday: {
              name: "tuesday",
              id: 2,
            },
            wednesday: {
              name: "wednesday",
              id: 3,
            },
            thursday: {
              name: "thursday",
              id: 4,
            },
            friday: {
              name: "friday",
              id: 5,
            },
            saturday: {
              name: "saturday",
              id: 6,
            },
          },
        };
      }

    • memberInfo.gs
      function getMemberInfo() {
        return {
          slackUserIds: [
            "メンションをつけたいユーザーのslackID",
          ],
        };
      }

      function getMemberInfo() {
        return {
          slackUserIds: [
            "メンションをつけたいユーザーのslackID",
          ],
        };
      }

  3. main.gsのnoticeSpecificEvent()を毎日1回通知を行いたい時間に実行する設定をする

これでおそらく休日・祝日も考慮し、特定の予定の前営業日に通知が行われるはずである。

参考文献

https://developers.google.com/apps-script/reference/calendar/calendar?hl=ja#getEvents(Date,Date)

https://developers.google.com/apps-script/reference/calendar/calendar-event?hl=ja

https://developers.google.com/apps-script/reference/calendar/calendar-event?hl=ja#getStartTime()

If this story triggered your interest, why don't you come and visit us?
新宿オフィスで一緒に働くエンジニアさん大募集！
株式会社スタジオ・アルカナ's job postings
エンジニア GAS アドベントカレンダー
3 Likes
3 Likes

株式会社スタジオ・アルカナ

株式会社スタジオ・アルカナは、 ビジネスの課題をITの技術で解決することを得意とする、ウェブ制作会社です。 システム開発 / ウェブサイト制作を通して、世の中の「あったらうれしい」を形にし、 みんなの胸を高鳴らせたい。 そんなふうに考えています。 そんなわたしたちは、下記の３つの事業に取り組んでいます。 １.　グループ企業が運営するサービス ２.　自社サービス ３.　受託開発プロジェクト ーーーーーーーーーーーーーーーーーーーー １.　グループ企業が運営するサービス ーーーーーーーーーーーーーーーーーーーー わたしたちが所属している「ナシエルホールディングス（ https://naciel-holdings.co.jp/ ）」は、 アルカナを含め４つの会社が集まっています。 飲食店企業の成長を360度から支援して、胸が高鳴る世の中をつくる 「株式会社ナシエルホールディングス（https://naciel-holdings.co.jp/）」。 M&Aや不動産仲介、人材を扱う 「株式会社 M&A Properties （ https://www.maproperties.co.jp/ ）」。 データを活用して不動産ポータルサイトを運営する 「ホクトシステム株式会社 （ https://www.hoct.co.jp/ ）」 そして、デジタル技術で「あったらうれしい」を形にする、 わたしたち株式会社スタジオ・アルカナです。 グループの中でのスタジオ・アルカナは、 それぞれの会社が運営するサービスの制作をしたり、ビジネスツールを作成したり、 IT技術を用いた課題の解決を提案したりすることで、 グループの成長に貢献しています。 アルカナ以外の事業部のみんなとも、喜びを分かち合えたり、改善点を模索しあえたりと、 協力しながら進めていきます。 自分たちの技術が、実際のビジネスの場でどのように生かされていくのかを 間近で感じることができるのが、グループ内案件の面白いところです。 ぜひ一緒にワクワクしましょう。 ーーーーーーーーーーーーーーーーーーーー ２.　自社プロダクト ーーーーーーーーーーーーーーーーーーーー アルカナでは、「Linty（ https://linty.jp/ ）」というプロダクトを立ち上げ、 少しずつですが利用企業を増やしています。 世の中の「あったらうれしい」を形にするために、新しい自社サービスの開発にも意欲的です！ 企画をたてるプランナー、コンテンツを作るライター、 アジャイル思考でプロジェクトを進めていけるプロジェクトマネージャー、 新しい技術の研鑽を続けるエンジニア、ビジネス要件を形にしようとするデザイナー、 出来上がった製品を、世に広めていくアカウント・・・・と。 アルカナには、自社プロダクトを考え、作り上げ、打っていくメンバーが揃っています。 このメンバーで、これから自社プロダクトをもっと作っていきたいと考えています。 わたしたちと一緒に、プロダクトを作り上げませんか？ ーーーーーーーーーーーーーーーーーーーー ３.　受託開発プロジェクト ーーーーーーーーーーーーーーーーーーーー アルカナでは、グループ外のクライアントさまのビジネス課題の解決も担っています。 ご要件のキャッチアップ、定義からさせていただき、 システム開発 / デザイン制作といった実装をし、 納品後も、運用対応や、よりビジネスを加速させるためのご提案を行なったりと、 クライアントさまの「やりたいこと」に寄り添った対応を行います。 フロント部分だけでなく、インフラ構築やバックエンド、 また、ふわっとしたご要件を具体的なかたちにしていくところも、 ワンストップで手掛けられるのがアルカナの強みだと考えます。 グループ会社との案件で得られた経験がもとになって、 経営課題・事業課題にフィットしたご提案ができるのも、アルカナの持ち味かもしれません。 自社プロダクトに取り組んでいるというのもあり、 これまでの経験を踏まえ、リアルなイニシアルコストを例にしたり、 プロダクト公開後の失敗例などもお伝えしながら、 クライアントさまの「やりたいこと」「作りたいもの」を形にしていきます。 クライアントさまのビジネスを、一緒に加速させましょう！

エンジニア

Weekly ranking

Show other rankings
Like 大川 峻's Story
Let 大川 峻's company know you're interested in their content