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 格式表示)。例如:domain/mymail.mydomain.com/trafficStats/20160807

userReportedSpamRatio

number

使用者回報垃圾郵件與傳送到收件匣的電子郵件比率。這項指標僅適用於通過 DKIM 驗證的電子郵件。

ipReputations[]

object (IpReputation)

與網域電子郵件伺服器 IP 位址相關的信譽資訊。每個信譽類別都有一個項目,除了 REPUTATION_CATEGORY_UNSPECIFIED 以外。

domainReputation

enum (ReputationCategory)

網域的信譽。

spammyFeedbackLoops[]

object (FeedbackLoop)

垃圾意見回饋循環 ID 和個別垃圾郵件比率。這項指標僅適用於通過 DKIM 驗證的流量。

spfSuccessRatio

number

透過 SPF 成功驗證的郵件與所有嘗試透過 SPF 驗證的郵件的比率。排除假冒的郵件。

dkimSuccessRatio

number

透過 DKIM 成功驗證的郵件與所有嘗試使用 DKIM 進行驗證的郵件的比率。排除假冒的郵件。

dmarcSuccessRatio

number

從成功通過 SPFDKIM 驗證的網域接收的所有郵件,通過 DMARC 校驗檢查的比率。

outboundEncryptionRatio

number

Gmail 中透過安全傳輸 (TLS) 接收的外寄郵件的比率。

inboundEncryptionRatio

number

從該網域收到的所有郵件中,通過安全傳輸 (TLS) 的內送郵件 (傳送到 Gmail) 的比率。這項指標僅適用於通過 SPFDKIM 的流量。

deliveryErrors[]

object (DeliveryError)

網域傳送錯誤。這項指標僅適用於通過 SPFDKIM 的流量。

IpReputation

特定信譽類別中一組 IP 的 IP 信譽資訊。

JSON 表示法
{
  "reputation": enum (ReputationCategory),
  "ipCount": string,
  "sampleIps": [
    string
  ]
}
欄位
reputation

enum (ReputationCategory)

這個 IP 信譽代表的信譽類別。

ipCount

string (int64 format)

這個信譽類別中的不重複 IP 總數。這項指標僅適用於通過 SPFDKIM 的流量。

sampleIps[]

string

這個信譽類別的 IP 樣本。

ReputationCategory

網域或 IP 的信譽。詳情請參閱「網域和IP 聲譽資訊主頁」前往郵件管理員工具說明頁面的「資訊主頁」專區。

列舉
REPUTATION_CATEGORY_UNSPECIFIED 預設值,此值一律不得明確使用。這代表沒有聲譽資訊的狀態。
HIGH 過去的記錄良好,垃圾郵件比率低,並且遵守 Gmail 的寄件者指南。垃圾郵件篩選器幾乎不會將這類郵件標示為垃圾郵件。
MEDIUM 過去曾傳送正常郵件,但可能會間歇傳送少量的垃圾郵件。來自這個實體的電子郵件大部分都可照常寄送,除非垃圾郵件量明顯增加。
LOW 過去曾定期傳送大量垃圾郵件。系統很可能會將來自這位寄件者的郵件標示為垃圾郵件。
BAD 傳送大量垃圾郵件的歷史記錄。系統幾乎一律會在 SMTP 層級拒絕來自這個實體的郵件,或標示為垃圾郵件。

FeedbackLoop

意見回饋循環 ID 資訊。

JSON 表示法
{
  "id": string,
  "spamRatio": number
}
欄位
id

string

用來識別個別廣告活動的意見回饋循環 ID。

spamRatio

number

使用者標示為含有 ID 的垃圾郵件,佔該 ID 的收件匣郵件總數的比率。

DeliveryError

特定傳送錯誤類型的指標。

JSON 表示法
{
  "errorClass": enum (DeliveryErrorClass),
  "errorType": enum (DeliveryErrorType),
  "errorRatio": number
}
欄位
errorClass

enum (DeliveryErrorClass)

交付錯誤的類別。

errorType

enum (DeliveryErrorType)

提交錯誤類型。

errorRatio

number

發生錯誤的郵件與所有已驗證流量的比率。

DeliveryErrorClass

交付錯誤的類別。

列舉
DELIVERY_ERROR_CLASS_UNSPECIFIED 預設值,此值一律不得明確使用。
PERMANENT_ERROR 已拒絕郵件傳送。
TEMPORARY_ERROR 系統暫時無法將郵件傳送給收件者。

DeliveryErrorType

提交錯誤類型。

列舉
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 列在一或多個公開即時黑名單中。請洽詢 RBL 提供者,以便將你的 IP 撤除。
DOMAIN_IN_RBL 網域列在一或多個公開即時黑名單中。請與 RBL 合作,以將你的網域撤除。
BAD_PTR_RECORD 傳送端 IP 缺少 PTR 記錄

方法

get

取得特定日期的流量統計資料。

list

列出所有可用日期的流量統計資料。