TENKit （テンキット）は「テンキー」を「IoT」化するキットです。
TENKit では、テンキーで入力された「数字」と、Googleスプレッドシートなどクラウド上のサービスを簡単に結びつけることができます。

ここでは、TENKit と Googleスプレッドシートとの連携手順について説明します。
具体的には、TENKit に接続されたテンキーからの入力を、Google Apps Scriptを通じて取得し、Googleスプレッドシートに記録する方法について記載します。

本手順をマスターすれば、数字の記録以外にも、Google Apps Scriptを通じたスマート家電の操作や、様々なクラウドサービスとの連携が可能になります。

本記事では、Google Apps Scriptの概要や構成、文法等の詳細については説明しませんが、本記事を参考に、是非とも様々な使い方を試してみてください。

設定前の準備

連携を設定する前に、以下の項目を確認してください。

1. 「TENKit」のセットアップ

HP 上の手順を参考に、TENKit にテンキーを接続し、起動して、Wifiに接続します。
オプション機能のモニターならびにGoogle Homeとの併用をおすすめします。

2. Googleスレプッドシートを開く

Googleスレプッドシートを通じて、Google Apps Scriptを記述します。
Googleスレプッドシートにアクセスし、お使いのGoogleアカウントを用いて使用を開始してください。
新しいスプレッドシートを作成し、名前を「TENKit」として保存します。

3. 連携情報の用意

TENKit に同梱の書類より「TENKit ID」と「Code」をご準備ください。

TENKit ID：ここでは例として「abcde12345」を用います。
Code：ここでは例として「12345678」を用います。

また、同書類に記載の「Webhook URLの設定に必要な情報」より、Basic認証用の「ユーザー名」と「パスワード」を併せてご準備ください。

連携の設定

連携の設定は、先ほど作成したGoogleスレプッドシート「TENKit」で行います。
連携の設定は、大きく以下の2ステップで行います。

Google Apps ScriptでWebhook URLを作成する
TENKit から作成したWebhook URLを呼び出す

Webhook URLの作成

「ツール」メニューより「スクリプトエディタ」を選択し、Google Apps Scriptの編集画面を開きます。
スプレッドシートと同じく、名前（プロジェクト名）を「TENKit」に設定します。

元のコードを全て削除し、「コード.gs」に下記のコードを記載します。

// POSTリクエストに対する処理
function doPost(e) {
  // TENKitから送信された情報の取得
  //   message    : 送信された内容
  //   created_at : 送信された時間
  var contents = JSON.parse(e.postData.contents);
  var message = contents.message;
  var created_at = contents.created_at;
  
  // スプレッドシートに書き込み
  //   紐づくスプレッドシートを取得
  //   メインのシートを取得
  //   取得した情報を追加（appendRow）
  var ss = SpreadsheetApp.getActive();
  var sheet = ss.getActiveSheet();
  sheet.appendRow([created_at, message]);
}

ここで、下記の承認手順を実施するために、一旦、実行ボタンを押します。

承認手順について

初めてコードを実行した際、「承認が必要です」というメッセージが表示されます。
その際「許可を確認」ボタンをクリックすると認証画面が表示されるので、ご自身のGoogleアカウントを選択し、承認手続きを実行してください。

ここで、次のようなアラートが表示される場合があります。

この時、青地の「安全なページに戻る」ではなく、左下の「詳細」をクリックし、次に「TENKit（安全でないページ）に移動」をクリックして承認手続きを実行してください。

承認手順実行後に、以下のようなエラーが発生しますが、問題ありませんので、そのまま次の手順に進んでください。

コードの公開（URLの作成）

次に、コードを公開し、Webhook用のURLを作成します。
作成したURLにPostリクエストでアクセスすると、上記で作成したコードが実行されます。
最終的に、ここで作成したURLを、TENKitから呼び出すことで、全体の連携が実現します。

Google Apps Scriptの編集画面の「公開」メニューより「ウェブアプリケーションとして導入」を選択します。

以下の画面が表示されるので、「アプリケーションにアクセスできるユーザー」に「全員（匿名ユーザー含む）」を選択して「導入」ボタンを押してください。

その後、以下の画面が表示されれば成功です。
「現在のウェブアプリケーションのURL」が作成されたWebhook URLになりますので、コピーして保管しておいてください。

コードの更新（再公開）

コードを追加、修正した際は、再度、Google Apps Scriptの編集画面の「公開」メニューより、「ウェブアプリケーションとして導入」を選択することで、更新したコードを公開し直すことができます。
その際、作成されたWebhook URLは変更されません。

更新時の注意点として、「プロジェクトバージョン」の設定を必ず「New」に設定してください。
「New」を設定しない場合、更新したコードが正しく公開されませんので、ご注意ください。

Webhook URLの呼び出し

上記で作成したWebhook URLを、TENKitから呼び出すよう設定します。

以下の設定ボタンをクリックして、専用の設定ページに移動します。

最初に、Basic認証画面が表示されるので、TENKit 同梱書類記載の「Webhook URLの設定に必要な情報（Basic認証）」の「ユーザー名」と「パスワード」を入力してください。

その後、以下のような登録画面が表示されますので、用意していた「TENKit ID」と「Code」を入力し、最後に先ほど作成した「Webhook URL」を入力して「登録する」ボタンを押します。

登録が成功すれば設定は終了です。
設定したWebhook URLは、TENKitのスマホアプリでも確認できます。

テンキーから入力

最後に、TENKitに接続されたテンキーから値を入力します。
以下のように、スプレッドシートに入力内容が記録されれば成功です。

ここで何らかのエラーが発生した際は、スマホアプリの履歴にエラー内容が表示されますので、ご確認ください。

最後に

本手順は、TENKit を利用する最も基本的な手順となります。
Google Apps Scriptを工夫することで、より面白い連携を実現することができます。
どのように利用するはかアイデア次第です。面白い使い方を是非発見してください。