ドキュメント本文へスキップ
API

送信したメールのその後を読む

アプリの「アナリティクス」ページに表示されるとおりの、送信したメールのその後。

GET/analytics/sending

実際の呼び出しをワークスペースに対して実行します。

GET /analytics/sending

アプリの「アナリティクス」ページに表示されるとおりの、送信したメールのその後。

例

emails:read が必要です。期間は days(指定がなければ 30、最大 365)か minutes(こちらが優先)で、最も古い区間の始まりから始まります。grain で日、時間、分のいずれかに区切ります。

curl
curl "$OE/analytics/sending?days=7" -H "$AUTH"
レスポンス
{  "object": "sending_analytics",  "since": "2026-09-26T00:00:00.000Z",  "until": "2026-10-02T09:41:00.000Z",  "grain": "day",  "offsetMinutes": 0,  "totals": {    "sends": 412,    "testSends": 3,    "recipients": 498,    "delivered": 486,    "failed": 1,    "bounced": 8,    "complained": 1,    "uncertain": 0,    "pending": 2  },  "days": [    { "day": "2026-10-01", "sent": 74, "delivered": 72, "failed": 0, "bounced": 2, "complained": 0 }  ],  "statuses": [{ "label": "sent", "count": 409 }],  "sources": [    { "label": "api", "count": 288 },    { "label": "composer", "count": 124 }  ],  "senders": [{ "label": "[email protected]", "count": 412 }],  "suppressed": [{ "label": "bounce", "count": 27 }]}

totals は、送信したものとその受信者の数、そしてその結果(配信済み、失敗、バウンス、迷惑メール報告、不確定、保留中)を数えます。days は同じものを区間ごとに持ちます。statuses、sources、senders は送信をステータス別、送信経路別、送信元アドレス別に数え、suppressed は配信停止アドレスを理由別に数えます。

特定のアドレスに限定されたキーやアプリは、そのアドレスから送信されたメールだけを数え、address を指定すると 1 つのアドレスに絞り込みます。

リファレンス