REST Resource: domains.trafficStats

Ressource: TrafficStats

Statistiken zum E-Mail-Verkehr für ein bestimmtes Datum

JSON-Darstellung
{
  "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)
    }
  ]
}
Felder
name

string

Der Ressourcenname der Traffic-Statistiken. Namen von Traffic-Statistiken haben das Format domains/{domain}/trafficStats/{date}, wobei „domain_name“ der voll qualifizierte Domainname (z. B. meinemail.IhrUnternehmen.de) der Domain ist, auf die sich diese Traffic-Statistiken beziehen. Das Datum ist das Datum im Format JJJJMMTT, dem diese Statistiken entsprechen. Beispiel: domains/mymail.IhrUnternehmen.de/trafficStats/20160807.

userReportedSpamRatio

number

Das Verhältnis zwischen von Nutzern als Spam gemeldeten E-Mails und den an den Posteingang gesendeten E-Mails. Dieser Messwert gilt nur für E-Mails, die über DKIM authentifiziert wurden.

ipReputations[]

object (IpReputation)

Reputationsinformationen, die sich auf die IP-Adressen der E-Mail-Server für die Domain beziehen. Für jede Reputationskategorie außer REPUTATION_CATEGORY_UNSPECIFIED gibt es genau einen Eintrag.

domainReputation

enum (ReputationCategory)

den Ruf der Domain.

spammyFeedbackLoops[]

object (FeedbackLoop)

Feedbackschleifen-IDs mit ihren individuellen Spamraten als Spam. Dieser Messwert bezieht sich nur auf Traffic, der über DKIM authentifiziert ist.

spfSuccessRatio

number

Das Verhältnis zwischen den E-Mails, die sich mit SPF authentifiziert haben, im Vergleich zu allen E-Mails, bei denen versucht wurde, sich mit SPF zu authentifizieren. Gefälschte E-Mails sind davon ausgenommen.

dkimSuccessRatio

number

Das Verhältnis zwischen erfolgreich authentifizierten E-Mails mit DKIM im Vergleich zu allen E-Mails, bei denen versucht wurde, sich mit DKIM zu authentifizieren. Gefälschte E-Mails sind davon ausgenommen.

dmarcSuccessRatio

number

Das Verhältnis der E-Mails, die die DMARC-Abgleichsprüfungen bestanden haben, im Vergleich zu allen von der Domain empfangenen E-Mails, die mit SPF oder DKIM authentifiziert wurden.

outboundEncryptionRatio

number

Das Verhältnis ausgehender E-Mails (von Gmail), die über eine sichere Übertragung (TLS) akzeptiert wurden.

inboundEncryptionRatio

number

Das Verhältnis der eingehenden E-Mails (zu Gmail), die über die sichere Übertragung (TLS) übertragen wurden, im Vergleich zu allen von dieser Domain empfangenen E-Mails. Dieser Messwert bezieht sich nur auf Traffic, der SPF oder DKIM bestanden hat.

deliveryErrors[]

object (DeliveryError)

Zustellungsfehler für die Domain Dieser Messwert bezieht sich nur auf Traffic, der SPF oder DKIM bestanden hat.

IpReputation

Informationen zum IP-Ruf für eine Reihe von IP-Adressen in einer bestimmten Reputationskategorie.

JSON-Darstellung
{
  "reputation": enum (ReputationCategory),
  "ipCount": string,
  "sampleIps": [
    string
  ]
}
Felder
reputation

enum (ReputationCategory)

Die Reputationskategorie, die diese IP-Reputation darstellt.

ipCount

string (int64 format)

Gesamtzahl der eindeutigen IP-Adressen in dieser Reputationskategorie. Dieser Messwert bezieht sich nur auf Traffic, der SPF oder DKIM bestanden hat.

sampleIps[]

string

Eine Stichprobe von IP-Adressen in dieser Reputationskategorie.

ReputationCategory

Der Ruf einer Domain oder IP-Adresse. Weitere Informationen finden Sie auf der Hilfeseite von Postmaster Tools im Bereich „Dashboards“ unter „Dashboards zur Domain- und IP-Reputation“.

Enums
REPUTATION_CATEGORY_UNSPECIFIED Der Standardwert, der nie explizit verwendet werden sollte. Dies steht für den Status, für den keine Informationen zum Ruf verfügbar sind.
HIGH Hat eine sehr niedrige Spamrate und entspricht den Absenderrichtlinien von Gmail. E-Mails werden nur selten vom Spamfilter markiert.
MEDIUM Es ist bekannt dafür, gute E-Mails zu versenden, von Zeit zu Zeit jedoch auch geringe Spam-Mengen. Die meisten E-Mails von dieser Entität haben eine faire Zustellbarkeit, es sei denn, die Spammenge ist merklich angestiegen.
LOW Regelmäßig hohes Spamvolumen senden, daher werden E-Mails von diesem Absender mit hoher Wahrscheinlichkeit als Spam markiert.
BAD In der Vergangenheit wurde ein extrem hohes Spamvolumen verzeichnet. E-Mails von dieser Quelle werden fast immer auf SMTP-Ebene abgelehnt oder als Spam markiert.

FeedbackLoop

Informationen zur Kennung der Feedbackschleife.

JSON-Darstellung
{
  "id": string,
  "spamRatio": number
}
Felder
id

string

Feedback Loop-Kennung, die einzelne Kampagnen eindeutig identifiziert.

spamRatio

number

Das Verhältnis zwischen vom Nutzer markierten Spamnachrichten mit dieser Kennzeichnung und der Gesamtzahl der mit dieser Kennung versehenen Nachrichten im Posteingang.

DeliveryError

Messwert für einen bestimmten Auslieferungsfehlertyp.

JSON-Darstellung
{
  "errorClass": enum (DeliveryErrorClass),
  "errorType": enum (DeliveryErrorType),
  "errorRatio": number
}
Felder
errorClass

enum (DeliveryErrorClass)

Die Klasse des Übermittlungsfehlers.

errorType

enum (DeliveryErrorType)

Die Art des Übermittlungsfehlers.

errorRatio

number

Das Verhältnis der Nachrichten, bei denen der Fehler aufgetreten ist, im Vergleich zum gesamten authentifizierten Datenverkehr.

DeliveryErrorClass

Die Klasse des Übermittlungsfehlers.

Enums
DELIVERY_ERROR_CLASS_UNSPECIFIED Der Standardwert, der nie explizit verwendet werden sollte.
PERMANENT_ERROR Die Zustellung der Nachricht wurde abgelehnt.
TEMPORARY_ERROR Vorübergehender Fehler bei der Nachrichtenzustellung an den Empfänger.

DeliveryErrorType

Die Art des Übermittlungsfehlers.

Enums
DELIVERY_ERROR_TYPE_UNSPECIFIED Der Standardwert, der nie explizit verwendet werden sollte.
RATE_LIMIT_EXCEEDED Die Domain oder IP-Adresse sendet Traffic mit einer verdächtig hohen Geschwindigkeit. Aus diesem Grund wurden temporäre Ratenbegrenzungen verhängt. Die Begrenzung wird aufgehoben, sobald Google Mail von der Art des Datenverkehrs überzeugt ist.
SUSPECTED_SPAM Gmail vermutet aus verschiedenen Gründen den Verdacht auf Spam.
CONTENT_SPAMMY Es besteht der Verdacht, dass es sich bei dem Traffic um Spam handelt.
BAD_ATTACHMENT Datenverkehr enthält Anhänge, die von Gmail nicht unterstützt werden.
BAD_DMARC_POLICY Für die Absenderdomain wurde eine DMARC-Ablehnungsrichtlinie eingerichtet.
LOW_IP_REPUTATION Der Ruf der Absender-IP ist sehr gering.
LOW_DOMAIN_REPUTATION Der Ruf der Absenderdomain ist sehr gering.
IP_IN_RBL Die IP-Adresse ist in einer oder mehreren öffentlichen Blackhole-Echtzeitlisten aufgeführt. Wenden Sie sich an den RBL-Dienst, um Ihre IP-Adresse aus den Suchergebnissen entfernen zu lassen.
DOMAIN_IN_RBL Die Domain ist in einer oder mehreren öffentlichen Blackhole-Echtzeitlisten aufgeführt. Wenden Sie sich an den RBL-Dienst, um Ihre Domain aus den Suchergebnissen entfernen zu lassen.
BAD_PTR_RECORD Die sendende IP-Adresse hat keinen PTR-Eintrag.

Methoden

get

Zugriffsstatistiken für eine Domain an einem bestimmten Datum abrufen

list

Traffic-Statistiken für alle verfügbaren Tage auflisten.