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ù domain_name correspond au nom de domaine complet (par exemple, mymail.mondomaine.com) du domaine auquel ces statistiques de trafic appartiennent, et la date correspond à la date au format aaaammjj à laquelle ces statistiques correspondent. Par exemple: domaines/monmessagerie.mondomaine.com/trafficStats/20160807

userReportedSpamRatio

number

Ratio de spam signalé par les utilisateurs par rapport au 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 du domaine. Il y a exactement une entrée pour chaque catégorie de réputation, à l'exception de REPUTATION_CATEGORY_UNSPECIFIED.

domainReputation

enum (ReputationCategory)

Réputation du domaine.

spammyFeedbackLoops[]

object (FeedbackLoop)

Des identifiants de boucle de rétroaction contenant du spam, ainsi que leurs taux de spam individuels Cette métrique ne concerne que le trafic authentifié par DKIM.

spfSuccessRatio

number

Ratio d'e-mails ayant réussi à s'authentifier avec SPF par rapport au nombre total d'e-mails ayant tenté de s'authentifier avec SPF. Les messages frauduleux sont exclus.

dkimSuccessRatio

number

Ratio d'e-mails ayant réussi à s'authentifier avec DKIM par rapport au nombre total d'e-mails ayant tenté de s'authentifier avec DKIM. Les messages frauduleux sont exclus.

dmarcSuccessRatio

number

Ratio d'e-mails ayant réussi les contrôles d'alignement DMARC par rapport à l'ensemble des e-mails provenant du domaine qui ont été authentifiés avec SPF ou DKIM.

outboundEncryptionRatio

number

Ratio de messages sortants (depuis Gmail) acceptés via le protocole TLS.

inboundEncryptionRatio

number

Ratio entre le nombre de messages entrants (par rapport à Gmail) ayant réussi le 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 pour le domaine. Cette métrique ne concerne que le trafic ayant transmis SPF ou DKIM.

IpReputation

Informations sur la réputation d'une adresse IP pour 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 associée à la réputation de l'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 plus d'informations, consultez la section "Domaines Tableaux de bord "Réputation 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 Dispose d'un bon historique d'un très faible taux de spam et respecte les consignes Gmail pour les expéditeurs. Les messages seront rarement marqués par le filtre antispam.
MEDIUM Connu pour envoyer des messages de qualité, mais sujette à l'envoi par intermittence d'un faible volume de spam. La plupart des e-mails provenant de cette entité bénéficieront d'un taux de distribution raisonnable, sauf en cas d'augmentation notable du nombre de spams.
LOW Connu pour envoyer régulièrement et en grand nombre des messages indésirables, et les e-mails provenant de cet expéditeur seront probablement marqués comme spam.
BAD Historique des envois de spam en très grand nombre. Les e-mails provenant de cette entité seront presque toujours rejetés au niveau SMTP ou marqués comme spam.

FeedbackLoop

Informations sur l'identifiant de la 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 des campagnes individuelles.

spamRatio

number

Ratio de messages marqués comme spam par l'utilisateur avec l'identifiant par rapport au 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 distribution.

errorType

enum (DeliveryErrorType)

Type d'erreur de distribution.

errorRatio

number

Ratio de messages où l'erreur s'est produite par rapport à l'ensemble du trafic authentifié.

DeliveryErrorClass

Classe d'erreur de distribution.

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

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 l'imposition de limites de débit temporaires. La limite sera levée lorsque Gmail aura suffisamment confiance en la nature du trafic.
SUSPECTED_SPAM Le trafic est considéré comme du spam, par Gmail, pour diverses raisons.
CONTENT_SPAMMY Le trafic est considéré comme du spam en raison du contenu.
BAD_ATTACHMENT Le trafic contient des pièces jointes non compatibles avec Gmail.
BAD_DMARC_POLICY Le domaine d'envoi a défini des règles de rejet 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 est répertoriée 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

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

list

Lister les statistiques de trafic pour tous les jours disponibles