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)
    }
  ],
  "userReportedSpamRatioLowerBound": number,
  "userReportedSpamRatioUpperBound": number
}
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 domain_name é o nome de domínio totalmente qualificado (por exemplo, mymail.mydomain.com) do domínio a que as estatísticas de tráfego se referem e date é a data no formato aaaa-mm-dd a que essas estatísticas correspondem. Por exemplo: domains/mymail.mydomain.com/trafficStats/20160807
userReportedSpamRatio

number

A proporção entre o spam denunciado pelo usuário e os e-mails enviados para a Caixa de entrada. Isso pode ser impreciso. Os usuários podem consultar a descrição dos campos de intervalo userReportedSpamRatioLowerBound e userReportedSpamRatioUpperBound para garantias de precisão mais explícitas. Essa métrica se aplica apenas a e-mails autenticados pelo 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 com Feedback Loop com taxas de spam individuais. Essa métrica se refere apenas ao tráfego autenticado pelo DKIM.
spfSuccessRatio

number

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

number

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

number

A proporção de e-mails que passaram nas verificações de alinhamento de 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 por transporte seguro (TLS).
inboundEncryptionRatio

number

A proporção de e-mails recebidos no Gmail que passaram pelo transporte seguro (TLS) em comparação com todos os e-mails recebidos desse domínio. Essa métrica se refere apenas ao tráfego que passou pelo SPF ou pelo DKIM.
deliveryErrors[]

object (DeliveryError)

Erros de entrega do domínio. Essa métrica se refere apenas ao tráfego que passou pelo SPF ou pelo DKIM.
userReportedSpamRatioLowerBound

number

O limite mínimo do intervalo de confiança para a proporção de spam denunciada pelo usuário. Se esse campo for definido, o valor de userReportedSpamRatio será definido como o ponto médio desse intervalo e, portanto, será impreciso. No entanto, a proporção real está entre esse limite inferior e o limite superior correspondente 95% do tempo. Essa métrica se aplica apenas a e-mails autenticados pelo DKIM.
userReportedSpamRatioUpperBound

number

O limite superior do intervalo de confiança para a proporção de spam denunciada pelo usuário. Se esse campo for definido, o valor de userReportedSpamRatio será definido como o ponto médio desse intervalo e, portanto, será impreciso. No entanto, a proporção real está garantida entre esse limite superior e o limite inferior correspondente 95% do tempo. Essa métrica se aplica apenas a e-mails autenticados pelo 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 nessa categoria de reputação. Essa métrica se refere apenas ao tráfego que passou pelo SPF ou pelo DKIM.
sampleIps[]

string

Uma amostra de IPs nessa 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 deve ser usado explicitamente. Representa o estado em que nenhuma informação de reputação está disponível.
HIGH Um remetente que apresenta um histórico bom de taxas de spam muito baixas e está em conformidade com as diretrizes para remetentes do Gmail. Os e-mails raramente são marcados pelo filtro de spam.
MEDIUM Conhecido por enviar bons e-mails, mas propenso a enviar um volume pequeno de spam esporadicamente. A maioria dos e-mails desta entidade terá uma taxa de capacidade de entrega boa, exceto se houver um aumento notável nos níveis de spam.
LOW 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 enviar um volume extremamente alto de spam. Os e-mails provenientes desta entidade quase sempre serão rejeitados no nível SMTP ou marcados como spam.

FeedbackLoop

Informações do identificador do ciclo de feedback.

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

string

Identificador do Feedback Loop que identifica campanhas individuais de forma exclusiva.
spamRatio

number

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

DeliveryError

Métrica sobre um determinado tipo de erro de exibição.

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 de mensagens em que o erro ocorreu em relação a 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 os 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 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 incompatíveis com o Gmail.
BAD_DMARC_POLICY O domínio do remetente definiu uma política de rejeição do DMARC.
LOW_IP_REPUTATION A reputação do IP remetente é muito baixa.
LOW_DOMAIN_REPUTATION A reputação do domínio de envio é muito baixa.
IP_IN_RBL O IP está incluído em uma ou mais listas negras 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 de buraco negro (RBL, na sigla em inglês) em tempo real. Entre em contato com o RBL para retirar seu domínio da lista.
BAD_PTR_RECORD O IP de envio não tem um registro PTR.

Métodos

get

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

list

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