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}，其中 <網域名稱> 是與這些流量統計資料相關的網域完整網域名稱 (例如 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

與通過 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 範例。

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

 列出所有可用天數的流量統計資料。