تخطَّ إلى المستندات
خادم MCP

التحليلات

كيف يصل البريد، وما آل إليه البريد المرسَل.

أدوات التحليلات

الأداةما تفعله
getMailboxInsightsكيف يصل البريد خلال فترة، كما تعرضه صفحة التحليلات: لكل يوم ولكل ساعة، وحسب العنوان وحسب المُرسِل، وما ينتظر ردًّا، والمجلدات.
getSendingAnalyticsما آل إليه البريد الذي أرسلته مساحة العمل خلال فترة، كما تعرضه صفحة التحليلات: ما سُلِّم وما فشل وما ارتدّ وما تلقّى شكوى، لكل يوم.

تتطلب قراءة كيفية وصول البريد «قراءة المحادثات والرسائل» (threads:read)، وتتطلب قراءة ما آل إليه البريد المرسَل «قراءة الرسائل المرسلة وحالة تسليمها» (emails:read). والعميل المقصور على بعض العناوين لا يعدّ إلا البريد الذي وصل إليها أو أُرسل منها، ويضيّق address أيًّا منهما إلى عنوان واحد.

المرجع

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()