本記事は以下の記事を参考に、プログラミング初心者がLINE Botを作ってみた勉強レポです。
ゴミの日も記念日も何でも通知してくれるLINE BotをGASで作ってみよう

はじめに自己紹介

みなさんこんにちは！
Progateで広報を担当しているおおつぶらいです🍢

今回はPathチームやユーザーのみなさんに混ぜてもらい、初めてのアドベントカレンダーに参加します！

お名前： 大粒来美穂（おおつぶらいみほ）
所属： 株式会社Progate
お仕事： 広報・PR

実は私はエンジニア職ではないのですが、半ば趣味として制作したLINE Botについてまとめてみたいと思います。

なにしたの？

ごみの日や請求書の発行など、毎週・毎月繰り返しリマインドして欲しい予定をお知らせしてくれるLINE Botを作成しました。
名付けて 「お知らせくん」 です。

きっかけ

Progateの元社員の方がTwitterで同じようなLINE Botを作成していたことでした。
「これは便利だぞ！」と思い、私も真似して作ってみることに…。

作り方

今回使うものは、以下の4つです。

Google SpreadSheet
Google AppScript（以下、GAS）
LINE Messaging API
LINE

仕組みとしては、

Google SpreadSheetをマスターとして、お知らせ内容や日程を登録する。
GASでLINEに通知を飛ばす。

という流れです。

今回はこちらの記事のコードをベースお借りして作っていきます。
ゴミの日も記念日も何でも通知してくれるLINE BotをGASで作ってみよう

LINE Messaging APIを用意する

詳しい説明は省略させていただきます。こちらの公式ドキュメントをご参照ください。
「5.チャネルを確認する」まで完了させましょう。
Messaging APIを始めよう

マスターのSpreadSheetを作る

まずは通知内容やタイミングを管理するためのスプレッドシートを作ります。
内容はこんな感じです。

A列〜G列：通知タイミングや頻度を指定
H列：通知内容を指定
I列〜J列：通知先のLINEグループを指定

J列「グループ名」は通知の仕組みには関係ありませんが、通知先のグループが複数ある場合にも分かりやすいように記載しています。

GASを用意する

作成したマスターのスプレッドシートのメニューバーから【拡張機能 > AppScript】を開きます。

今回、参考記事のコードを使用させていただいているので、コードの各部分がどんな役割なのかを解説していこうと思います。

アクセストークンとシートの指定

まずはアクセストークンと、取得対象となるスプレッドシートのキーを定義します。

// 「メッセージ送受信設定」のアクセストークン（ロングターム）を記入。
var ACCESS_TOKEN = '{YOUR_ACCESS_TOKEN}';

// 発言させたい日時と内容が書かれたシートのKeyを記入してください。
// シート名には「alarm」としてください。
var SHEET_KEY = '{YOUR_SHEET_KEY}';

JSONをパースする

GASとLINE Messaging APIでメッセージをやり取りするために、

LINE MessagingAPIから送られてきた文字列をGASが扱えるようにするために、JSONをパースする
GASからLINE Messaging APIに文字列を送るために、GASのメッセージをJSON文字列に戻す

という処理が必要になります。

function doPost(e) {
    //「JSON.parse」メソッドでJSONをパースする
    var event = JSON.parse(e.postData.contents).events[0];
    var userMessage = event.message.text;

    var message = "";
    //「ID」というメッセージを受信したことを判定する  
    if ( userMessage === "ID" ) {
    message = tellID(event);
    }

    //「JSON.stringify」メソッドでGASの文字列をJSON文字列に変換する
    replyMessage(event.replyToken, message);
        return ContentService.createTextOutput(JSON.stringify({'content': 'post ok'})).setMimeType(ContentService.MimeType.JSON);
}

応答メッセージを送る

応答メッセージを送信する部分です。LINE Messanger APIのエンドポイントを使用します。
詳しくはこちらのリファレンスに記載があるので、興味のある方はご参照ください。
Messaging APIリファレンス

function replyMessage(token, message) {
  UrlFetchApp.fetch('https://api.line.me/v2/bot/message/reply', {
    'headers': {
      'Content-Type': 'application/json; charset=UTF-8',
      'Authorization': 'Bearer ' + ACCESS_TOKEN,
    },
    'method': 'post',
    'muteHttpExceptions': true,
    'payload': JSON.stringify({
      'replyToken': token,
      'messages': [{
        'type': 'text',
        'text': message,
      }],
    }),
  });
}

任意のタイミングでメッセージを送信する

こちらもLINE Messanger APIのエンドポイントを使用して、プッシュメッセージの送信を指示します。

function pushMessage(to, message) {
  UrlFetchApp.fetch('https://api.line.me/v2/bot/message/push', {
    'headers': {
      'Content-Type': 'application/json; charset=UTF-8',
      'Authorization': 'Bearer ' + ACCESS_TOKEN,
    },
    'method': 'post',
    'muteHttpExceptions': true,
    'payload': JSON.stringify({
      'to': to,
      'messages': [{
        'type': 'text',
        'text': message,
      }],
    }),
  });
}

IDを返す

JSONをパースするパートで、「ID」というメッセージが送られてきた場合に自分のIDとグループチャットのIDを送信する、というif文がありました。
ここのtellID関数で、IDを返すメッセージを指定します。

function tellID(event) {
  // ID
  var userID = event.source.userId;
  var talkID = "";
  if (event.source.type === "group") {
    talkID = event.source.groupId;
  } else if (event.source.type === "room") {
    talkID = event.source.roomId;
  }

  var message = "あなたのID: " + userID;
  if (talkID != "") {
    message += "\nこのチャットのID: " + talkID;
  }

  return message;
}

通知を送る

いよいよ通知を送信する部分です。
スプレッドシートから通知タイミングや内容を取得し、送付有無を判別します。

function notice() {
  //シートを取得
  var sheet = SpreadsheetApp.openById(SHEET_KEY).getSheetByName('alarm');
  //通知する内容を取得
  var data  = sheet.getDataRange().getValues();

　　　//通知タイミングを取得 
　　　//曜日の文字列を取得
  var dayStr = ["日", "月", "火", "水", "木", "金", "土"];
  //スプレッドシートA列〜G列より日時、送付内容、宛先を取得
  var now = new Date();
  for (var i=1; i<data.length; i++) {
    var [year, month, dayOfMonth, weekNum, dayOfWeek, hour, minute, message, to] = data[i];

    // 本文と発言する場所が空の場合はスキップ
    if (message === "" || to === "") { continue; }

    //取得した送付日時を判別し、通知を送付
    if ( (year       ==  now.getFullYear()               || year       === "")
      && (month      ==  now.getMonth() + 1              || month      === "")
      && (dayOfMonth ==  now.getDate()                   || dayOfMonth === "")
      && (weekNum    ==  parseInt(now.getDate() / 7) + 1 || weekNum    === "")
      && (dayOfWeek  === dayStr[now.getDay()]            || dayOfWeek  === "")
      && (hour       ==  now.getHours()                  || hour       === "")
      && (minute     ==  now.getMinutes()                || minute     === "")
      ) {
        pushMessage(to, message);
      }
  }
}