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) домена, к которому относится эта статистика трафика, а дата — это дата в формате ггггммдд. формат, которому соответствует эта статистика. Например: домены/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

Доля исходящей почты (из 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-адресов в этой категории репутации.

РепутацияКатегория

Репутация домена или IP. Дополнительную информацию см. в разделе «Панели мониторинга репутации домена и IP» в разделе «Панели мониторинга» на странице справки Postmaster Tools .

Перечисления
REPUTATION_CATEGORY_UNSPECIFIED Значение по умолчанию, которое никогда не следует использовать явно. Это представляет собой состояние, в котором информация о репутации недоступна.
HIGH Имеет хороший послужной список: очень низкий уровень спама и соответствует рекомендациям Gmail для отправителей. Почта редко будет помечена спам-фильтром.
MEDIUM Известно, что он отправляет хорошую почту, но склонен периодически рассылать небольшой объем спама. Большая часть электронных писем от этой организации будет иметь приемлемый уровень доставляемости, за исключением случаев заметного увеличения уровня спама.
LOW Известно, что он регулярно рассылает значительный объем спама, и письма от этого отправителя, скорее всего, будут помечены как спам.
BAD История рассылки огромного количества спама. Почта, поступающая от этого объекта, почти всегда будет отклонена на уровне SMTP или помечена как спам.

Обратная связь

Информация об идентификаторе контура обратной связи .

JSON-представление
{
  "id": string,
  "spamRatio": number
}
Поля
id

string

Идентификатор цикла обратной связи, который уникально идентифицирует отдельные кампании.

spamRatio

number

Отношение спам-сообщений, помеченных пользователем с этим идентификатором, к общему количеству входящих сообщений с этим идентификатором.

Ошибка доставки

Метрика для определенного типа ошибки доставки.

JSON-представление
{
  "errorClass": enum (DeliveryErrorClass),
  "errorType": enum (DeliveryErrorType),
  "errorRatio": number
}
Поля
errorClass

enum ( DeliveryErrorClass )

Класс ошибки доставки.

errorType

enum ( DeliveryErrorType )

Тип ошибки доставки.

errorRatio

number

Соотношение сообщений, в которых произошла ошибка, по отношению ко всему аутентифицированному трафику.

Класс доставкиErrorClass

Класс ошибки доставки.

Перечисления
DELIVERY_ERROR_CLASS_UNSPECIFIED Значение по умолчанию, которое никогда не следует использовать явно.
PERMANENT_ERROR Доставка сообщения отклонена.
TEMPORARY_ERROR Временный сбой доставки сообщения получателю.

ТипДоставкиErrorType

Тип ошибки доставки.

Перечисления
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

 Вывести статистику трафика за все доступные дни.