REST Resource: domains.trafficStats

Recurso: TrafficStats

Estadísticas de tráfico de correo electrónico correspondientes a una fecha específica.

Representación 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

Es el nombre del recurso de las estadísticas de tráfico. Los nombres de las estadísticas de tráfico tienen el formato domains/{domain}/trafficStats/{date}, en el que domain_name es el nombre de dominio completamente calificado (es decir, mymail.mydomain.com) del dominio al que pertenecen estas estadísticas de tráfico y date es la fecha en formato aaaammdd a la que corresponden estas estadísticas. Por ejemplo: domains/micorreo.midominio.com/trafficStats/20160807

userReportedSpamRatio

number

Es la proporción de spam denunciado por los usuarios en comparación con el correo electrónico que se envió a Recibidos. Esto puede ser inexacto. Es posible que los usuarios deseen consultar la descripción de los campos de intervalo userReportedSpamRatioLowerBound y userReportedSpamRatioUpperBound para obtener garantías de precisión más explícitas. Esta métrica solo se aplica a los correos electrónicos autenticados por DKIM.

ipReputations[]

object (IpReputation)

Información de reputación relacionada con las direcciones IP de los servidores de correo electrónico del dominio Hay exactamente una entrada para cada categoría de reputación, excepto REPUTATION_CATEGORY_UNSPECIFIED.

domainReputation

enum (ReputationCategory)

Reputación del dominio

spammyFeedbackLoops[]

object (FeedbackLoop)

Identificadores de ciclo de reacción con spam con sus porcentajes de spam individuales Esta métrica solo se refiere al tráfico autenticado por DKIM.

spfSuccessRatio

number

Es la proporción de correos electrónicos que se autenticaron correctamente con SPF en comparación con todos los correos electrónicos que intentaron autenticarse con SPF. Se excluye el correo electrónico con falsificación de identidad.

dkimSuccessRatio

number

Es la proporción de correo electrónico que se autenticó correctamente con DKIM en comparación con todo el correo electrónico que intentó autenticarse con DKIM. Se excluye el correo electrónico con falsificación de identidad.

dmarcSuccessRatio

number

Es la proporción de correo electrónico que pasó las verificaciones de alineación de DMARC en relación con todo el correo electrónico recibido del dominio que se autenticó correctamente con SPF o DKIM.

outboundEncryptionRatio

number

Es la proporción de correo electrónico saliente (enviado desde Gmail) que se aceptó a través del transporte seguro (TLS).

inboundEncryptionRatio

number

Es la proporción de correo electrónico entrante (enviado a Gmail) que pasó el transporte seguro (TLS) en comparación con todo el correo electrónico recibido de ese dominio. Esta métrica solo se refiere al tráfico que pasó SPF o DKIM.

deliveryErrors[]

object (DeliveryError)

Errores de entrega del dominio Esta métrica solo se refiere al tráfico que pasó SPF o DKIM.

userReportedSpamRatioLowerBound

number

Es el límite inferior del intervalo de confianza para la proporción de spam denunciado por los usuarios. Si se establece este campo, el valor de userReportedSpamRatio se establece en el punto medio de este intervalo y, por lo tanto, es inexacto. Sin embargo, se garantiza que la proporción real esté entre este límite inferior y el límite superior correspondiente el 95% de las veces. Esta métrica solo se aplica a los correos electrónicos autenticados por DKIM.

userReportedSpamRatioUpperBound

number

Es el límite superior del intervalo de confianza para la proporción de spam denunciado por los usuarios. Si se establece este campo, el valor de userReportedSpamRatio se establece en el punto medio de este intervalo y, por lo tanto, es inexacto. Sin embargo, se garantiza que la proporción real esté entre este límite superior y el límite inferior correspondiente el 95% de las veces. Esta métrica solo se aplica a los correos electrónicos autenticados por DKIM.

IpReputation

Información de reputación de IP para un conjunto de IPs en una categoría de reputación específica.

Representación JSON
{
  "reputation": enum (ReputationCategory),
  "ipCount": string,
  "sampleIps": [
    string
  ]
}
Campos
reputation

enum (ReputationCategory)

Es la categoría de reputación que representa esta reputación de IP.

ipCount

string (int64 format)

Es la cantidad total de IPs únicas en esta categoría de reputación. Esta métrica solo se refiere al tráfico que pasó SPF o DKIM.

sampleIps[]

string

Muestra de las IPs de esta categoría de reputación.

ReputationCategory

Es la reputación de un dominio o una IP. Para obtener más información, consulta "Paneles de reputación de dominios y direcciones IP" en la sección Paneles de la página de ayuda de Postmaster Tools.

Enumeraciones
REPUTATION_CATEGORY_UNSPECIFIED Es el valor predeterminado que nunca se debe usar de forma explícita. Representa el estado en el que no hay información de reputación disponible.
HIGH Tiene un buen historial con una proporción de spam muy baja y cumple con las pautas para remitentes de Gmail. El filtro de spam rara vez marcará el correo electrónico de este remitente como spam.
MEDIUM El remitente envía correo electrónico aceptable, pero tiende a enviar una pequeña cantidad de spam de forma intermitente. La mayor parte del correo electrónico de esta entidad tendrá una tasa de entrega razonable, excepto cuando haya un aumento considerable en los niveles de spam.
LOW Se sabe que envía una cantidad considerable de spam con frecuencia. Es probable que el correo electrónico de este remitente se marque como spam.
BAD Historial de envío de una enorme cantidad de spam. El correo electrónico procedente de esta entidad se rechazará en el nivel de SMTP o marcará como spam casi siempre.

FeedbackLoop

Información del identificador del ciclo de reacción

Representación JSON
{
  "id": string,
  "spamRatio": number
}
Campos
id

string

Es el identificador del ciclo de reacción que identifica de forma inequívoca las campañas individuales.

spamRatio

number

Es la proporción de mensajes de spam marcados por el usuario con el identificador en comparación con la cantidad total de mensajes recibidos con ese identificador.

DeliveryError

Métrica sobre un tipo de error de entrega en particular.

Representación JSON
{
  "errorClass": enum (DeliveryErrorClass),
  "errorType": enum (DeliveryErrorType),
  "errorRatio": number
}
Campos
errorClass

enum (DeliveryErrorClass)

Es la clase de error de entrega.

errorType

enum (DeliveryErrorType)

Es el tipo de error de entrega.

errorRatio

number

Es la proporción de mensajes en los que se produjo el error en comparación con todo el tráfico autenticado.

DeliveryErrorClass

Es la clase de error de entrega.

Enumeraciones
DELIVERY_ERROR_CLASS_UNSPECIFIED Es el valor predeterminado que nunca se debe usar de forma explícita.
PERMANENT_ERROR Se rechazó la entrega del mensaje.
TEMPORARY_ERROR Falla temporal en la entrega del mensaje al destinatario.

DeliveryErrorType

Es el tipo de error de entrega.

Enumeraciones
DELIVERY_ERROR_TYPE_UNSPECIFIED Es el valor predeterminado que nunca se debe usar de forma explícita.
RATE_LIMIT_EXCEEDED El dominio o la IP envía tráfico con una tasa sospechosamente alta, por lo que se aplicaron límites de tasa temporales. El límite se quitará cuando Gmail tenga seguridad respecto de la naturaleza del tráfico.
SUSPECTED_SPAM Gmail sospecha que el tráfico es spam por varios motivos.
CONTENT_SPAMMY Se sospecha que el tráfico es de tipo spam debido al contenido.
BAD_ATTACHMENT El tráfico contiene archivos adjuntos que Gmail no admite.
BAD_DMARC_POLICY El dominio del remitente estableció una política de rechazo DMARC.
LOW_IP_REPUTATION La reputación de la IP de envío es muy baja.
LOW_DOMAIN_REPUTATION La reputación del dominio de envío es muy baja.
IP_IN_RBL La IP aparece en una o más Listas de agujero negro en tiempo real públicas. Solicita a la RBL la eliminación de tu IP de la lista.
DOMAIN_IN_RBL El dominio aparece en una o más Listas de agujero negro en tiempo real públicas. Solicita a la RBL la eliminación de tu dominio de la lista.
BAD_PTR_RECORD Falta un registro PTR en la IP de envío.

Métodos

get

Obtén estadísticas de tráfico de un dominio en una fecha específica.

list

Muestra las estadísticas de tráfico de todos los días disponibles.