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),date 是这些统计信息对应的日期(采用 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 匹配检查的邮件与来自相应网域且已成功使用 SPFDKIM 进行身份验证的所有邮件所占的比率。

outboundEncryptionRatio

number

通过安全传输 (TLS) 接收的外发邮件(来自 Gmail)的比率。

inboundEncryptionRatio

number

通过安全传输 (TLS) 的传入邮件(发送至 Gmail)与从相应网域接收的所有邮件的比率。此指标仅适用于通过了 SPFDKIM 的流量。

deliveryErrors[]

object (DeliveryError)

域名的递送错误。此指标仅适用于通过了 SPFDKIM 的流量。

IpReputation

特定声誉类别中的一组 IP 的 IP 声誉信息。

JSON 表示法
{
  "reputation": enum (ReputationCategory),
  "ipCount": string,
  "sampleIps": [
    string
  ]
}
字段
reputation

enum (ReputationCategory)

此 IP 声誉所代表的声誉类别。

ipCount

string (int64 format)

此声誉类别中的唯一身份 IP 总数。此指标仅适用于通过了 SPFDKIM 的流量。

sampleIps[]

string

此声誉类别中的 IP 示例。

ReputationCategory

网域或 IP 的声誉。有关详情,请参阅IP 声誉信息中心”(位于 Postmaster Tools 帮助页面上的“信息中心”部分)。

枚举
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

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