REST Resource: domains.trafficStats

Ressource: TrafficStats

Statistiken zum E-Mail-Traffic 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)
    }
  ],
  "userReportedSpamRatioLowerBound": number,
  "userReportedSpamRatioUpperBound": number
}
Felder
name

string

Der Ressourcenname der Besucherstatistiken. Die Namen von Besucherstatistiken haben das Format domains/{domain}/trafficStats/{date}, wobei „domain_name“ der voll qualifizierte Domainname (z.B. mymail.mydomain.com) der Domain ist, auf die sich diese Besucherstatistiken beziehen, und „date“ das Datum im Format JJJJMMTT ist, dem diese Statistiken entsprechen. Beispiel: domains/mymail.mydomain.com/trafficStats/20160807
userReportedSpamRatio

number

Das Verhältnis der von Nutzern als Spam gemeldeten E-Mails zu den an den Posteingang gesendeten E-Mails. Dieser Wert ist möglicherweise nicht genau. Nutzer sollten sich die Beschreibung der Intervallfelder userReportedSpamRatioLowerBound und userReportedSpamRatioUpperBound ansehen, um genauere Genauigkeitsgarantien zu erhalten. Dieser Messwert bezieht sich nur auf E-Mails, die mit DKIM authentifiziert wurden.
ipReputations[]

object (IpReputation)

Informationen zur Reputation der IP-Adressen der E-Mail-Server für die Domain. Es gibt genau einen Eintrag für jede Reputationskategorie mit Ausnahme von REPUTATION_CATEGORY_UNSPECIFIED.
domainReputation

enum (ReputationCategory)

Ruf der Domain
spammyFeedbackLoops[]

object (FeedbackLoop)

Spammy Feedback Loop-IDs mit ihren individuellen Spamraten. Dieser Messwert bezieht sich nur auf Traffic, der mit DKIM authentifiziert wurde.
spfSuccessRatio

number

Das Verhältnis der E-Mails, die mit SPF erfolgreich authentifiziert wurden, zu allen E-Mails, bei denen versucht wurde, sie mit SPF zu authentifizieren. Spoofing-E-Mails sind ausgeschlossen.
dkimSuccessRatio

number

Das Verhältnis der E-Mails, die mit DKIM authentifiziert wurden, zu allen E-Mails, bei denen versucht wurde, eine DKIM durchzuführen. Spoofing-E-Mails sind ausgeschlossen.
dmarcSuccessRatio

number

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

number

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

number

Das Verhältnis der bei Gmail eingehenden E-Mails, die den sicheren Transport (TLS) bestanden haben, zur Gesamtzahl der von dieser Domain empfangenen E-Mails. Dieser Messwert bezieht sich nur auf den Traffic, der die SPF- oder DKIM-Authentifizierung bestanden hat.
deliveryErrors[]

object (DeliveryError)

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

number

Die Untergrenze des Konfidenzintervalls für das Verhältnis der von Nutzern als Spam gemeldeten E‑Mails. Wenn dieses Feld festgelegt ist, wird der Wert von userReportedSpamRatio auf den Mittelpunkt dieses Intervalls gesetzt und ist daher nicht genau. Das tatsächliche Verhältnis liegt jedoch in 95% der Fälle zwischen dieser Untergrenze und der entsprechenden Obergrenze. Dieser Messwert bezieht sich nur auf E-Mails, die mit DKIM authentifiziert wurden.
userReportedSpamRatioUpperBound

number

Die Obergrenze des Konfidenzintervalls für den Anteil der von Nutzern als Spam gemeldeten E‑Mails. Wenn dieses Feld festgelegt ist, wird der Wert von userReportedSpamRatio auf den Mittelpunkt dieses Intervalls gesetzt und ist daher nicht genau. Das tatsächliche Verhältnis liegt jedoch in 95% der Fälle garantiert zwischen dieser Obergrenze und der entsprechenden Untergrenze. Dieser Messwert bezieht sich nur auf E-Mails, die mit DKIM authentifiziert wurden.

IpReputation

Informationen zur IP-Reputation für eine Gruppe 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 den Traffic, der die SPF- oder DKIM-Authentifizierung bestanden hat.
sampleIps[]

string

Einige IP-Adressen in dieser Reputationskategorie.

ReputationCategory

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

Enums
REPUTATION_CATEGORY_UNSPECIFIED Der Standardwert, der niemals explizit verwendet werden sollte. Dies ist der Status, wenn keine Informationen zur Reputation verfügbar sind.
HIGH Hat geringe Spamraten und eine gute Einhaltung der Gmail-Richtlinien für Absender von E-Mails. E-Mails werden nur selten vom Spamfilter markiert.
MEDIUM Bekannt dafür, erwünschte E-Mails zu versenden, mitunter finden sich jedoch auch geringe Spamvolumen. Die meisten E-Mails von dieser Quelle werden akzeptiert. Wird jedoch ein deutlicher Anstieg des Spamvolumens beobachtet, ist die Zustellbarkeit gefährdet.
LOW Regelmäßig hohes Spamvolumen, daher werden Nachrichten von diesem Absender mit hoher Wahrscheinlichkeit als Spam markiert.
BAD In der Vergangenheit wurde ein extrem hohes Spamvolumen verzeichnet. E-Mails aus dieser Quelle werden mit hoher Wahrscheinlichkeit schon auf SMTP-Ebene abgelehnt oder nach dem Empfang als Spam markiert.

FeedbackLoop

Informationen zur Feedback Loop-ID

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

string

Feedback Loop-ID, mit der einzelne Kampagnen eindeutig identifiziert werden.
spamRatio

number

Das Verhältnis der vom Nutzer als Spam markierten E-Mails mit der Kennung zur Gesamtzahl der E-Mails im Posteingang mit dieser Kennung.

DeliveryError

Messwert für einen bestimmten Zustellungsfehlertyp.

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

enum (DeliveryErrorClass)

Die Klasse des Zustellungsfehlers.
errorType

enum (DeliveryErrorType)

Der Typ des Zustellungsfehlers.
errorRatio

number

Das Verhältnis der Nachrichten, bei denen der Fehler aufgetreten ist, zu allen authentifizierten Zugriffen.

DeliveryErrorClass

Die Klasse des Zustellungsfehlers.

Enums
DELIVERY_ERROR_CLASS_UNSPECIFIED Der Standardwert, der niemals explizit verwendet werden sollte.
PERMANENT_ERROR Die Zustellung der Nachricht wurde abgelehnt.
TEMPORARY_ERROR Die Nachricht konnte dem Empfänger vorübergehend nicht zugestellt werden.

DeliveryErrorType

Der Typ des Zustellungsfehlers.

Enums
DELIVERY_ERROR_TYPE_UNSPECIFIED Der Standardwert, der niemals explizit verwendet werden sollte.
RATE_LIMIT_EXCEEDED Die Domain oder IP sendet eine verdächtig hohe Anzahl an E-Mails pro Zeiteinheit. Aus diesem Grund wurden temporäre Ratenbegrenzungen verhängt. Die Sperre wird aufgehoben, sobald Gmail sich der Zuverlässigkeit des Datenverkehrs sicher ist.
SUSPECTED_SPAM Nach diversen Kriterien des Gmail-Systems besteht der Verdacht, dass der Inhalt des Datenverkehrs sehr wahrscheinlich Spam ist.
CONTENT_SPAMMY Es besteht der Verdacht, dass der E-Mail-Verkehr Spaminhalt enthält.
BAD_ATTACHMENT Der Datenverkehr enthält Anhänge, die von Gmail nicht unterstützt werden.
BAD_DMARC_POLICY Die Absenderdomain hat eine DMARC-Ablehnungsrichtlinie eingerichtet.
LOW_IP_REPUTATION Der Ruf der sendenden IP ist schlecht.
LOW_DOMAIN_REPUTATION Der Ruf der sendenden Domain ist schlecht.
IP_IN_RBL Die IP-Adresse ist in einer oder mehreren öffentlichen Real-time Blackhole Lists enthalten. Kontaktieren Sie den RBL-Dienst, um Ihre IP-Adresse aus der RBL entfernen zu lassen.
DOMAIN_IN_RBL Die Domain ist in einer oder mehreren öffentlichen Real-time Blackhole Lists (RBLs) enthalten. Kontaktieren Sie den RBL-Dienst, um Ihre Domain aus der RBL-Liste entfernen zu lassen.
BAD_PTR_RECORD Die sendende IP-Adresse weist keinen PTR-Eintrag auf.

Methoden

get

 Zugriffsstatistiken für eine Domain an einem bestimmten Datum abrufen

list

 Zugriffsstatistiken für alle verfügbaren Tage auflisten.