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 das estatísticas de tráfego têm o formato domains/{domain}/trafficStats/{date}, em que nome_do_domínio é o nome do domínio totalmente qualificado (por exemplo, mymail.meudominio.com) do domínio a que essas estatísticas de tráfego pertencem, e data é a data no formato aaaammdd à qual essas estatísticas correspondem. Por exemplo: domains/mymail.meudominio.com/trafficStats/20160807
userReportedSpamRatio

number

A proporção entre as denúncias de spam feitas pelos usuários e os e-mails enviados para a caixa de entrada. Essa métrica refere-se apenas a 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)

A reputação do domínio.
spammyFeedbackLoops[]

object (FeedbackLoop)

Identificadores de ciclo de feedback com spam e as respectivas taxas de spam individuais. Essa métrica refere-se apenas ao tráfego autenticado por DKIM.
spfSuccessRatio

number

A proporção entre os e-mails que foram autenticados com o SPF e todos os e-mails que tentaram autenticar com o SPF. E-mails falsificados são excluídos.
dkimSuccessRatio

number

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

number

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

number

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

number

A proporção de e-mails recebidos (para o Gmail) que passaram por 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 pelos métodos SPF ou DKIM.
deliveryErrors[]

object (DeliveryError)

Erros de entrega do domínio. Essa métrica só diz respeito ao tráfego que passou pelos métodos 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 pelos métodos 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 "Domínio e Painéis de reputação de IP" Na seção "Painéis" da página de ajuda do Postmaster Tools.

Enums
REPUTATION_CATEGORY_UNSPECIFIED O valor padrão que nunca deve ser usado explicitamente. Representa o estado em que nenhuma informação de reputação está disponível.
HIGH Tem um bom histórico de taxa de spam muito baixa e está em conformidade com as diretrizes para remetentes do Gmail. Os e-mails raramente serão marcados pelo filtro de spam.
MEDIUM Conhecidos por enviar bons e-mails, mas propensos a enviar um volume baixo de spam intermitentemente. A maioria dos e-mails dessa entidade terá uma taxa de capacidade de entrega razoável, exceto se houver um aumento notável nos níveis de spam.
LOW Esse remetente é conhecido por enviar um volume considerável de spam regularmente. 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 Feedback loop.

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

string

Identificador do ciclo de feedback que identifica exclusivamente campanhas individuais.
spamRatio

number

A proporção entre as mensagens de spam marcadas pelo usuário com o identificador e 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 do erro de entrega.
errorType

enum (DeliveryErrorType)

O tipo de erro de entrega.
errorRatio

number

A proporção entre as mensagens em que o erro ocorreu e todo o tráfego autenticado.

DeliveryErrorClass

A classe do erro de entrega.

Enums
DELIVERY_ERROR_CLASS_UNSPECIFIED O valor padrão que nunca deve 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 deve ser usado explicitamente.
RATE_LIMIT_EXCEEDED O domínio ou IP está enviando tráfego com uma taxa alta suspeita, por isso limites temporários de taxa foram aplicados. O limite será aumentado quando o Gmail tiver certeza suficiente da natureza do tráfego.
SUSPECTED_SPAM O Gmail suspeita que o tráfego é spam por vários motivos.
CONTENT_SPAMMY Há suspeita de que o tráfego seja spam, especificamente com relação ao conteúdo.
BAD_ATTACHMENT O tráfego contém anexos incompatí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 de IP do IP remetente é 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 públicas de buraco negro em tempo real. Entre em contato com o RBL para remover seu IP.
DOMAIN_IN_RBL O domínio está em uma ou mais listas públicas de buraco negro em tempo real. Entre em contato com o RBL para remover seu domínio.
BAD_PTR_RECORD O IP remetente 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

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