Skip to main content

traffic_stats

Overview

Nametraffic_stats
TypeResource
Idgoogleworkspace.gmailpostmastertools.traffic_stats

Fields

NameDatatypeDescription
namestringThe resource name of the traffic statistics. Traffic statistic names have the form domains/{domain}/trafficStats/{date}, where domain_name is the fully qualified domain name (i.e., mymail.mydomain.com) of the domain this traffic statistics pertains to and date is the date in yyyymmdd format that these statistics corresponds to. For example: domains/mymail.mydomain.com/trafficStats/20160807
dkimSuccessRationumberThe ratio of mail that successfully authenticated with DKIM vs. all mail that attempted to authenticate with DKIM. Spoofed mail is excluded.
ipReputationsarrayReputation information pertaining to the IP addresses of the email servers for the domain. There is exactly one entry for each reputation category except REPUTATION_CATEGORY_UNSPECIFIED.
inboundEncryptionRationumberThe ratio of incoming mail (to Gmail), that passed secure transport (TLS) vs all mail received from that domain. This metric only pertains to traffic that passed SPF or DKIM.
spammyFeedbackLoopsarraySpammy [Feedback loop identifiers] (https://support.google.com/mail/answer/6254652) with their individual spam rates. This metric only pertains to traffic that is authenticated by DKIM.
outboundEncryptionRationumberThe ratio of outgoing mail (from Gmail) that was accepted over secure transport (TLS).
dmarcSuccessRationumberThe ratio of mail that passed DMARC alignment checks vs all mail received from the domain that successfully authenticated with either of SPF or DKIM.
deliveryErrorsarrayDelivery errors for the domain. This metric only pertains to traffic that passed SPF or DKIM.
domainReputationstringReputation of the domain.
spfSuccessRationumberThe ratio of mail that successfully authenticated with SPF vs. all mail that attempted to authenticate with SPF. Spoofed mail is excluded.
userReportedSpamRationumberThe ratio of user-report spam vs. email that was sent to the inbox. This metric only pertains to emails authenticated by DKIM.

Methods

NameAccessible byRequired ParamsDescription
domains_trafficStats_getSELECTdomainsId, trafficStatsIdGet traffic statistics for a domain on a specific date. Returns PERMISSION_DENIED if user does not have permission to access TrafficStats for the domain.
domains_trafficStats_listSELECTdomainsIdList traffic statistics for all available days. Returns PERMISSION_DENIED if user does not have permission to access TrafficStats for the domain.