REST Resource: domains.trafficStats

Recurso: TrafficStats

Estadísticas del 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)
    }
  ]
}
Campos
name

string

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}, donde name_domain es el nombre de dominio completamente calificado (es decir, mymail.mydomain.com) del dominio al que corresponden estas estadísticas de tráfico y la fecha es la fecha en formato aaaammdd a la que corresponden estas estadísticas. Por ejemplo: domains/micorreo.midominio.com/trafficStats/20160807
userReportedSpamRatio

number

La proporción de spam denunciado por los usuarios en comparación con el correo electrónico enviado a Recibidos. Esta métrica solo corresponde a los correos electrónicos autenticados por DKIM.
ipReputations[]

object (IpReputation)

Información de reputación que pertenece a 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)

La reputación del dominio.
spammyFeedbackLoops[]

object (FeedbackLoop)

Identificadores de bucle de comentarios generadores de spam con sus porcentajes de spam individuales Esta métrica solo corresponde al tráfico autenticado por DKIM.
spfSuccessRatio

number

La proporción de correos electrónicos que se autenticaron correctamente con SPF y todos los que intentaron autenticarse con SPF. Se excluye el correo electrónico con falsificación de identidad.
dkimSuccessRatio

number

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

number

La proporción de correos electrónicos que aprobaron las verificaciones de alineación de DMARC en comparación con todos los correos electrónicos recibidos del dominio que se autenticaron correctamente con SPF o DKIM.
outboundEncryptionRatio

number

Es la proporción de correo electrónico saliente (de Gmail) que se aceptó en el transporte seguro (TLS).
inboundEncryptionRatio

number

La proporción de correos electrónicos entrantes (en relación con Gmail) que pasaron el transporte seguro (TLS) en comparación con todo el correo electrónico recibido de ese dominio. Esta métrica solo corresponde al tráfico que pasó SPF o DKIM.
deliveryErrors[]

object (DeliveryError)

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

IpReputation

Información de reputación de IP para un conjunto de IP con 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)

Cantidad total de IP únicas en esta categoría de reputación. Esta métrica solo corresponde al tráfico que pasó SPF o DKIM.
sampleIps[]

string

Una muestra de las IP en esta categoría de reputación.

ReputationCategory

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

Enumeraciones
REPUTATION_CATEGORY_UNSPECIFIED El valor predeterminado que nunca debe usarse de manera explícita. Este representa el estado en el que no hay información de reputación disponible.
HIGH Tiene un buen historial con un porcentaje de spam muy bajo y cumple con los lineamientos para remitentes de Gmail. El filtro de spam rara vez marcará el correo electrónico.
MEDIUM Es conocido por enviar buenos correos electrónicos, pero tiende a enviar un volumen bajo 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 notable en los niveles de spam.
LOW El remitente envía una cantidad considerable de spam con frecuencia. El correo electrónico de este remitente probablemente se marcará como spam.
BAD Historial de envío de una enorme cantidad de spam. El correo electrónico procedente de esta entidad se rechazará a nivel de SMTP o se marcará como spam casi siempre.

FeedbackLoop

Información del identificador del bucle de retroalimentación

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

string

Es el identificador del ciclo de retroalimentación que identifica de manera única campañas individuales.
spamRatio

number

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

DeliveryError

Métrica sobre un tipo de error de entrega específico.

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)

El tipo de error de entrega.
errorRatio

number

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 El valor predeterminado que nunca debe usarse de manera explícita.
PERMANENT_ERROR Se rechazó la entrega del mensaje.
TEMPORARY_ERROR Error temporal de entrega del mensaje al destinatario.

DeliveryErrorType

El tipo de error de entrega.

Enumeraciones
DELIVERY_ERROR_TYPE_UNSPECIFIED El valor predeterminado que nunca debe usarse de manera explícita.
RATE_LIMIT_EXCEEDED El dominio o la IP envía tráfico con una tasa sospechosamente alta, por lo que se aplican límites de frecuencia temporales. El límite se quitará cuando Gmail tenga certeza 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 generador de spam debido al contenido.
BAD_ATTACHMENT El tráfico contiene archivos adjuntos que Gmail no admite.
BAD_DMARC_POLICY El dominio del remitente configuró una política de rechazo de 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

 Obtener 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.