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)

垃圾 Feedback Loop（反馈环）标识符及其各自的垃圾邮件比例。此指标仅适用于通过 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 验证的流量。
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 的声誉。如需了解详情，请参阅 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 临时限制了速度。当 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

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