Shukei

Google Calendar から「タグ」を収集して、活動時間を集計します。

##How to Join

##Data Usage

集計された活動時間は Web API 経由でアクセスできます。
以下の 3 種の視点をクエリパラメータとして指定してください。

これらの組み合わせに対応する「ユーザ x 期間」「タグ x 期間」のテーブル構造のデータを返します。
テーブルのセルには活動時間の集計値が入ります。

GET /api/calendar-events/rollups/userを使います。

foo と bar の活動時間が月別に集計されました。

ユーザ x 期間（月）の表
	2025-01-01	2025-02-01	2025-03-01	...	2025-12-01
foo@example.com	2000	1800	2200	...	2100
bar@example.com	1500	1600	1700	...	1800

同様に GET /api/calendar-events/rollups/userを使います。

foo と bar の活動時間が日別に集計されました。

ユーザ x 期間（日）の表
	2025-09-01	2025-09-02	2025-09-03	...	2025-09-07
foo@example.com	100	150	200	...	120
bar@example.com	80	90	110	...	130

filterTagsに指定されたタグに関する時間のみが集計されます。
例 1 と同様、userのエンドポイントではユーザが縦の行になり、誰を選ぶかは users で指定し、集計範囲を filterTags で指定するイメージです。

GET /api/calendar-events/rollups/tagを使います。

SHUKEI と UNIBA の活動時間が月別に集計されました。

タグ x 期間（月）の表
	2025-01-01	2025-02-01	2025-03-01	...	2025-12-01
SHUKEI	1200	1300	1400	...	1500
UNIBA	2300	2100	2500	...	2400

同様に GET /api/calendar-events/rollups/tagを使います。

SHUKEI と UNIBA の活動時間が日別に集計されました。

タグ x 期間（日）の表
	2025-09-01	2025-09-02	2025-09-03	...	2025-09-07
SHUKEI	180	240	310	...	250
UNIBA	150	160	140	...	170

集計値ではなく、予定情報そのものの一覧を返す API もありますが、こちらは認証が必要です。

## FAQ

認証なしでアクセスできる API は危なくないの？: 活動時間の集計テーブルを返す API のパラメータは、取得したいユーザやタグを直接指定する必要があり、それに関連するデータのみが集計されます。また、登録されているタグ一覧やユーザ一覧を取得する方法はありません。つまり「自分がそもそも把握していないユーザのメールアドレスやタグが見えてしまう」ことはありません。仮に総当たり攻撃等でメールアドレスやタグを特定したとしても、集計値以外の情報は得られません。
どんな予定がデータベースに保存されるの？: ブラケット[ ]で囲まれたタグをタイトルに含む（終日でない）予定のみが保存されます。