ドキュメント本文へスキップ
MCPサーバー

アナリティクス

メールの届き方と、送信したメールのその後。

アナリティクスのツール

ツール機能
getMailboxInsights期間内のメールの届き方を、「アナリティクス」ページと同じ形で返す: 日別と時間帯別、アドレス別と送信者別、返信を待っているもの、そしてフォルダー。
getSendingAnalytics期間内にワークスペースが送信したメールのその後を、「アナリティクス」ページと同じ形で返す: 配信済み、失敗、バウンス、迷惑メール報告を日ごとに。

メールの届き方を読むには「スレッドとメッセージを読み取る」(threads:read)、送信したメールのその後を読むには「送信済みメッセージと配信状況を読み取る」(emails:read)が必要である。一部のアドレスに限定されたクライアントは、それらのアドレスに届いたメールか、それらのアドレスから送信されたメールだけを数え、address はどちらも 1 つのアドレスに絞り込む。

リファレンス

getMailboxInsights

スコープthreads:readアプリのアシスタントは確認せずに実行しますツールキットinsights

How mail arrives, as the Analytics page shows it: how many conversations came in over a window and on which days, the busiest hours, the addresses they arrived at, the senders who wrote most, how many wait on a reply, and the folders. from and to are ISO 8601 instants and default to the last 30 days. offsetMinutes is the reader’s minutes east of UTC, so days break where theirs do. address narrows it to one address.

入力

fromstring
形式date-time
tostring
形式date-time
grainstring
次のいずれか"minute""hour""day"
offsetMinutesinteger
-840以上840以下
addressstring
3〜320文字

ほかの提供先

API
GET /analytics/mailbox
SDK
analytics.mailbox()

getSendingAnalytics

スコープemails:readアプリのアシスタントは確認せずに実行しますツールキットinsights

What became of the mail this workspace sent, as the Analytics page shows it: how many went out over a window and how many were delivered, failed, bounced or complained about, per day, with the statuses, where they came from, the addresses they went out as and the addresses suppressed. days defaults to 30, minutes wins over days, and address narrows it to the mail sent from one address.

入力

daysinteger
1以上365以下
minutesinteger
1以上525600以下
grainstring
次のいずれか"minute""hour""day"
offsetMinutesinteger
-840以上840以下
addressstring
3〜320文字

ほかの提供先

API
GET /analytics/sending
SDK
analytics.sending()