REST Resource: domains.trafficStats

منبع: TrafficStats

آمار ترافیک ایمیل مربوط به یک تاریخ خاص.

نمایندگی JSON 
{
  "name": string,
  "userReportedSpamRatio": number,
  "ipReputations": [
    {
      object (IpReputation)
    }
  ],
  "domainReputation": enum (ReputationCategory),
  "spammyFeedbackLoops": [
    {
      object (FeedbackLoop)
    }
  ],
  "spfSuccessRatio": number,
  "dkimSuccessRatio": number,
  "dmarcSuccessRatio": number,
  "outboundEncryptionRatio": number,
  "inboundEncryptionRatio": number,
  "deliveryErrors": [
    {
      object (DeliveryError)
    }
  ]
}
فیلدها
name

string

نام منبع آمار ترافیک. نام‌های آمار ترافیک دارای شکل domains/{domain}/trafficStats/{date} هستند، که در آن domain_name نام دامنه کاملاً واجد شرایط (یعنی mymail.mydomain.com) دامنه‌ای است که این آمار ترافیک به آن مربوط می‌شود و تاریخ آن تاریخ به yyyymmdd است. قالبی که این آمار با آن مطابقت دارد. به عنوان مثال: domains/mymail.mydomain.com/trafficStats/20160807

userReportedSpamRatio

number

نسبت هرزنامه گزارش کاربر به ایمیل ارسال شده به صندوق ورودی. این معیار فقط مربوط به ایمیل‌هایی است که توسط DKIM تأیید شده‌اند.

ipReputations[]

object ( IpReputation )

اطلاعات شهرت مربوط به آدرس های IP سرورهای ایمیل برای دامنه. دقیقاً یک ورودی برای هر دسته شهرت وجود دارد به جز REPUTATION_CATEGORY_UNSPECIFIED .

domainReputation

enum ( ReputationCategory )

شهرت دامنه

spammyFeedbackLoops[]

object ( FeedbackLoop )

شناسه های حلقه بازخورد هرزنامه با نرخ هرزنامه فردی آنها. این معیار فقط مربوط به ترافیکی است که توسط DKIM احراز هویت شده است.

spfSuccessRatio

number

نسبت نامه‌هایی که با SPF با موفقیت احراز هویت شدند در مقابل همه نامه‌هایی که سعی در احراز هویت با SPF داشتند. نامه جعلی مستثنی است.

dkimSuccessRatio

number

نسبت نامه‌هایی که با DKIM با موفقیت احراز هویت شدند در مقابل همه نامه‌هایی که سعی در احراز هویت با DKIM داشتند. نامه جعلی مستثنی است.

dmarcSuccessRatio

number

نسبت نامه‌هایی که بررسی‌های تراز DMARC را گذرانده‌اند در مقابل همه نامه‌های دریافتی از دامنه‌ای که با موفقیت با SPF یا DKIM احراز هویت شده‌اند.

outboundEncryptionRatio

number

نسبت نامه‌های خروجی (از Gmail) که از طریق حمل و نقل ایمن (TLS) پذیرفته شد.

inboundEncryptionRatio

number

نسبت نامه‌های دریافتی (به Gmail)، که از حمل و نقل ایمن (TLS) عبور کرده است، در مقابل همه نامه‌های دریافتی از آن دامنه. این معیار فقط مربوط به ترافیکی است که از SPF یا DKIM عبور کرده است.

deliveryErrors[]

object ( DeliveryError )

خطاهای تحویل برای دامنه این معیار فقط مربوط به ترافیکی است که از SPF یا DKIM عبور کرده است.

IpReputation

اطلاعات اعتبار IP برای مجموعه ای از IP ها در یک دسته شهرت خاص.

نمایندگی JSON 
{
  "reputation": enum (ReputationCategory),
  "ipCount": string,
  "sampleIps": [
    string
  ]
}
فیلدها
reputation

enum ( ReputationCategory )

طبقه بندی شهرت این شهرت IP نشان دهنده آن است.

ipCount

string ( int64 format)

تعداد کل IP های منحصر به فرد در این دسته شهرت. این معیار فقط مربوط به ترافیکی است که از SPF یا DKIM عبور کرده است.

sampleIps[]

string

نمونه ای از IP های این دسته شهرت.

Reputation Category

شهرت یک دامنه یا IP. برای اطلاعات بیشتر به "داشبوردهای اعتبار دامنه و IP" در بخش داشبوردها در صفحه راهنمای Postmaster Tools مراجعه کنید.

Enums
REPUTATION_CATEGORY_UNSPECIFIED مقدار پیش فرضی که هرگز نباید به طور صریح استفاده شود. این حالتی را نشان می دهد که در آن هیچ اطلاعات شهرت در دسترس نیست.
HIGH سابقه خوبی در نرخ هرزنامه بسیار پایین دارد و با دستورالعمل‌های فرستنده Gmail مطابقت دارد. ایمیل به ندرت توسط فیلتر هرزنامه علامت گذاری می شود.
MEDIUM برای ارسال نامه های خوب شناخته شده است، اما مستعد ارسال متناوب حجم کم هرزنامه است. اکثر ایمیل‌های این نهاد دارای نرخ تحویل منصفانه هستند، به جز زمانی که افزایش قابل توجهی در سطوح هرزنامه وجود داشته باشد.
LOW شناخته شده است که حجم قابل توجهی از هرزنامه را به طور مرتب ارسال می کند، و ایمیل های این فرستنده احتمالاً به عنوان هرزنامه علامت گذاری می شوند.
BAD تاریخچه ارسال حجم بسیار زیاد اسپم. ایمیل های ارسالی از این نهاد تقریباً همیشه در سطح SMTP رد می شوند یا به عنوان هرزنامه علامت گذاری می شوند.

FeedbackLoop

اطلاعات شناسه حلقه بازخورد .

نمایندگی JSON 
{
  "id": string,
  "spamRatio": number
}
فیلدها
id

string

شناسه حلقه بازخوردی که به طور منحصر به فرد کمپین های فردی را شناسایی می کند.

spamRatio

number

نسبت پیام‌های هرزنامه علامت‌گذاری شده توسط کاربر با شناسه به تعداد کل پیام‌های صندوق ورودی با آن شناسه.

خطای تحویل

متریک در یک نوع خطای تحویل خاص.

نمایندگی JSON 
{
  "errorClass": enum (DeliveryErrorClass),
  "errorType": enum (DeliveryErrorType),
  "errorRatio": number
}
فیلدها
errorClass

enum ( DeliveryErrorClass )

کلاس خطای تحویل

errorType

enum ( DeliveryErrorType )

نوع خطای تحویل

errorRatio

number

نسبت پیام هایی که در آن خطا رخ داده است به کل ترافیک تأیید شده.

DeliveryErrorClass

کلاس خطای تحویل

Enums
DELIVERY_ERROR_CLASS_UNSPECIFIED مقدار پیش فرضی که هرگز نباید به طور صریح استفاده شود.
PERMANENT_ERROR ارسال پیام رد شده است.
TEMPORARY_ERROR عدم موفقیت موقت در تحویل پیام به گیرنده.

نوع خطای تحویل

نوع خطای تحویل

Enums
DELIVERY_ERROR_TYPE_UNSPECIFIED مقدار پیش فرضی که هرگز نباید به طور صریح استفاده شود.
RATE_LIMIT_EXCEEDED دامنه یا IP ترافیک را با نرخ مشکوکی بالا ارسال می کند که به دلیل آن محدودیت های موقت نرخ اعمال شده است. زمانی که Gmail به اندازه کافی از ماهیت ترافیک مطمئن باشد، محدودیت برداشته می‌شود.
SUSPECTED_SPAM این ترافیک به دلایل مختلف مشکوک به هرزنامه بودن توسط Gmail است.
CONTENT_SPAMMY این ترافیک مشکوک به هرزنامه است، مخصوص به محتوا.
BAD_ATTACHMENT ترافیک شامل پیوست‌هایی است که توسط Gmail پشتیبانی نمی‌شوند.
BAD_DMARC_POLICY دامنه فرستنده یک خط مشی رد DMARC تنظیم کرده است.
LOW_IP_REPUTATION شهرت IP IP ارسال کننده بسیار کم است.
LOW_DOMAIN_REPUTATION شهرت دامنه دامنه ارسال کننده بسیار کم است.
IP_IN_RBL IP در یک یا چند لیست Blackhole عمومی بلادرنگ فهرست شده است. با RBL کار کنید تا IP خود را از لیست حذف کنید.
DOMAIN_IN_RBL دامنه در یک یا چند لیست Blackhole بلادرنگ عمومی فهرست شده است. برای حذف دامنه خود با RBL کار کنید.
BAD_PTR_RECORD IP ارسال کننده فاقد یک رکورد PTR است.

روش ها

get

 آمار ترافیک یک دامنه را در یک تاریخ خاص دریافت کنید.

list

 فهرست آمار ترافیک برای همه روزهای موجود.