SlackからDiscordに移行するので、Googleカレンダーの予定のアップデートをDiscordへ通知する
概要
今まで家族内の連絡その他にSlackを使っていたけど、無料だと90日分しか過去ログが参照できなくなったことを期に、Discordへ移行を検討することに。
シンプルに済ますなら、IFFFTでもカレンダーのアップデートをDiscordへ通知することはできた。
でも既存のレシピじゃないので枠を消費するし、複数人のカレンダーを読むには人数分の枠が必要・・・
IFFFTの枠はIoTとかのために残しておきたい。
調べたら、ただメッセージ送るだけなら、Bot作るまでもなく、Incoming Webhook使えばいいじゃんということみたい。
というわけで、自宅サーバで動くようにしてみる。
また、今回はPythonを少しいじるが、自分はPythonほとんど書いたことないので、AIの力を借りてみる。
前段
Googleカレンダーからの情報取得の方法をググると、いくつかの方法が出てくる。
ここで考えるのは大きく2点。
一つはAPIキーを使うか、OAuthを使うか？
もう一つはOAuthするとして、アカウントを個人アカウントにするか、サービスアカウントにするか？
まずAPIキーは、公開カレンダーに匿名でアクセスする前提になる。公開して良いカレンダーで、誰がアクセスしたかわからなくても良いのであれば、一番楽。
今回はプライベートなカレンダーの情報を取得するので却下。
で、OAuthを使うことになるが、個人アカウントとしてAPIアクセスするか？サービスアカウントとしてアクセスするか？です。
例えばそれぞれが個人アカウントを持っていて、特定の代表者が各人のカレンダーを自身のGoogleカレンダーウェブアプリ上で表示しているような場合で、かつ代表者がカレンダー情報をまとめて取得するような場合には、個人アカウントとしてのAPI利用で十分。
こちらのサイトがわかりやすかったです。
APIキー、OAuthクライアントID、サービスアカウントキーの違い:Google APIs - 無粋な日々に
2023/1/26追記
個人アカウントだと7日でトークンが失効します。サービスアカウントで実装するほうが良いです。
コードも結果的に短くてすみます。
最後に補足しています。
実装
Discordの対応方法
Webhookの作り方は公式のここに書いてあります。
Intro to Webhooks
チャンネルに紐づくので、チャンネルの設定で「連携サービス」を選択すれば、そこにウェブフックの設定がいます。
すでにウェブフックが一ついると思うので、これを利用します。
アバター画像は、テキスト投稿時にURL指定もできる。公開されていない画像の場合はここでアップロードしておく。
今回はGoogleカレンダーのアイコンを設定。
Webhookに投げる方法は、こちらにすべてがあり、とても参考になります。
DiscordにWebhookでいろいろ投稿する - Qiita
ぼくはシェル芸で書きたいので、curlでできる方法を公式から引っ張ってきます。
Discord Webhooks Guide
Googleの対応方法
Googleカレンダーへのアクセスについては、基本的にはクイックスタートガイドどおりにやればいい説
Python quickstart | Google Calendar | Google Developers
Google CloudでAPIを有効にして、認証を作成、credentials.jsonを作成。
Googleへアクセスするためのライブラリをインストールすれば環境作成はOK。
サンプルコードを一度実行すると、実行ディレクトリにアクセストークンtoken.jsを作成してくれる。
トークンを作成するために、サンプルコードを実行するとローカルでサーバを実行して、待機状態になる。
ブラウザを開いて権限を承認すると、http://localhost/へリダイレクトして、トークンが作成される。
最初DevContainer内で実行していたんだけど、リダイレクト先のポートが毎回変更されるので、コンテナのポートフォワーディング設定ができず、断念。
コンテナ外でtoken.jsを作成した。
credentials.jsonとtoken.jsは、別環境経もコピーして持っていけば認証に使えるので、サーバで実装するときはコピーすればOK。
逆に言えば、.gitignoreに追加する等、他人に渡らないようにしないといけない。
Pythonの実装
設計としては、今以降の予定をすべて取得する→前回の取得結果とdiff→差分を通知。
予定の取得はPythonのサンプルコードをベースに修正する。
ここで、最近はやりのAIを使ってみることにした。
サンプルコードは「今以降の10件の予定を取得する」コードだけど、今回は「指定したカレンダーの、今以降のすべての予定を取得」したい。
まず試しにChatGPTに、サンプルコードの説明をしてもらう。
次のコードの説明をしてと書いて、コードをベタ貼り。
すご・・・
次に、このコードを、コマンドライン引数でカレンダーIDを指定できるようにしてとお願いして出てきたコードがこれ
from __future__ import print_function
import datetime
import os.path
import sys
from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError
# If modifying these scopes, delete the file token.json.
SCOPES = ['https://www.googleapis.com/auth/calendar.readonly']
def main():
"""Shows basic usage of the Google Calendar API.
Prints the start and name of the next 10 events on the user's calendar.
"""
if len(sys.argv) < 2:
print("Please provide a calendar ID as a command line argument.")
return
calendar_id = sys.argv[1]
creds = None
# The file token.json stores the user's access and refresh tokens, and is
# created automatically when the authorization flow completes for the first
# time.
if os.path.exists('token.json'):
creds = Credentials.from_authorized_user_file('token.json', SCOPES)
# If there are no (valid) credentials available, let the user log in.
if not creds or not creds.valid:
if creds and creds.expired and creds.refresh_token:
creds.refresh(Request())
else:
flow = InstalledAppFlow.from_client_secrets_file(
'credentials.json', SCOPES)
creds = flow.run_local_server(port=0)
# Save the credentials for the next run
with open('token.json', 'w') as token:
token.write(creds.to_json())
try:
service = build('calendar', 'v3', credentials=creds)
# Call the Calendar API
now = datetime.datetime.utcnow().isoformat() + 'Z' # 'Z' indicates UTC time
print('Getting the upcoming 10 events')
events_result = service.events().list(calendarId=calendar_id, timeMin=now, singleEvents=True, orderBy='startTime').execute()
events = events_result.get('items', [])
if not events:
print('No upcoming events found.')
return
# Prints the start and name of the next 10 events
for event in events:
start = event['start'].get('dateTime', event['start'].get('date'))
print(start, event['summary'])
except HttpError as error:
print('An error occurred: %s' % error)
if __name__ == '__main__':
main()
実際には多少修正する必要はあったけど、要はsysをインポートして引数を取得すれば良いということがサクッとわかるので、それだけでタスカル・・・！
Python詳しくなくてもできちゃうじゃん。
シェルスクリプトの実装
スクリプトはこちら。
#!/bin/bash -xvu
# カレンダーからイベントを取得して、差分をDiscordに通知する
# 初期設定
tmp=$(mktemp)
work_dir="$(dirname $0)" # スクリプトのあるディレクトリ
filename="$(basename $0)" # スクリプトのファイル名
mkdir -p ${work_dir}/log # ログディレクトリ
exec 2> ${work_dir}/log/${filename}.$(date +%Y%m%d_%H%M%S) # 標準エラー出力をログファイルに出力
cd ${work_dir}
# 外部の変数ファイルを取得
source ${work_dir}/keys.sh
# カレンダーイベントの取得
cat ${work_dir}/target_calendars.txt |
while read calendar_id; do
python3 ${work_dir}/get_event_gcal.py ${calendar_id} > $tmp-${calendar_id}_events
# 過去のデータを取得して、差分を抽出
if [ -s ${work_dir}/events_old/${calendar_id}_events ]; then
diff ${work_dir}/events_old/${calendar_id}_events $tmp-${calendar_id}_events > $tmp-${calendar_id}_diff
fi
# 差分があればDiscordに通知
if [ -s $tmp-${calendar_id}_diff ]; then
while read line; do
if [ "${line:0:1}" = ">" ]; then
# Discordに通知
curl -X POST -H "Content-Type: application/json" -d "{\"content\": \"${line:2}\"}" ${DISCORD_WEBHOOK_URL}
fi
done < $tmp-${calendar_id}_diff
fi
# 今回の結果を過去データとして保存
mkdir -p ${work_dir}/events_old
mv $tmp-${calendar_id}_events ${work_dir}/events_old/${calendar_id}_events
done
# 一時ファイルの削除
rm -f $tmp-*
# 終了
exit 0
コメントに書いてある通りの処理ですが、複数のカレンダーから予定を取得して、それぞれをテキストに毎回保存。
前回の保存結果とdiffを取り、差分をDiscordへ投稿します。
Discordへの通知は、公式サイトの処理のまま、1行ずつ投げています。
Discord Webhooks Guide
ちなみに、このスクリプトをChatGPTさんに説明してもらうと、こう。
その日の予定一覧を取得するコードも、Githubに上げてあります。
よければどうぞ。
https://github.com/ka-zuu/GoogleCalendar_to_Discord
最後に、crontabに登録して終了。
予定を追加すると、通知が来ます。
まとめ
GoogleカレンダーからDiscordへの通知ができるようになりました。
OAuthのAPIは面倒だけど、ウェブフックは楽で良い。
あと、ChatGPTの可能性は大いに感じることができました。
ちなみに今回はGithub Copilotも使っていて、コードのサジェストがいちいち素敵でコーディングが楽しい。
プログラマの世界が変わっていく潮目を感じました！
次回はAlexaの買い物リストをDiscordに通知するお話です。
Copilotを絡めて書いてみたい。
2023/1/26追記
トークンが失効した・・・。Refresh Tokenがあるから再度アクセスできるはずが・・・？
google.auth.exceptions.RefreshError: ('invalid_grant: Token has been expired or revoked.', {'error': 'invalid_grant', 'error_description': 'Token has been expired or revoked.'})
と思ったら、以下の場合には7日間で失効するらしい。
- OAuth 2.0 クライアント ID を利用していて、
- OAuth 同意画面の公開ステータスが「テスト」のままで（未公開で）、
- 同じく同意画面のユーザーの種類が「外部」
Google API で Token has been expired or revoked. のエラー
サービスアカウントを作って対応することにする・・・
サービスアカウントでアクセスするための修正
サービスアカウントで接続する場合、Credentialsメソッドを呼び出すためのオブジェクト指定が変わるらしい。
Google APIの利用で Client secrets must be for a web or installed app. と怒られる
上記では、Googleのサンプルコードを修正しているが、以下のサイトを見ると、tokenの取得フローって不要になるっぽい？
【Python】GoogleカレンダーAPIを操作して予定の取得・追加をする方法
ChatGPTに聞いてみる
ChatGPTさんもtokenはいらないって言っている。
ただ、Credentialsメソッドはサービスアカウント用のオブジェクトのものを使うので、from google.oauth2.service_account import Credentialsに修正。
Pythonを修正
あとは、前に作成したコードと同様に、引数からカレンダーIDを受け取るようにすることと、今以降のすべての予定を取得するように修正する。
修正したコードはGithubで。
Discussion