REST Resource: domains.trafficStats

Ressource: TrafficStats

Statistiques sur le trafic de messagerie par date.

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 sur le trafic. Les noms des statistiques sur le trafic se présentent sous la forme domains/{domain}/trafficStats/{date}, où "domain_name" correspond au nom complet du domaine (monmessage.mondomaine.fr) correspondant à ces statistiques de trafic et "date" à la date au format aaaammjj à laquelle ces statistiques correspondent. Par exemple: domains/mymail.mydomain.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 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)

ID de la boucle de rétroaction contenant du spam. Cette métrique ne concerne que le trafic authentifié par DKIM.
spfSuccessRatio

number

Ratio entre le nombre de messages ayant été authentifiés avec SPF et celui de tous les messages ayant tenté de s'authentifier avec SPF. Les messages usurpés sont exclus.
dkimSuccessRatio

number

Ratio entre le courrier ayant réussi à s'authentifier auprès de DKIM et le nombre total de messages dont l'authentification a été effectuée avec DKIM. Les messages usurpés sont exclus.
dmarcSuccessRatio

number

Ratio entre le nombre de messages ayant passé l'étape d'alignement DMARC et le nombre de messages provenant du domaine ayant réussi à s'authentifier avec SPF ou DKIM
outboundEncryptionRatio

number

Ratio de messages sortants (depuis Gmail) acceptés par le protocole TLS
inboundEncryptionRatio

number

Ratio de messages entrants (vers Gmail) ayant passé le 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é les contrôles SPF ou DKIM.
deliveryErrors[]

object (DeliveryError)

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

Réputation

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 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 passé les contrôles SPF ou DKIM.
sampleIps[]

string

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

Catégorie de réputation

Réputation d'un domaine ou d'une adresse IP. Pour en savoir plus, consultez la section "Dashboards 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. Il s'agit de l'État dans lequel aucune information de réputation n'est disponible.
HIGH s'il a fait l'objet d'un excellent taux de spam et respecte les consignes Gmail destinées aux expéditeurs de messages ; Les messages sont rarement marqués par le filtre antispam.
MEDIUM Elle est connue pour envoyer des messages de qualité, mais elle est susceptible d'envoyer un faible volume de spam par intermittence. La plupart des e-mails envoyés par cette entité bénéficieront d'un taux de distribution correct, sauf en cas d'augmentation notable du niveau de spam.
LOW Connus pour envoyer régulièrement et en grand nombre du spam, les messages envoyés par cet expéditeur seront probablement marqués comme spam.
BAD Historique de l'envoi d'un volume extrêmement élevé de spams 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 permettant d'identifier de façon unique chaque campagne.
spamRatio

number

Ratio entre le nombre de messages marqués comme spam par un utilisateur et l'identifiant par rapport au nombre total de messages qu'il contient.

Erreur de livraison

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 de l'erreur de livraison.
errorType

enum (DeliveryErrorType)

Type d'erreur de diffusion.
errorRatio

number

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

Classe ErrorError

Classe de l'erreur de livraison.

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.

Type d'erreur de livraison

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 débit anormalement élevé, en raison de limites de débit temporaires qui ont été imposées. La limite sera levée lorsque Gmail sera suffisamment confiant sur 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 assimilable à du spam et propre au 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 expéditeur 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.
BAD_PTR_RECORD Il manque un enregistrement PTR dans l'adresse IP d'envoi.

Méthodes

get

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

list

 Répertorier les statistiques du trafic pour tous les jours disponibles