REST Resource: domains.trafficStats

Recurso: TrafficStats

Estatísticas de tráfego de e-mail referentes a uma data específica.

Representação 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)
    }
  ]
}
Campos
name

string

O nome do recurso das estatísticas de tráfego. Os nomes de estatísticas de tráfego têm o formato domains/{domain}/trafficStats/{date}, em que "domain_name" é o nome de domínio totalmente qualificado (por exemplo, mymail.meudominio.com) do domínio a que essas estatísticas de tráfego pertencem e "date" é a data no formato aaaammdd a que essas estatísticas correspondem. Por exemplo: domains/mymail.meudominio.com/trafficStats/20160807
userReportedSpamRatio

number

A proporção de spam denunciado pelo usuário em relação ao e-mail enviado para a caixa de entrada. Esta métrica só diz respeito aos e-mails autenticados por DKIM.
ipReputations[]

object (IpReputation)

Informações de reputação relacionadas aos endereços IP dos servidores de e-mail do domínio. Há exatamente uma entrada para cada categoria de reputação, exceto REPUTATION_CATEGORY_UNSPECIFIED.
domainReputation

enum (ReputationCategory)

Reputação do domínio.
spammyFeedbackLoops[]

object (FeedbackLoop)

Identificadores de loop de feedback com spam e as taxas de spam individuais. Esta métrica só diz respeito ao tráfego autenticado pelo DKIM.
spfSuccessRatio

number

A proporção de e-mails autenticados com sucesso com SPF em comparação com todos os e-mails que tentaram autenticar com o SPF. Os e-mails falsificados são excluídos.
dkimSuccessRatio

number

A proporção de e-mails autenticados com o DKIM em comparação com todos os e-mails que tentaram autenticar com o DKIM. Os e-mails falsificados são excluídos.
dmarcSuccessRatio

number

A proporção de e-mails que passaram nas verificações de alinhamento do DMARC em comparação com todos os e-mails recebidos do domínio autenticados com o SPF ou o DKIM.
outboundEncryptionRatio

number

A proporção de e-mails enviados do Gmail que foram aceitos por transporte seguro (TLS).
inboundEncryptionRatio

number

A proporção de e-mails recebidos (para o Gmail) que passaram pelo transporte seguro (TLS) em relação a todos os e-mails recebidos desse domínio. Essa métrica só diz respeito ao tráfego que passou pelo SPF ou DKIM.
deliveryErrors[]

object (DeliveryError)

Erros de entrega do domínio. Essa métrica só diz respeito ao tráfego que passou pelo SPF ou DKIM.

IpReputation

Informações de reputação de IP para um conjunto de IPs em uma categoria de reputação específica.

Representação JSON 
{
  "reputation": enum (ReputationCategory),
  "ipCount": string,
  "sampleIps": [
    string
  ]
}
Campos
reputation

enum (ReputationCategory)

A categoria de reputação que essa reputação de IP representa.
ipCount

string (int64 format)

Número total de IPs únicos nesta categoria de reputação. Essa métrica só diz respeito ao tráfego que passou pelo SPF ou DKIM.
sampleIps[]

string

Uma amostra de IPs nesta categoria de reputação.

ReputationCategory

A reputação de um domínio ou IP. Para mais informações, consulte "Painéis de reputação de domínio e IP" na seção "Painéis" da página de ajuda do Postmaster Tools.

Enums
REPUTATION_CATEGORY_UNSPECIFIED O valor padrão que nunca pode ser usado explicitamente. Representa o estado em que nenhuma informação de reputação está disponível.
HIGH Tem um bom histórico de taxas de spam muito baixas e está em conformidade com as diretrizes para remetentes do Gmail. Os e-mails raramente serão marcados pelo filtro de spam.
MEDIUM Sabe enviar bons e-mails, mas é propenso a enviar um baixo volume de spam de forma intermitente. A maior parte dos e-mails desta entidade terá uma taxa de capacidade de entrega justa, exceto quando houver um aumento considerável nos níveis de spam.
LOW Conhecido por enviar um volume considerável de spam regularmente, e os e-mails desse remetente provavelmente serão marcados como spam.
BAD Histórico de envio de um volume extremamente alto de spam. Os e-mails provenientes dessa entidade quase sempre serão rejeitados no nível SMTP ou marcados como spam.

FeedbackLoop

Informações do identificador do loop de feedback.

Representação JSON 
{
  "id": string,
  "spamRatio": number
}
Campos
id

string

Identificador de loop de feedback que identifica campanhas individuais de forma exclusiva.
spamRatio

number

A proporção de mensagens marcadas como spam pelo usuário com o identificador em comparação com o número total de mensagens na caixa de entrada com esse identificador.

DeliveryError

Métrica em um tipo específico de erro de entrega.

Representação JSON 
{
  "errorClass": enum (DeliveryErrorClass),
  "errorType": enum (DeliveryErrorType),
  "errorRatio": number
}
Campos
errorClass

enum (DeliveryErrorClass)

A classe de erro de entrega.
errorType

enum (DeliveryErrorType)

O tipo de erro de entrega.
errorRatio

number

A proporção de mensagens em que o erro ocorreu em relação a todo o tráfego autenticado.

DeliveryErrorClass

A classe de erro de entrega.

Enums
DELIVERY_ERROR_CLASS_UNSPECIFIED O valor padrão que nunca pode ser usado explicitamente.
PERMANENT_ERROR A entrega da mensagem foi rejeitada.
TEMPORARY_ERROR Falha temporária na entrega da mensagem ao destinatário.

DeliveryErrorType

O tipo de erro de entrega.

Enums
DELIVERY_ERROR_TYPE_UNSPECIFIED O valor padrão que nunca pode ser usado explicitamente.
RATE_LIMIT_EXCEEDED O domínio ou IP está enviando tráfego com uma taxa alta suspeita, por isso os limites temporários de taxa foram impostos. O limite será aumentado quando o Gmail tiver certeza suficiente da natureza do tráfego.
SUSPECTED_SPAM O Gmail suspeita que o tráfego seja spam por vários motivos.
CONTENT_SPAMMY Há uma suspeita de que o tráfego seja spam, especificamente com relação ao conteúdo.
BAD_ATTACHMENT O tráfego contém anexos que não são compatíveis com o Gmail.
BAD_DMARC_POLICY O domínio do remetente configurou uma política de rejeição do DMARC.
LOW_IP_REPUTATION A reputação do IP de envio é muito baixa.
LOW_DOMAIN_REPUTATION A reputação do domínio remetente é muito baixa.
IP_IN_RBL O IP está incluído em uma ou mais listas de buraco negro em tempo real públicas. Entre em contato com o RBL para remover seu IP.
DOMAIN_IN_RBL O domínio está incluído em uma ou mais listas públicas de buraco negro (link em inglês). Entre em contato com o RBL para remover seu domínio.
BAD_PTR_RECORD O IP de envio não tem um registro PTR.

Métodos

get

 Acessar estatísticas de tráfego de um domínio em uma data específica.

list

 Liste as estatísticas de tráfego para todos os dias disponíveis.