PythonでGoogle Schedule APIを扱う

Google Schedule API

ここからプロジェクト作成と API の有効化を行なう。

OAuth 2.0 の認証情報を設定し、最後に認証情報を JSON として保存。

すると、以下のような JSON ファイルがダウンロードされるはず。

1
{
2
  "installed": {
3
    "client_id": "XXXXXXXXXXX-YYYYYYYYYYYYYYYYY.apps.googleusercontent.com",
4
    "project_id": "local-reference-XXXXXX",
5
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
6
    "token_uri": "https://oauth2.googleapis.com/token",
7
    "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
8
    "client_secret": "ZZZZZZZZZZZZZZZZZZZZ",
9
    "redirect_uris": ["urn:ietf:wg:oauth:2.0:oob", "http://localhost"]
10
  }
11
}

取得した JSON を適当に credentials.jsonという名前に変更。この名前にするのは特に理由はなくて、Google のチュートリアルがそうなっているから。

Python で実装

一番ラクなのは Python なので Python でいろいろ動かしていきます。

1
from __future__ import print_function
2
from datetime import datetime
3
import os.path
4
import json
5
from googleapiclient.discovery import _discovery_service_uri_options, build
6
from google_auth_oauthlib.flow import InstalledAppFlow
7
from google.auth.transport.requests import Request
8
from google.oauth2.credentials import Credentials
9

10
# カレンダーに対して読み書きできるスコープを設定
11
SCOPES = ["https://www.googleapis.com/auth/calendar"]
12

13

14
def main():
15
    # 初回起動は token.jsonがないので認証が必要になる
16
    creds = None
17

18
    if os.path.exists("token.json"):
19
        creds = Credentials.from_authorized_user_file("token.json", SCOPES)
20
    if not creds or not creds.valid:
21
        if creds and creds.expired and creds.refresh_token:
22
            creds.refresh(Request())
23
        else:
24
            flow = InstalledAppFlow.from_client_secrets_file(
25
                "credentials.json", SCOPES)
26
            creds = flow.run_local_server(port=0)
27
        # 二回目以降は token.json を読み込む
28
        with open("token.json", "w") as token:
29
            token.write(creds.to_json())
30

31
    service = build("calendar", "v3", credentials=creds)
32

33

34
if __name__ == "__main__":
35
    main()

実行すると認証用の URL にとばされる。このとき、たとえプロジェクトを作成したアカウントであっても信頼できるユーザに追加されていないとアクセスが拒否されてしまう。

OAuth 同意画面から「信頼できるユーザ」として追加するのを忘れないようにしておこう。

予定の書き込み

予定を書き込むには以下のフォーマットが使える。

1
body = {
2
    "summary": "SUMMARY"
3
    "start": {
4
        "dateTime": "START TIME WITH ISO FORMAT",
5
        "timeZone": "TIMEZONE"
6
    },
7
    "end": {
8
        "dateTime": "END TIME WITH ISO FORMAT",
9
        "timeZone": "TIMEZONE"
10
    },
11
}
12
event = service.events().insert(calendarId="primary", body=body).execute()

カレンダー ID はprimaryを設定しているけれど、自分が作成したカレンダー ID なら何でも使えます。

例えば以前に解説したサーモンランのシフトのカレンダーの ID は9ojdd871h0bjhutscdulijib1g@group.calendar.google.comになります。この値はカレンダーの設定から「カレンダーの統合」を参照すれば見ることができます。

colorIdなどで色を付けることもできるのですが、共有すると色の設定は消えてしまうのであまり意味がなかったりします。あくまで個人用の設定です。

サーモンランのシフトをカレンダーに登録するときは UNIX のタイムスタンプを ISO フォーマットに変換して～という処理を行いました。

変換自体は以下のようなコードで行なえます。

1
from datetime import datetime
2

3
start_time = datetime.fromtimestamp(schedule["start_time"]).isoformat()

もしもコードを全文見たい方がいればGitHub Gistで公開しているのでご自由に改変してどうぞ。

Salmonia シリーズでも利用している第 1 回から第 914 回までの全シフトの情報もついでに公開しているのでご自由にご利用下さい。

というかこれ、次のシフトが公開されたときに自分でまたカレンダーに登録するために使いそうですね。

記事は以上。