REST Resource: domains.trafficStats

Zasób: TrafficStats

statystyki ruchu poczty e-mail z określonego dnia.

Zapis 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)
    }
  ]
}
Pola
name

string

Nazwa zasobu statystyk ruchu. Nazwy statystyk ruchu mają postać domains/{domain}/trafficStats/{date}, gdzie nazwa_domeny jest w pełni kwalifikowaną nazwą domeny (np. mojpoczta.mojadomena.com) domeny, której dotyczą te statystyki, a data to data w formacie rrrrmmdd, której dotyczą te statystyki. Na przykład: domains/mymail.mydomain.com/trafficStats/20160807

userReportedSpamRatio

number

Stosunek spamu zgłaszanego przez użytkownika do ilości spamu w e-mailach wysłanych do skrzynki odbiorczej. Te dane dotyczą tylko e-maili uwierzytelnionych za pomocą DKIM.

ipReputations[]

object (IpReputation)

Informacje o reputacji dotyczące adresów IP serwerów poczty e-mail w domenie. Każda kategoria reputacji oprócz REPUTATION_CATEGORY_UNSPECIFIED ma dokładnie 1 wpis.

domainReputation

enum (ReputationCategory)

Reputacja domeny.

spammyFeedbackLoops[]

object (FeedbackLoop)

Spamerskie identyfikatory pętli informacji zwrotnych z indywidualnymi wskaźnikami spamu. Ten wskaźnik dotyczy tylko ruchu uwierzytelnionego za pomocą DKIM.

spfSuccessRatio

number

Stosunek liczby e-maili, które udało się uwierzytelnić za pomocą SPF, do wszystkich e-maili, które podjęto próbę uwierzytelnienia przy użyciu SPF. Fałszywe wiadomości są wykluczane.

dkimSuccessRatio

number

Stosunek liczby e-maili, które udało się uwierzytelnić za pomocą DKIM, do liczby wszystkich e-maili, które próbowano uwierzytelnić za pomocą DKIM. Fałszywe wiadomości są wykluczane.

dmarcSuccessRatio

number

Stosunek liczby e-maili, które przeszły weryfikację dopasowania DMARC, do wszystkich e-maili otrzymanych z domeny, która została uwierzytelniona za pomocą SPF lub DKIM.

outboundEncryptionRatio

number

Współczynnik poczty wychodzącej (z Gmaila), która została zaakceptowana przez bezpieczny transport (TLS).

inboundEncryptionRatio

number

Stosunek poczty przychodzącej (do Gmaila), która została przekazana za pomocą bezpiecznego przesyłania (TLS), do wszystkich e-maili otrzymanych z danej domeny. Te dane dotyczą tylko ruchu, który został sprawdzony przez SPF lub DKIM.

deliveryErrors[]

object (DeliveryError)

Błędy dostarczania w domenie. Te dane dotyczą tylko ruchu, który został sprawdzony przez SPF lub DKIM.

IpReputation

Informacje o reputacji adresu IP dla zbioru adresów IP w określonej kategorii reputacji.

Zapis JSON
{
  "reputation": enum (ReputationCategory),
  "ipCount": string,
  "sampleIps": [
    string
  ]
}
Pola
reputation

enum (ReputationCategory)

Kategoria reputacji, którą reprezentuje ta reputacja adresu IP.

ipCount

string (int64 format)

Łączna liczba unikalnych adresów IP w tej kategorii reputacji. Te dane dotyczą tylko ruchu, który został sprawdzony przez SPF lub DKIM.

sampleIps[]

string

Przykładowe adresy IP w tej kategorii reputacji.

ReputationCategory

Reputacja domeny lub adresu IP. Więcej informacji znajdziesz w sekcji „Domeny Panele reputacji adresów IP” w sekcji Panele na stronie pomocy narzędzi Postmaster Tools.

Wartości w polu enum
REPUTATION_CATEGORY_UNSPECIFIED Wartość domyślna, której nigdy nie należy bezpośrednio używać. Wskazuje stan, w którym nie ma informacji o reputacji.
HIGH Przekazuje wiadomości dobre (ma bardzo niski wskaźnik spamu) i stosuje się do wskazówek Google dla nadawców e-maili. Wiadomości są rzadko oznaczane przez filtr spamu.
MEDIUM Osoba znana z tego, że wysyła dobrą pocztę, ale ma tendencję do wysyłania małej ilości spamu w sposób sporadycznie. Większość e-maili od tego nadawcy zostanie dostarczona, chyba że nastąpi znaczny wzrost ilości spamu.
LOW Wiemy, że regularnie wysyła duże ilości spamu, więc wiadomości od tego nadawcy prawdopodobnie zostaną oznaczone jako spam.
BAD w historii wysyłania bardzo dużych ilości spamu; Poczta przychodząca od tego podmiotu będzie prawie zawsze odrzucana na poziomie SMTP lub oznaczana jako spam.

FeedbackLoop

Informacje o identyfikatorze pętli informacji zwrotnych.

Zapis JSON
{
  "id": string,
  "spamRatio": number
}
Pola
id

string

Identyfikator pętli informacji zwrotnych, który jednoznacznie identyfikuje poszczególne kampanie.

spamRatio

number

Stosunek liczby wiadomości oznaczonych jako spam przez użytkownika do łącznej liczby wiadomości w skrzynce odbiorczej z tym identyfikatorem.

DeliveryError

Wskaźnik określonego typu błędu dostarczania.

Zapis JSON
{
  "errorClass": enum (DeliveryErrorClass),
  "errorType": enum (DeliveryErrorType),
  "errorRatio": number
}
Pola
errorClass

enum (DeliveryErrorClass)

Błąd klasy dostawy.

errorType

enum (DeliveryErrorType)

Typ błędu dostarczania.

errorRatio

number

Stosunek liczby wiadomości, w których wystąpił błąd, do całego ruchu uwierzytelnionego.

DeliveryErrorClass

Błąd klasy dostawy.

Wartości w polu enum
DELIVERY_ERROR_CLASS_UNSPECIFIED Wartość domyślna, której nigdy nie należy bezpośrednio używać.
PERMANENT_ERROR Dostarczenie wiadomości zostało odrzucone.
TEMPORARY_ERROR Tymczasowe niepowodzenie dostarczenia wiadomości do adresata.

DeliveryErrorType

Typ błędu dostarczania.

Wartości w polu enum
DELIVERY_ERROR_TYPE_UNSPECIFIED Wartość domyślna, której nigdy nie należy bezpośrednio używać.
RATE_LIMIT_EXCEEDED Domena lub adres IP wysyła ruch z niezwykle dużą częstotliwością, z powodu której zostały nałożone tymczasowe ograniczenia. Limit zostanie zniesiony, gdy Gmail uzyska dostatecznie dużą pewność co do charakteru ruchu.
SUSPECTED_SPAM Gmail z różnych powodów uważa, że ten ruch może być spamem.
CONTENT_SPAMMY Powodzenie ruchu to podejrzenie spamu ze względu na treści.
BAD_ATTACHMENT Ruch zawiera załączniki nieobsługiwane przez Gmaila.
BAD_DMARC_POLICY W domenie nadawcy zostały skonfigurowane zasady odrzucenia DMARC.
LOW_IP_REPUTATION Reputacja adresu IP nadawcy jest bardzo słaba.
LOW_DOMAIN_REPUTATION Reputacja domeny wysyłającej jest bardzo słaba.
IP_IN_RBL Adres IP znajduje się na co najmniej jednej publicznej liście blokad w czasie rzeczywistym. Postaraj się, aby Twój adres IP został usunięty z list RBL.
DOMAIN_IN_RBL Domena znajduje się na co najmniej jednej publicznej liście blokad w czasie rzeczywistym. Poproś o usunięcie domeny z listy RBL.
BAD_PTR_RECORD W adresie IP nadawcy brakuje rekordu PTR.

Metody

get

Pobierz statystyki ruchu dla domeny w konkretnym dniu.

list

Wyświetlać statystyki ruchu ze wszystkich dostępnych dni.