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

從成功通過 SPF 或 DKIM 驗證的網域接收的所有郵件，通過 DMARC 校驗檢查的比率。
outboundEncryptionRatio

number

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

number

從該網域收到的所有郵件中，通過安全傳輸 (TLS) 的內送郵件 (傳送到 Gmail) 的比率。這項指標僅適用於通過 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 樣本。

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

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