本日Googleが、Inbox by Gmailのクローズを発表しました。
これまで毎日お世話になってきたのですが、今後アップデートされないならGmailに移行するしかないかなと思っています。
Inboxにはいくつかの独自機能があり、その中のリマインダー（Google Reminders）は、後継のサービスであるGoogle ToDoにデータが移行されません。
エクスポートしようにも、APIも用意されていないので困ってしまいました。。
色々試した結果、Google Calendarの通信を解析し、GoogleのクローズドAPIを使用することでデータのエクスポートが可能だったのでやり方をまとめます。
ポイント
-
https://inbox.google.com/ が使用するAPIのエンドポイントは
https://inbox.google.com/sync/u/0/i/bvというような独特の形式だったので、オープンAPIに近い形式のGoogle CalendarのAPIを使用 - 認証情報はブラウザーでログインしているものをそのまま使うと簡単
- タイムスタンプはミリ秒の単位で表記
Google Calendarが使うクローズドAPI
Googleカレンダーを開き「マイカレンダー」の中の「リマインダー」にチェックを入れ、まずはリマインダーを表示させます。
Chromeデベロッパーツールの「Network」タブを開くと、沢山の通信が行われていますので、検索ポックスに「reminders/list」と入力すると該当の通信を見つけられます。
list?key=XXX というような名前の通信を見つけて、右クリックし、「Copy」、「Copy as cURL」とメニューをクリックしていくことで、cURL用のコマンドがコピーできます。
これには、Cookieなど認証情報も含まれていますので、そのままペーストすればCLIで認証に悩まされず済みます。
以下のようなコマンドがコピーされるはずです（ユーザーごとに違う値は XXX に置き換え）。
curl 'https://reminders-pa.clients6.google.com/v1internalOP/reminders/list?key=XXX' \
-H 'cookie: SID=XXX; HSID=XXX; SSID=XXX; APISID=XXX; SAPISID=XXX; NID=XXX; 1P_JAR=XXX; SIDCC=XXX' \
-H 'origin: https://reminders-pa.clients6.google.com' \
-H 'accept-encoding: gzip, deflate, br' \
-H 'x-origin: https://calendar.google.com' \
-H 'accept-language: XXX' \
-H 'authorization: SAPISIDHASH XXX' \
-H 'x-requested-with: XMLHttpRequest' \
-H 'x-client-data: XXX' \
-H 'x-goog-authuser: XXX' \
-H 'pragma: no-cache' \
-H 'x-clientdetails: appVersion=XXX&platform=XXX&userAgent=XXX' \
-H 'x-goog-encode-response-if-executable: base64' \
-H 'user-agent: XXX' \
-H 'content-type: application/json+protobuf' \
-H 'accept: */*' \
-H 'cache-control: no-cache' \
-H 'authority: reminders-pa.clients6.google.com' \
-H 'referer: https://reminders-pa.clients6.google.com/static/proxy.html?usegapi=XXX&jsh=XXX' \
-H 'x-javascript-user-agent: google-api-javascript-client/1.1.0' \
-H 'x-referer: https://calendar.google.com' \
--data-binary '{"1":{"4":"WRP / /WebCalendar/calendar_180906.14_p2"},"2":[{"1":3},{"1":16},{"1":1},{"1":8},{"1":11},{"1":5},{"1":6},{"1":13},{"1":4},{"1":12},{"1":7},{"1":17}],"5":0,"6":100,"16":"XXX"}' \
--compressed
リクエストの内容は --data-binary のJSONに記述されていることがわかります。
リクエスト内容の詳細
リクエストのJSONを整形して見てみましょう。
{
"1": {
"4": "WRP / /WebCalendar/calendar_180906.14_p2"
},
"2": [
{
"1": 3
},
{
"1": 16
},
{
"1": 1
},
{
"1": 8
},
{
"1": 11
},
{
"1": 5
},
{
"1": 6
},
{
"1": 13
},
{
"1": 4
},
{
"1": 12
},
{
"1": 7
},
{
"1": 17
}
],
"5": 0,
"6": 100,
"16": "1514732400000"
}
数字で表記されているため意味不明ですが、推測しながら検証してみた結果、以下のような意味でした。
14、24、25はリマインダーのステータスが完了の場合に使用します。
ちなみに、このような数字で表記されているのはProtocol Bufferで実装されたAPIだからだと予想されます。
| 意味 | 必須 | デフォルト | |
|---|---|---|---|
| 1 | リクエスト元の情報 | False | |
| 2 | 取得するデータ | False | |
| 5 | リマインダーのステータス（0：未完了のみ／1：完了も含める） | False | 0 |
| 6 | 取得最大件数 | False | 100 |
| 14 | 不明 | False | |
| 16 | 範囲指定（終了日時） | False | すべて |
| 24 | 範囲指定（終了日時） | False | すべて |
| 25 | 範囲指定（開始日時） | False | すべて |
実際のリクエスト
実際のリクエストとしてオススメは、以下の形です。
省略した部分はブラウザーからコピーしたままを使用してください。
curl --data-binary '{"5": 1, "6": 10000}' \
> reminders.json
おまけ
エクスポートしたデータを jq などで整形すると必要なデータだけ取り出せて便利です。
例えば、リマインダーの内容だけを抜き出すには以下のようにします。
cat reminders.json | jq '.["1"][]["3"]'