REST Resource: domains.trafficStats

Recurso: TrafficStats

Enviar estatísticas de tráfego por e-mail relativas 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 domínio_nome é o nome de domínio totalmente qualificado (ou seja, mymail.mydomain.com) do domínio a que essas estatísticas de tráfego pertencem e data é a data no formato aaaammdd a que essas estatísticas correspondem. Por exemplo: Domains/mymail.mydomain.com/trafficStats/20160807.
userReportedSpamRatio

number

A proporção de spam por usuário e e-mail enviados para a caixa de entrada. Essa métrica se refere apenas aos 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 do loop de feedback com spam como taxas de spam individuais. Essa métrica pertence apenas ao tráfego autenticado pelo DKIM.
spfSuccessRatio

number

A proporção de e-mails que foram autenticados com o SPF em comparação com todos os que tentaram fazer a autenticação com o SPF. Os 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 que tentaram fazer a autenticação com o DKIM. Os e-mails falsificados são excluídos.
dmarcSuccessRatio

number

A proporção de e-mails que foram aprovados 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 foi aceita por transporte seguro (TLS).
inboundEncryptionRatio

number

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

object (DeliveryError)

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

Reputação do IP

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 se refere apenas ao tráfego que passou por SPF ou DKIM.
sampleIps[]

string

Um exemplo de IPs nesta categoria de reputação.

Categoria de reputação

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 Tem um histórico satisfatório 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 e-mails de boa qualidade, mas está propenso a enviar um volume de spam intermitentemente. A maioria 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 Sabe-se que é possível 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 do SMTP ou marcados como spam.

Feedback Feedback

Informações do identificador de loop de feedback.

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

string

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

number

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

Erro de entrega

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.

Classe de erro de entrega

A classe de 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 de mensagens ao destinatário.

Tipo de erro de entrega

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 impostos. O limite será suspenso quando o Gmail tiver certeza suficiente da natureza do tráfego.
SUSPECTED_SPAM Há suspeita de que o tráfego seja spam, por vários motivos, pelo Gmail.
CONTENT_SPAMMY Há suspeita de que o tráfego seja spam, específico 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 de envio é muito baixa.
IP_IN_RBL O IP está listado em uma ou mais listas públicas de buraco negro em tempo real. Trabalhe com a RBL para remover seu IP.
DOMAIN_IN_RBL O domínio está listado em uma ou mais listas públicas de buracos negros em tempo real. Trabalhe com a RBL para remover seu domínio.
BAD_PTR_RECORD O IP de envio não tem um registro PTR.

Métodos

get

 ver estatísticas de tráfego de um domínio em uma data específica;

list

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