API
メールの届き方を読む
アプリの「アナリティクス」ページに表示されるとおりの、メールの届き方。
GET/analytics/mailbox
実際の呼び出しをワークスペースに対して実行します。
GET /analytics/mailbox
アプリの「アナリティクス」ページに表示されるとおりの、メールの届き方。
例
threads:read が必要です。期間は、from と to で指定しない限り直近 30 日で、日ごとに区切られ、grain を使えば時間や分ごとに区切られます。offsetMinutes には、読み手の UTC から東へのオフセットを分単位で渡してください。1 日の区切りが読み手の 1 日に合うようになります。
curl "$OE/analytics/mailbox?offsetMinutes=120" -H "$AUTH"{ "object": "mailbox_insights", "from": "2026-09-02T09:00:00.000Z", "to": "2026-10-02T09:00:00.000Z", "grain": "day", "offsetMinutes": 120, "scanned": 486, "days": [ { "day": "2026-09-30", "count": 21 }, { "day": "2026-10-01", "count": 17 } ], "hours": [ { "hour": 9, "count": 64 }, { "hour": 14, "count": 51 } ], "addresses": [{ "address": "[email protected]", "count": 301 }], "senders": [ { "email": "[email protected]", "name": "Ada Lovelace", "count": 18, "lastAt": "2026-10-01T16:20:11.000Z" } ], "senderCount": 132, "waiting": [ { "band": 1, "count": 6 }, { "band": 3, "count": 2 }, { "band": 7, "count": 1 } ], "unattributed": 0, "folders": [{ "label": "inbox", "count": 412, "unread": 9 }], "series": []}scanned は期間内に届いた会話を数えます。days はそれを区間ごとに、hours は 1 日の時間帯ごとに振り分け、addresses は届いたアドレス別に数え、senders は最も多く書いてきた人を挙げます。waiting は 1 日、3 日、7 日を過ぎてもまだ返信を待っている会話を数え、folders は各フォルダーの中身を示します。
特定のアドレスに限定されたキーやアプリは、そのアドレスに届いたメールだけを数えます。address はすべてを 1 つのアドレスに絞り込み、キーの届く範囲外のアドレスを指定しても失敗せず、何も数えません。