Shukei

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

##How to Join

⚠️ @uniba.jp アカウントを持つユーザのみが利用可能な β 版です。
https://app.shukei.uni.ba からサインアップしてください。

##Data Usage

集計された活動時間は Web API 経由でアクセスできます。
OpenAPI 形式の仕様書もあります。

### 基本的な考え方

以下の 4 種の視点をクエリパラメータとして指定してください。

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

### 例 1：foo と bar の、今年の活動サンプルリクエスト

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

users: foo@example.com, bar@example.com
since: 2025-01-01
until: 2026-01-01
interval: month
units: minutes

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

月初の日付がキーとして使われます。
untilで指定した日は含まれません。
セルの値の単位は units パラメータに従います。

### 例 2：foo と bar の、SHUKEI に対する今週の活動サンプルリクエスト

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

users: foo@example.com, bar@example.com
filterTags: SHUKEI
since: 2025-09-01
until: 2025-09-08
interval: day
units: minutes

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 で指定するイメージです。

### 例 3：活動 SHUKEI と活動 UNIBA の、今年の活動サンプルリクエスト

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

tags: SHUKEI, UNIBA
since: 2025-01-01
until: 2026-01-01
interval: month
units: hours

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

タグ x 期間（月）の表
	2025-01-01	2025-02-01	2025-03-01	...	2025-12-01
SHUKEI	20.5	21.75	23.25	...	24.5
UNIBA	38.25	35.5	41.75	...	40.25

例 1, 2 と異なり、tagのエンドポイントでは、縦の行がタグになります。
横の列が時系列なのは変わりません。

### 例 4：活動 SHUKEI と活動 UNIBA の、foo と bar による今月の活動サンプルリクエスト

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

tags: SHUKEI, UNIBA
filterUsers: foo@example.com, bar@example.com
since: 2025-09-01
until: 2025-10-01
interval: week
units: hours

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

タグ x 期間（週）の表
	2025-09-01	2025-09-08	2025-09-15	2025-09-22	2025-09-29
SHUKEI	12.5	15.75	14.25	16.5	3.25
UNIBA	18.75	20.25	19.5	21.75	4.5

filterUsersに指定されたユーザに関する時間のみが集計されます。

### フラット形式での取得サンプルリクエスト

テーブル形式ではなく、フラットなリスト形式でデータを取得したい場合は、 GET /api/calendar-events/rollups/user/flat または GET /api/calendar-events/rollups/tag/flat を使います。
クエリパラメータは通常のエンドポイントと同じです。

レスポンスは 2 次元のテーブルではなく、各セルを個別のオブジェクトとして並べたフラットな配列になります。集計済みデータをスプレッドシートや外部ツールに読み込む際に便利です。

### 🔒 予定一覧の取得

集計値ではなく、予定情報そのものの一覧を返す API もあります。
認証が必要で、現在試験運用中です。

#Shukei（集計）

##How to Join

##Data Usage

### 基本的な考え方

### 例 1：foo と bar の、今年の活動サンプルリクエスト

### 例 2：foo と bar の、SHUKEI に対する今週の活動サンプルリクエスト

### 例 3：活動 SHUKEI と活動 UNIBA の、今年の活動サンプルリクエスト

### 例 4：活動 SHUKEI と活動 UNIBA の、foo と bar による今月の活動サンプルリクエスト

### フラット形式での取得サンプルリクエスト

### 🔒 予定一覧の取得

## FAQ

#Shukei（集計）

##How to Join

##Data Usage

### 基本的な考え方

### 例 1：foo と bar の、今年の活動 サンプルリクエスト

### 例 2：foo と bar の、SHUKEI に対する今週の活動 サンプルリクエスト

### 例 3：活動 SHUKEI と活動 UNIBA の、今年の活動 サンプルリクエスト

### 例 4：活動 SHUKEI と活動 UNIBA の、foo と bar による今月の活動 サンプルリクエスト

### フラット形式での取得 サンプルリクエスト

### 🔒 予定一覧の取得

## FAQ

### 例 1：foo と bar の、今年の活動サンプルリクエスト

### 例 2：foo と bar の、SHUKEI に対する今週の活動サンプルリクエスト

### 例 3：活動 SHUKEI と活動 UNIBA の、今年の活動サンプルリクエスト

### 例 4：活動 SHUKEI と活動 UNIBA の、foo と bar による今月の活動サンプルリクエスト

### フラット形式での取得サンプルリクエスト