REST Resource: domains.trafficStats

Ressource: TrafficStats

Statistiques du trafic de messagerie pour une date spécifique.

Représentation 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)
    }
  ]
}
Champs
name

string

Nom de ressource des statistiques de trafic. Les noms de statistiques de trafic se présentent sous la forme domains/{domain}/trafficStats/{date}, où nom_domaine est le nom de domaine complet (par exemple, monmail.mondomaine.com) du domaine auquel ces statistiques de trafic se rapportent, et la date est la date au format aaaammjj à laquelle ces statistiques correspondent. Par exemple: domains/monmessagerie.mondomaine.com/trafficStats/20160807

userReportedSpamRatio

number

Ratio entre le spam signalé par les utilisateurs et le nombre d'e-mails envoyés dans la boîte de réception. Cette métrique ne concerne que les e-mails authentifiés par DKIM.

ipReputations[]

object (IpReputation)

Informations sur la réputation des adresses IP des serveurs de messagerie pour le domaine. Il existe exactement une entrée pour chaque catégorie de réputation, sauf REPUTATION_CATEGORY_UNSPECIFIED.

domainReputation

enum (ReputationCategory)

Réputation du domaine.

spammyFeedbackLoops[]

object (FeedbackLoop)

Identifiants de boucle de rétroaction contenant du spam et leurs taux de spam individuels. Cette métrique ne concerne que le trafic authentifié par DKIM.

spfSuccessRatio

number

Ratio de messages ayant réussi à s'authentifier avec SPF par rapport au nombre total de messages ayant tenté de s'authentifier avec SPF. Les messages falsifiés sont exclus.

dkimSuccessRatio

number

Ratio de messages ayant réussi à s'authentifier avec DKIM par rapport au nombre total de messages ayant tenté de s'authentifier avec DKIM. Les messages falsifiés sont exclus.

dmarcSuccessRatio

number

Ratio entre les messages ayant réussi les contrôles d'alignement DMARC et le nombre total de messages provenant du domaine authentifiés avec SPF ou DKIM.

outboundEncryptionRatio

number

Ratio de messages sortants (depuis Gmail) acceptés par transport sécurisé (TLS).

inboundEncryptionRatio

number

Ratio entre le nombre de messages entrants (par rapport à Gmail) ayant passé un transfert sécurisé (TLS) par rapport à l'ensemble des e-mails provenant de ce domaine. Cette métrique ne concerne que le trafic ayant transmis SPF ou DKIM.

deliveryErrors[]

object (DeliveryError)

Erreurs de distribution concernant le domaine. Cette métrique ne concerne que le trafic ayant transmis SPF ou DKIM.

IpReputation

Informations sur la réputation d'un ensemble d'adresses IP appartenant à une catégorie de réputation spécifique.

Représentation JSON
{
  "reputation": enum (ReputationCategory),
  "ipCount": string,
  "sampleIps": [
    string
  ]
}
Champs
reputation

enum (ReputationCategory)

Catégorie de réputation représentée par cette réputation d'adresse IP.

ipCount

string (int64 format)

Nombre total d'adresses IP uniques dans cette catégorie de réputation. Cette métrique ne concerne que le trafic ayant transmis SPF ou DKIM.

sampleIps[]

string

Exemples d'adresses IP dans cette catégorie de réputation.

ReputationCategory

Réputation d'un domaine ou d'une adresse IP Pour en savoir plus, consultez la section "Tableaux de bord sur la réputation des domaines et des adresses IP" dans la section "Tableaux de bord" de la page d'aide de Postmaster Tools.

Enums
REPUTATION_CATEGORY_UNSPECIFIED Valeur par défaut qui ne doit jamais être utilisée explicitement. Il s'agit de l'État dans lequel aucune information sur la réputation n'est disponible.
HIGH a un bon historique d'un taux de spam très faible et respecte les consignes Gmail à l'intention des expéditeurs ; Les e-mails seront rarement marqués comme spam.
MEDIUM Ils sont connus pour envoyer des messages de bonne qualité, mais ils sont susceptibles d'envoyer peu de spam par intermittence. Le taux de distribution des e-mails provenant de cette entité sera correct, sauf en cas d'augmentation notable du nombre de spams.
LOW est connu pour envoyer régulièrement et en grand nombre de messages un nombre considérable de spams, et les e-mails provenant de cet expéditeur seront probablement marqués comme spam.
BAD Historique d'envoi d'un très grand nombre de spams Les e-mails provenant de cette entité seront presque toujours rejetés au niveau SMTP ou marqués comme spam.

FeedbackLoop

Informations d'identification de boucle de rétroaction.

Représentation JSON
{
  "id": string,
  "spamRatio": number
}
Champs
id

string

Identifiant de boucle de rétroaction qui identifie de manière unique les campagnes individuelles.

spamRatio

number

Ratio entre le nombre de messages marqués comme spam avec cet identifiant et le nombre total de messages dans la boîte de réception associés à cet identifiant.

DeliveryError

Métrique sur un type d'erreur de diffusion particulier.

Représentation JSON
{
  "errorClass": enum (DeliveryErrorClass),
  "errorType": enum (DeliveryErrorType),
  "errorRatio": number
}
Champs
errorClass

enum (DeliveryErrorClass)

Classe d'erreur de diffusion.

errorType

enum (DeliveryErrorType)

Type d'erreur de diffusion.

errorRatio

number

Ratio entre le nombre de messages où l'erreur s'est produite et l'ensemble du trafic authentifié.

DeliveryErrorClass

Classe d'erreur de diffusion.

Enums
DELIVERY_ERROR_CLASS_UNSPECIFIED Valeur par défaut qui ne doit jamais être utilisée explicitement.
PERMANENT_ERROR La distribution du message a été refusée.
TEMPORARY_ERROR Échec temporaire de la distribution du message au destinataire.

DeliveryErrorType

Type d'erreur de diffusion.

Enums
DELIVERY_ERROR_TYPE_UNSPECIFIED Valeur par défaut qui ne doit jamais être utilisée explicitement.
RATE_LIMIT_EXCEEDED Le domaine ou l'adresse IP envoie du trafic à un taux anormalement élevé, en raison de limites de débit temporaires qui ont été imposées. La limite sera levée lorsque la fiabilité du trafic aura été établie dans Gmail.
SUSPECTED_SPAM Le trafic est considéré comme du spam par Gmail pour diverses raisons.
CONTENT_SPAMMY En raison de son contenu, le trafic est soupçonné de spam.
BAD_ATTACHMENT Le trafic contient des pièces jointes non compatibles avec Gmail.
BAD_DMARC_POLICY Le domaine de l'expéditeur a configuré des règles de refus DMARC.
LOW_IP_REPUTATION La réputation de l'adresse IP d'envoi est très faible.
LOW_DOMAIN_REPUTATION La réputation du domaine d'envoi est très faible.
IP_IN_RBL L'adresse IP figure dans une ou plusieurs listes noires en temps réel publiques. Contactez le service RBL pour faire supprimer votre adresse IP des résultats de recherche.
DOMAIN_IN_RBL Le domaine est répertorié dans une ou plusieurs listes noires en temps réel publiques. Contactez le service RBL pour faire supprimer votre domaine des résultats de recherche.
BAD_PTR_RECORD Il manque un enregistrement PTR à l'adresse IP d'envoi.

Méthodes

get

Obtenir les statistiques de trafic d'un domaine à une date spécifique

list

Lister les statistiques de trafic pour tous les jours disponibles