【GAS】チャットワークで作る翻訳チャットに例外コマンドでエラーが出たときの処理を追加

photo credit: Solo via photopin (license)

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

Google Apps Scriptでチャットワーク上に翻訳チャットを作成しています。

ベースのスクリプトはこちらの記事でできていまして

Google Apps Scriptでチャットワーク上に翻訳チャットを作る

Google Apps ScriptとチャットワークAPIを使って翻訳チャットを作る方法です。Google翻訳の機能をGASで扱うtranslateメソッドを使って、まずは最低限のシステムを目指します。

仕込んだチャット「翻訳さん」上で、 ISO639-1で登録されている言語コード（アルファベット2文字）を指定しつつ

言語コード;本文

と送信すれば翻訳結果が返ってくるという仕組みです。

しかし、上記のルールにのっとっていないコマンドを送ってしまったときは、Google Apps Script側でエラーが起きて何にも返事が返って来ないケースがありました。

今回はそれを解消すべく、Google Apps Scriptで作った翻訳チャットのスクリプトにエラー処理を搭載していきます。

これまでのおさらい
1. 翻訳チャットのスクリプトのおさらい
2. エラーが発生したときの分岐処理のおさらい
エラー処理を追加した翻訳チャットのスクリプト
まとめ
連載目次：GASとチャットワークAPIで翻訳チャットを作る

これまでのおさらい

翻訳チャットのスクリプトのおさらい

まず翻訳チャットのベースとなるスクリプト、以前作成したものはこちらです。

function translateChat() {

  var token = 'APIトークン'; //チャットワークAPIトークン
  var room_id = XXXXXX; //翻訳さんのルームID

  var json = fetchMessage(token,room_id); //翻訳さんグループチャットのメッセージを取得

  /* 各メッセージについて 繰り返す */
  for each(var obj in json){

      var arr = obj.body.split(';'); //セミコロンでsplitして配列に格納
      var result = LanguageApp.translate(arr[1], "", arr[0]); //翻訳

      var body = "[rp aid=" + obj.account.account_id
        + " to=" + room_id
        + "-" + obj.message_id
        + "] " + obj.account.name
        + "さん[info]翻訳結果：" + result + "[/info]"; //チャットワークに送るテキスト

      sendMessage(token,room_id,body); //チャットワークにメッセージを送る
    }
}

流れとしては

fetchMessageでチャットワークから未取得メッセージを取得
取得したメッセージ全てについて
1. セミコロンでsplitして言語コードと本文に分割
2. LanguageApp.translateメソッドで翻訳
3. チャットワークに返すテキストを生成
4. sendMessageでチャットワークに送る

という流れになります。

fetchMessage,sendMessageに関してはチャットワークAPIを使ってメッセージの送受信をする独自の関数ですので、以下の記事をご覧くださいね。

【GAS】チャットワークのメッセージを取り出す関数とメッセージを送る関数

Google Apps Scriptを活用してチャットワークにおみくじチャットを作成しています。今回はチャットワークからメッセージを取り出す、メッセージを送る処理を関数化して全体のコードをスッキリさせます。

エラーが発生したときの分岐処理のおさらい

チャットワークから受け取ったメッセージがルール以外のものだった場合、LanguageApp.translateメソッドがエラーを起こしてしまいます。

その場合のエラーをキャッチするサンプルスクリプトがコチラです。

function translateTest(){

  var strTest = "翻訳をして下さい"; //テスト用文字列
  var arr = strTest.split(';'); //セミコロンでsplitして配列に格納

  try{
    var result = LanguageApp.translate(arr[1], "", arr[0]); //翻訳
  }catch(e){
    result = "エラーの内容:" + e;
  }
    Logger.log(result);
}

try～catch文により、LanguageApp.translateがエラー検証の対象になっていて、エラーがない場合はそのまま翻訳結果をログ出力、エラーだった場合はエラーの内容をログ出力する仕組みです。

詳細はこちらの記事をどうぞ。

Google Apps Scriptでエラーが発生したときに処理を分ける方法

Google Apps Scriptでtry～catch文でエラー処理をしていきます。チャットワークの翻訳チャットを例にエラーが発生したかどうかを判定して、エラーによって処理を分ける方法をお伝えします。

エラー処理を追加した翻訳チャットのスクリプト

上記二つのスクリプトを組み合わせて、翻訳チャットにエラー処理を追加したスクリプトがこちらです。

function translateChat() {

  var token = 'APIトークン'; //チャットワークAPIトークン
  var room_id = XXXXXX; //通訳さんのルームID

  var json = fetchMessage(token,room_id); //通訳さんグループチャットのメッセージを取得

  /* 各メッセージについて 繰り返す */
  for each(var obj in json){

    /* 返信に対しては翻訳をしないように正規表現で[rp aid=で始まるメッセージを除外 */
    if(!obj.body.match(/^[rp aid=/)){

      var body = "[rp aid=" + obj.account.account_id
      + " to=" + room_id
      + "-" + obj.message_id
      + "] " + obj.account.name + "さん";
      var arr = obj.body.split(';'); //セミコロンでsplitして配列に格納

       /* translateメソッドでエラーを検証、結果により生成するメッセージを分岐 */
       try{     
       var result = LanguageApp.translate(arr[1], "", arr[0]); //翻訳
         body = body + "[info]翻訳結果：" + result + "[/info]"; //チャットワークに送るテキスト

       }catch(e){
         body = body + "[info][title]翻訳できませんでした[/title]通訳さんのルール：n" +
           "翻訳後の言語コード;本文n" +
           "https://ja.wikipedia.org/wiki/ISO_639-1%E3%82%B3%E3%83%BC%E3%83%89%E4%B8%80%E8%A6%A7[/info]"; //チャットワークに送るテキスト

       }     
       sendMessage(token,room_id,body);
    }
  }
}

以下解説をしていきますね。