miyauchidp.dev

著者: miyauchi(本サイト・各ツールの開発者)

公開 / 更新

duel-logger の対戦記録を Google スプレッドシートに同期する

duel-logger に記録した対戦データを Google スプレッドシートへ自動エクスポートする機能の仕組みと、同期したデータの活用方法を解説します。

duel-logger に対戦を記録していくと、勝率の推移や先攻後攻の傾向はアプリの集計ページで確認できます。ただし、記録した対戦を自分の好きな形式で並べ替えたい、独自の集計式でグラフを作りたい、あるいは万一に備えて記録を別の場所にも残しておきたいといった場面では、アプリの中だけでは対応しきれません。duel-logger にはこうした場面のために、記録した対戦データを Google スプレッドシートへ同期する機能があります。この記事では、同期機能で何ができるのか、安全性はどう確保されているのか、そして同期したスプレッドシートをどう活用できるのかを解説します。

対戦記録が自動でスプレッドシートに書き出される

同期を設定すると、対戦を記録するたびにその内容がスプレッドシートへ自動的に書き出されます。手動でエクスポートする必要はなく、記録した対戦が順次スプレッドシート側にも反映されていきます。

同期機能を使うには、Google アカウントでのログインが前提です。duel-logger 自体がログインしないと対戦記録を保存できない仕組みになっているため、記録を始めた時点ですでに同期を使う準備は整っています。

duel-logger の紹介ページ(/about)に掲載されているサンプル表示。「Google Sheetsに出力」カード(「同期先」欄はGoogle Sheets、「自動エクスポート」欄は有効)と、隣に並ぶ「集計結果をURLで共有」カードが表示されている

duel-logger の紹介ページに掲載されている機能カードです。この記事の画面はいずれも紹介ページの表示例です。左が Google スプレッドシートへの同期、右が集計結果の URL 共有です。

同期で求められる権限は限定的

対戦記録のような個人データを外部のスプレッドシートに送るとなると、どこまで広い権限が必要になるのか気になるところです。duel-logger が Google アカウントのログインで求めるのはメールアドレスやプロフィールなどの基本情報だけで、Google ドライブ全体を読み書きする権限は求めません。同期は、書き出し先のスプレッドシートを duel-logger 専用のサービスアカウントに共有する方式です。duel-logger がアクセスできるのは、その共有されたスプレッドシートだけです。

スプレッドシート側でできること

対戦記録がスプレッドシートに並ぶと、あとは一般的なスプレッドシートの機能をそのまま使えます。列を自由に並べ替えて特定の期間だけを見る、関数を使って duel-logger にはない独自の集計式を組む、グラフ機能で勝率の推移を可視化するといった加工が可能です。対戦記録を長期間保持しておく手元のバックアップとしても使えます。

こうした加工や集計は duel-logger 自体の機能ではなく、あくまで書き出し先のスプレッドシートが一般的に備えている機能です。duel-logger は記録と同期までを担い、そこから先の自由な加工はスプレッドシート側に任せる、という役割分担です。

CSVでエクスポート・インポートする

スプレッドシート同期とは別に、同じ同期ページから対戦記録をCSVファイルとして直接やり取りすることもできます。エクスポートは記録を CSV としてダウンロードする機能で、スプレッドシートの連携なしに表計算ソフトや自作のスクリプトでデータを加工したい場合に使えます。インポートは逆に CSV から対戦記録を取り込む機能です。実行前に取り込み内容のプレビューが表示されるので、内容を確認してから反映できます。過去に別の方法で付けていた戦績の移行や、バックアップからの復元に向いています。

アプリ内の集計とスプレッドシートの使い分け

日々の対戦後に「今のところ先攻と後攻どちらの勝率が高いか」といった調子を確認したいだけであれば、duel-logger の集計ページで十分です。直近の件数や種別、デッキ、期間で絞り込みながら、状況別の勝率をその場で確認できます。

一方で、シーズンをまたいだ長期的な傾向を追いたい場合や、複数のデッキを横断して自分なりの基準で比較したい場合には、スプレッドシート側で加工したほうが柔軟です。日常の勝率確認はアプリで、突っ込んだ分析や長期的な記録の保持はスプレッドシートで、という使い分けができます。

duel-logger の紹介ページ(/about)に掲載されているサンプルの集計画面。直近件数、種別、期間の絞り込みタブと、状況別勝率として先攻77%(223-65)、後攻35%(110-201)が表示されている

集計ページの表示例です。日々の勝率確認はここで完結し、踏み込んだ加工をしたいときにスプレッドシートを使います。

集計結果の URL 共有

duel-logger には、スプレッドシートへの同期とは別に、集計ページで絞り込んだ条件を URL として共有する機能もあります。具体的な戦績を含めるかどうかを切り替えられるため、勝率の傾向だけを他の人に見せたいときに使えます。詳しくは対戦記録と勝率分析の記事で紹介しています。

この記事で紹介した duel-logger は無料で利用できます。機能の一覧は紹介ページをご覧ください。

記事内容に誤りを見つけた場合は お問い合わせ から報告してください。