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)
    }
  ],
  "userReportedSpamRatioLowerBound": number,
  "userReportedSpamRatioUpperBound": number
}
欄位
name

string

流量統計資料的資源名稱。流量統計資料名稱的格式為 domains/{domain}/trafficStats/{date}，其中 domain_name 是這項統計資料所屬網域的完整網域名稱 (例如 mymail.mydomain.com)，而 date 則是這些統計資料對應的日期，格式為 yyyymmdd。例如：domains/mymail.mydomain.com/trafficStats/20160807
userReportedSpamRatio

number

在傳送到收件匣的郵件中，使用者回報為垃圾郵件的數量與郵件數量的比率。這可能不準確，使用者可能需要參考間隔欄位 userReportedSpamRatioLowerBound 和 userReportedSpamRatioUpperBound 的說明，以獲得更明確的準確度保證。這個指標僅適用於透過 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

在所有來自該網域的郵件中，通過 DMARC 校驗程序的郵件與成功通過 SPF 或 DKIM 驗證的郵件比率。
outboundEncryptionRatio

number

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

number

在所有從該網域傳送到 Gmail 的內寄郵件中，通過安全傳輸協定 (TLS) 的郵件百分比。這項指標只適用於通過 SPF 或 DKIM 的流量。
deliveryErrors[]

object (DeliveryError)

網域的傳送錯誤。這項指標只適用於通過 SPF 或 DKIM 的流量。
userReportedSpamRatioLowerBound

number

使用者回報的垃圾郵件比率信賴區間的下限。如果設定了這個欄位，userReportedSpamRatio 的值就會設為這個間隔的中點，因此不準確。不過，在 95% 的情況下，實際比率都會介於這個下限和對應的上限之間。這個指標僅適用於透過 DKIM 驗證的電子郵件。
userReportedSpamRatioUpperBound

number

使用者回報的垃圾郵件比率信心區間的上限。如果設定了這個欄位，userReportedSpamRatio 的值就會設為這個間隔的中點，因此不準確。不過，在 95% 的情況下，實際比率都會介於這個上限和對應的下限之間。這個指標僅適用於透過 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 的信譽極低。
LOW_DOMAIN_REPUTATION 寄件網域的信譽極低。
IP_IN_RBL IP 列在一或多個公開的即時黑名單中。請洽詢 RBL 提供者，以便將你的 IP 從清單中撤除。
DOMAIN_IN_RBL 網域列在一或多個公開的即時黑名單中。請洽詢 RBL 提供者，以便將你的網域從清單中撤除。
BAD_PTR_RECORD 傳送端 IP 缺少 PTR 記錄。

方法

get

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

list

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