こんにちわ
先日Googleスプレッドシートにある内容を定期的(日次)にChatworkに通知したいというご相談を受けまして、対応してみました。割とやってみたいけどできないなと諦めている人多かったりするんですかね。ということで今回はGoogleスプレッドシートの特定の内容をChatworkに通知する時の段取り、すること、コードのサンプルなども含めてご紹介できたらなと思います。今時点で一つひとつの用語を知らなくても大丈夫なように解説も入れつつご紹介したいなと思いますので是非お付き合いください。
全体的な作業の流れ
スプレッドシートの特定の値をChatworkに通知するためにしたことは以下の様な感じになります。
- ChatworkのAPIトークンを取得する
- GASのChatworkライブラリを追加する
- GASでChatwork通知のコードを書く
- GASのトリガーの設定をする
1. ChatworkのAPIトークンを取得する
解説
Chatworkで自動投稿するためには、投稿用のアカウントを用意しAPIトークンというものを発行する必要があります。APIトークンってそもそも何？という点については、APIトークンについての説明についてはGoogleの生成AIの結果にお任せしたいと思います。
APIトークンは、アプリケーションプログラムインターフェース（API）を使用してアプリケーションやサービスに認証および認可を提供するためのセキュリティの仕組みです。
投稿用のアカウントのAPIトークンを発行することで、投稿用アカウントとして投稿するなど、通常利用時と同様のことができるようになります。
手順
APIトークンの発行手順については以下に掲載されていたので参考にしてみてください。
ここで注意すべきは、
このAPIトークンの文字列を知っている人はそのアカウントの代わりとして使うことができてしまう
かなと思いますので、ご活用の際にはこの点をお気をつけくださいませ。
2. GASのChatworkライブラリを追加する
解説
今回はGoogleスプレッドシートの内容をChatworkに通知したいので、その情報を持っているスプレッドシートのGAS(Google Apps Script)を使って投稿できるようにしたいと思います。一からコードを書くこともできるのですが、今回はCharworkに投稿するための機能をライブラリとしてまとめてくださっている方がいたのでそちらを使わせて頂くこととします。
https://github.com/cw-shibuya/chatwork-client-gas
このライブラリを使ってできることについては以下のファイルのコメントにまとめられていましたので一度参照してみると良いかと思います。
https://github.com/cw-shibuya/chatwork-client-gas/blob/master/client.js
手順
スプレッドシートの上部メニューの[拡張機能] > [AppsScript]を選択します
ライブラリの[+]ボタンを押下して、先程のGASのライブラリのスクリプトIDを入力して検索、追加します。
スクリプトID : 1nf253qsOnZ-RcdcFu1Y2v4pGwTuuDxN5EbuvKEZprBWg764tjwA5fLav
(GitHubのリポジトリに記載してあるIDと一致します)
以下の様にライブラリに「ChatWorkClient」が追加されていると思います。バージョンは記事記載時の最新で19でしたが最新を使うのが良いと思います。
ここまでの準備ができるとChatworkClientのライブラリを使えるようになっているので、コードを書いていくことができます。
なのですが、、長くなってきたので、残りについては後編として分けたいと思います。次回はChatworkに投稿するサンプルコードも合わせてご説明したいなと思います。
でわでわ！