初心者向けGASでLINEにプッシュメッセージを送るスクリプトを徹底解説

みなさん、こんにちは！
タカハシ(@ntakahashi0505)です。

このシリーズでは初心者のノンプログラマー向けに「Google Apps Scriptを使ってゴミ出しLINE Botをつくる」をお題として連載を進めております。

前回の記事はこちら。

初心者向けGASを使ってLINEではじめてのプッシュメッセージを送るスクリプト

初心者のノンプログラマー向けに「Google Apps Scriptを使ってゴミ出しLINE Botをつくる」をお題として連載を進めております。今回は、GASを使ってLINEではじめてのプッシュメッセージを送るスクリプトを紹介します。

GASを使ってLINEにプッシュメッセージを送るスクリプトを紹介しました。

ただ、その中身については説明していませんでしたので、今回の記事で説明していきますね。

ということで、初心者向けGASでLINEにプッシュメッセージを送るスクリプト徹底解説をお伝えします。

では、行ってみましょう！

前回のおさらい
LINEにプッシュメッセージを送るfetchメソッドの解説
まとめ
連載目次：【初心者向け】GASでゴミ出しLINE Botをつくる

前回のおさらい

前回は、GASを使ってLINEに以下のように「Hello, world!」とプッシュメッセージを送るスクリプトを紹介しました。

実際のスクリプトはこちらですね。

function postMessage() {
  const url = 'https://api.line.me/v2/bot/message/push';
  const token = '**********'; //チャネルアクセストークン

  const payload = {
    to: '*****',　//ユーザーID
    messages: [
      { type: 'text', text: 'Hello, world!' }
    ]
  };

  const params = {
    method: 'post',
    contentType: 'application/json',
    headers: {
      Authorization: 'Bearer ' + token
    },
    payload: JSON.stringify(payload)
  };

  UrlFetchApp.fetch(url, params);
}

ただ、このスクリプトが何をしているものなのかを説明していませんでしたので、今回解説していきますよ。

LINEにプッシュメッセージを送るfetchメソッドの解説

まずスクリプトの21行目が、実際にHTTPリクエストを送信するfetchメソッドになります。

リクエスト先のurlと、いろいろなパラメーターを含むオブジェクトparamsを引数として渡していますね。

それぞれ、どのように設定をすればよいものなのか見ていきましょう。

HTTPリクエストURLとHTTPメソッド

まず、HTTPリクエストURLはリクエストの内容によってMessaging APIで固定のものが定められているものです。

「プッシュメッセージを送る」のページを開いてみてください。

以下のように書いてありますね。

POST https://api.line.me/v2/bot/message/push

このURLが、HTTPリクエスト先のURLとなります。

ちなみに「POST」は、HTTPメソッドというリクエストの種類を表します。

情報が欲しい場合は「GET」、データを送りたい場合は「POST」など、リクエストの内容に応じてHTTPメソッドを指定します。

今回の、プッシュメッセージを送る場合に使用するHTTPメソッドはPOSTということになります。これは後ほど使います。

fetchメソッドのparamsパラメーター

fetchメソッドのもう一つのパラメーターparamsですが、オブジェクトになっていて、リクエストに必要な決められたプロパティと値の組み合わせを設定する必要があります。

以下、今回必要なプロパティを公式ドキュメントから抜粋し、前述のスクリプトで指定してる内容を追記しました。

プロパティ	データ型	説明	指定する内容
method	String	HTTPメソッド	‘post’
contentType	String	コンテンツタイプ	‘application/json’
headers	Object	リクエストに必要なHTTPヘッダーのオブジェクト	{ Authorization: ‘Bearer ‘ + token }
payload	String	リクエストの本文	JSON.stringify(payload)

Class UrlFetchApp | Apps Script | Google for Developers

HTTPメソッド、コンテンツタイプは、Messaging APIのドキュメントに記載されている固定の文字列です。

HTTPヘッダーはオブジェクトですが、Authorizationというプロパティと、「Bearer <アクセストークン>」という文字列のペアのみをもたせればOKです。

ここで、「Bearer」とアクセストークン（文字列）の後に半角スペースを入れるのを忘れないようにしてくださいね。

パラメーターparamsの設定をしている部分がスクリプトでいうと12~19行目になりますので、見比べてみてください。

POSTの本文: payload

メッセージを送る本文はパラメーターparams内の、payloadというプロパティに設定します。

Messaging APIの公式ドキュメントでは、以下内容のJSONを指定するとされています。

プロパティ	データ型	説明	設定内容
to	String	送信先のID	‘*****’,　//ユーザーID
messages	メッセージオブジェクトの配列	送信するメッセージ	[{ type: ‘text’, text: ‘Hello, world!’ }]