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

通过安全传输 (TLS) 接受的外发邮件（来自 Gmail）的比率。
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 的声誉。如需了解详情，请参阅 Postmaster Tools 帮助页面上“信息中心”部分中的“网域和 IP 声誉信息中心”。

枚举
REPUTATION_CATEGORY_UNSPECIFIED 绝不应显式使用的默认值。这表示没有声誉信息的状态。
HIGH 拥有极低的垃圾邮件比例的良好记录，并且遵守 Gmail 的发件人指南。垃圾邮件过滤器很少标记出邮件。
MEDIUM 已知能够发送正常邮件，但容易间歇性发送少量垃圾邮件。来自此实体的大部分电子邮件的递送率都比较一般，但垃圾邮件水平明显增加的情况除外。
LOW 已知会经常发送相当多数量的垃圾邮件，来自此发件人的邮件可能被标记为垃圾邮件。
BAD 发送过极多数量的垃圾邮件的历史记录。来自此实体的邮件几乎总是会在 SMTP 级别被拒绝或标记为垃圾邮件。

FeedbackLoop

反馈环标识符信息。

JSON 表示法 
{
  "id": string,
  "spamRatio": number
}
字段
id

string

用于唯一标识各个广告系列的反馈环标识符。
spamRatio

number

用户使用该标识符标记的垃圾邮件数占使用该标识符标记的垃圾邮件总数。

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 被列入一个或多个公开的实时黑名单中。请设法将您的 IP 从 RBL 中移除。
DOMAIN_IN_RBL 相应网域被列入一个或多个公开的实时黑名单中。请与 RBL 合作，将您的域名去除。
BAD_PTR_RECORD 发件人 IP 缺少 PTR 记录。

方法

get

 获取某个网域在特定日期的流量统计信息。

list

 列出所有可用日期的流量统计信息。