REST Resource: domains.trafficStats

Ressource: TrafficStats

Statistiques sur le trafic des e-mails 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)
    }
  ],
  "userReportedSpamRatioLowerBound": number,
  "userReportedSpamRatioUpperBound": number
}
Champs
name

string

Nom de la ressource des statistiques sur le trafic. Les noms des statistiques sur le trafic sont au format domains/{domain}/trafficStats/{date}, où "nom_de_domaine" correspond au nom de domaine complet (par exemple, "monmail.mondomaine.com") du domaine auquel ces statistiques sur le trafic font référence, et "date" correspond à la date (au format AAAA-MM-JJ) à laquelle ces statistiques font référence. Par exemple: domaines/monmail.mondomaine.fr/statistiques-trafic/20160807
userReportedSpamRatio

number

Rapport entre le spam signalé par les utilisateurs et les e-mails envoyés dans la boîte de réception. Cette valeur est potentiellement inexacte. Les utilisateurs peuvent se reporter à la description des champs d'intervalle userReportedSpamRatioLowerBound et userReportedSpamRatioUpperBound pour obtenir des garanties de précision plus explicites. 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 existe 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)

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

number

Ratio des e-mails authentifiés avec SPF par rapport à l'ensemble des e-mails ayant tenté de s'authentifier avec SPF. Les e-mails falsifiés sont exclus.
dkimSuccessRatio

number

Ratio des e-mails authentifiés avec DKIM par rapport à l'ensemble des e-mails qui ont tenté de s'authentifier avec DKIM. Les e-mails falsifiés sont exclus.
dmarcSuccessRatio

number

Ratio des e-mails ayant passé les contrôles d'alignement DMARC par rapport à l'ensemble des e-mails provenant du domaine et ayant réussi l'authentification avec SPF ou DKIM.
outboundEncryptionRatio

number

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

number

Ratio des messages entrants (dans Gmail) ayant passé le protocole de transport sécurisé (TLS) par rapport à l'ensemble des e-mails provenant de ce domaine. Cette métrique ne concerne que le trafic ayant passé le contrôle SPF ou DKIM.
deliveryErrors[]

object (DeliveryError)

Erreurs de distribution pour le domaine. Cette métrique ne concerne que le trafic ayant passé le contrôle SPF ou DKIM.
userReportedSpamRatioLowerBound

number

Limite inférieure de l'intervalle de confiance pour le ratio de spam signalé par les utilisateurs. Si ce champ est défini, la valeur de userReportedSpamRatio est définie sur le milieu de cet intervalle et est donc inexacte. Toutefois, le ratio réel est garanti entre cette limite inférieure et la limite supérieure correspondante 95% du temps. Cette métrique ne concerne que les e-mails authentifiés par DKIM.
userReportedSpamRatioUpperBound

number

Limite supérieure de l'intervalle de confiance pour le ratio de spam signalé par les utilisateurs. Si ce champ est défini, la valeur de userReportedSpamRatio est définie sur le milieu de cet intervalle et est donc inexacte. Toutefois, le ratio réel se situe 95% du temps entre cette limite supérieure et la limite inférieure correspondante. Cette métrique ne concerne que les e-mails authentifiés par DKIM.

IpReputation

Informations sur la réputation des adresses 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 de cette 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 passé le contrôle SPF ou DKIM.
sampleIps[]

string

Exemple d'adresses IP appartenant à cette catégorie de réputation.

ReputationCategory

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

Enums
REPUTATION_CATEGORY_UNSPECIFIED Valeur par défaut qui ne doit jamais être utilisée explicitement. État pour lequel aucune information sur la réputation n'est disponible.
HIGH s'applique à un domaine connu pour envoyer une faible quantité de messages signalés comme spam et respectant les consignes Gmail destinées aux expéditeurs de messages. Ces e-mails seront rarement marqués comme spam.
MEDIUM S'applique à une adresse IP connue pour envoyer des e-mails ne posant pas de problème, mais susceptible d'envoyer occasionnellement du spam. La plupart des e-mails envoyés par cette entité bénéficieront d'un taux de distribution correct, sauf en cas d'augmentation sensible du nombre de spam.
LOW S'applique à un expéditeur connu pour envoyer régulièrement et en grand nombre des messages signalés comme spam. Les e-mails provenant de cette adresse seront probablement marqués comme spam.
BAD Envoi régulier d'un très grand nombre de spams. Les e-mails provenant de cette entité seront presque toujours rejetés par le serveur 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 la boucle de rétroaction qui identifie de manière unique chaque campagne.
spamRatio

number

Rapport entre le nombre de messages marqués comme spam par l'utilisateur avec l'identifiant et le nombre total de messages de la boîte de réception avec cet identifiant.

DeliveryError

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

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

enum (DeliveryErrorClass)

Classe de l'erreur de distribution.
errorType

enum (DeliveryErrorType)

Type d'erreur de distribution.
errorRatio

number

Ratio entre les messages pour lesquels l'erreur s'est produite et l'ensemble du trafic authentifié.

DeliveryErrorClass

Classe de l'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 trafic envoyé par le domaine ou l'adresse IP est anormalement élevé et des limites temporaires ont été imposées. Celles-ci seront supprimées dès que la confiance relative à la nature du trafic aura été restaurée.
SUSPECTED_SPAM Pour diverses raisons, Gmail considère le trafic comme assimilable à du spam.
CONTENT_SPAMMY En raison de son contenu, le trafic est considéré comme assimilable à du spam.
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 figure dans une ou plusieurs listes noires en temps réel publiques. Contactez le service RBL pour faire supprimer votre adresse IP de ces listes.
DOMAIN_IN_RBL Le domaine figure dans une ou plusieurs listes noires en temps réel publiques. Contactez le service RBL pour faire supprimer votre domaine de ces listes.
BAD_PTR_RECORD Un enregistrement PTR manque dans l'adresse IP d'envoi.

Méthodes

get

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

list

 Répertorie les statistiques sur le trafic pour tous les jours disponibles.