REST Resource: domains.trafficStats

Zasób: TrafficStats

Statystyki ruchu e-maila dotyczące konkretnej daty.

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)
    }
  ],
  "userReportedSpamRatioLowerBound": number,
  "userReportedSpamRatioUpperBound": number
}
Pola
name

string

Nazwa zasobu statystyk ruchu. Nazwy statystyk ruchu mają postać domains/{domain}/trafficStats/{date}, gdzie domain_name to w pełni kwalifikowana nazwa domeny (np. mymail.mojadomena.com) domeny, której dotyczą te statystyki ruchu, a date to data w formacie rrrrmmdd odpowiadająca tym statystykom. Na przykład: domeny/mójpoczta.mojadomena.com/statystyki ruchu/20160807
userReportedSpamRatio

number

Stosunek spamu zgłaszanego przez użytkownika do poczty wysyłanej do jego skrzynki odbiorczej. Może to być nieprecyzyjne – użytkownicy mogą chcieć zapoznać się z opisem pól przedziału userReportedSpamRatioLowerBound i userReportedSpamRatioUpperBound, aby uzyskać bardziej jednoznaczne gwarancje dokładności. Ten rodzaj danych dotyczy 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. W przypadku każdej kategorii reputacji z wyjątkiem REPUTATION_CATEGORY_UNSPECIFIED występuje dokładnie 1 rekord.
domainReputation

enum (ReputationCategory)

reputacja domeny;
spammyFeedbackLoops[]

object (FeedbackLoop)

Spamowe identyfikatory pętli informacji zwrotnych z ich indywidualnymi wskaźnikami spamu. Te dane dotyczą tylko ruchu uwierzytelnionego za pomocą DKIM.
spfSuccessRatio

number

Stosunek e-maili, które zostały pozytywnie zweryfikowane za pomocą SPF, do wszystkich e-maili, które próbowały przejść uwierzytelnianie za pomocą SPF. Nie uwzględnia sfałszowanych wiadomości.
dkimSuccessRatio

number

Stosunek e-maili, które zostały pozytywnie zweryfikowane za pomocą DKIM, do wszystkich e-maili, które próbowały przejść uwierzytelnienie za pomocą DKIM. Nie uwzględnia sfałszowanych wiadomości.
dmarcSuccessRatio

number

Stosunek e-maili, które pozytywnie przeszły testy uzgodnienia DMARC, do wszystkich e-maili otrzymanych z domeny, które zostały pozytywnie uwierzytelnione za pomocą SPF lub DKIM.
outboundEncryptionRatio

number

Współczynnik e-maili wychodzących (z Gmaila), które pozytywnie przeszły weryfikację z użyciem bezpiecznego protokołu transportowego (TLS).
inboundEncryptionRatio

number

Odsetek e-maili przychodzących (do Gmaila), które pomyślnie przeszły weryfikację z użyciem bezpiecznego połączenia (TLS) w stosunku do wszystkich e-maili otrzymanych z danej domeny. Te dane dotyczą tylko ruchu, który przeszedł pozytywnie weryfikację SPF lub DKIM.
deliveryErrors[]

object (DeliveryError)

błędy dostarczania dla domeny; Te dane dotyczą tylko ruchu, który przeszedł pozytywnie weryfikację SPF lub DKIM.
userReportedSpamRatioLowerBound

number

Dolna granica przedziału ufności dla odsetka spamu zgłaszanego przez użytkowników. Jeśli to pole ma ustawioną wartość, wartość userReportedSpamRatio jest ustawiana na punkt środkowy tego przedziału i jest więc nieprecyzyjna. Prawdziwy stosunek jest jednak w 95% przypadków mieszczący się między tą dolną i odpowiadającą jej górną granicą. Ten rodzaj danych dotyczy tylko e-maili uwierzytelnionych za pomocą DKIM.
userReportedSpamRatioUpperBound

number

Górna granica przedziału ufności dla wskaźnika spamu zgłaszanego przez użytkowników. Jeśli to pole ma ustawioną wartość, wartość userReportedSpamRatio jest ustawiana na punkt środkowy tego przedziału i jest więc nieprecyzyjna. Prawdziwy współczynnik w 95% przypadków mieści się jednak w zakresie między górną a odpowiednią dolną granicą. Ten rodzaj danych dotyczy tylko e-maili uwierzytelnionych za pomocą DKIM.

IpReputation

Informacje o reputacji adresów IP dotyczące zbioru adresów IP w konkretnej kategorii reputacji.

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

enum (ReputationCategory)

Kategoria reputacji, do której należy adres IP.
ipCount

string (int64 format)

Łączna liczba unikalnych adresów IP w tej kategorii reputacji. Te dane dotyczą tylko ruchu, który przeszedł pozytywnie weryfikację SPF lub DKIM.
sampleIps[]

string

Przykład adresów IP w tej kategorii reputacji

ReputationCategory

Reputacja domeny lub adresu IP. Więcej informacji znajdziesz w sekcji „Panele dotyczące reputacji domeny i adresu 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 używać wprost. Stan, w którym nie ma dostępnych informacji o reputacji.
HIGH Nadawca ma bardzo dobre notowania (niski wskaźnik spamu) i stosuje się do wskazówek Google dla nadawców e-maili. Poczta od tego nadawcy jest bardzo rzadko oznaczana jako spam.
MEDIUM Nadawca zwykle nie wysyła spamu, zdarza mu się jedynie wysyłać jego niewielkie ilości w dużych odstępach czasu. Większość e-maili od tego nadawcy zostanie dostarczona, chyba że nastąpi znaczny wzrost wskaźnika spamu.
LOW Dochodziło do systematycznego wysyłania znacznych ilości spamu, istnieje duże prawdopodobieństwo, że poczta od tego nadawcy zostanie oznaczona jako spam.
BAD w przeszłości z danej domeny lub adresu IP wysyłano bardzo duże 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 przez użytkownika jako spam z tym identyfikatorem do łącznej liczby wiadomości ze spamem w skrzynce odbiorczej, które mają ten identyfikator.

DeliveryError

Dane dotyczące konkretnego typu błędu dostawy.

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

enum (DeliveryErrorClass)

Klasa błędu dostawy.
errorType

enum (DeliveryErrorType)

Typ błędu dostawy.
errorRatio

number

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

DeliveryErrorClass

Klasa błędu dostawy.

Wartości w polu enum
DELIVERY_ERROR_CLASS_UNSPECIFIED Wartość domyślna, której nigdy nie należy używać wprost.
PERMANENT_ERROR Dostarczanie wiadomości zostało odrzucone.
TEMPORARY_ERROR tymczasowy błąd dostawy wiadomości do odbiorcy.

DeliveryErrorType

Typ błędu dostawy.

Wartości w polu enum
DELIVERY_ERROR_TYPE_UNSPECIFIED Wartość domyślna, której nigdy nie należy używać wprost.
RATE_LIMIT_EXCEEDED Domena lub adres IP wysyła pocztę e-mail z podejrzanie dużą częstotliwością, z powodu której zostały nałożone tymczasowe ograniczenia. Zostaną one zniesione, kiedy Gmail będzie pewien, jaki jest charakter ruchu poczty e-mail.
SUSPECTED_SPAM Gmail z różnych powodów podejrzewa, że ruch jest spamem.
CONTENT_SPAMMY Przesyłane wiadomości są interpretowane jako potencjalny spam, ze względu na ich treść.
BAD_ATTACHMENT Przesyłane wiadomości zawierają załączniki nieobsługiwane przez Gmaila.
BAD_DMARC_POLICY W domenie nadawcy zostały skonfigurowane zasady odrzucania spamu zgodnie z mechanizmem DMARC.
LOW_IP_REPUTATION Reputacja adresu IP, z którego wysłano wiadomość, 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 1 publicznej liście zablokowanych adresów aktualizowanej w czasie rzeczywistym. Postaraj się o to, by Twój adres IP został usunięty z list RBL.
DOMAIN_IN_RBL Domena znajduje się na co najmniej 1 publicznej liście RBL. Postaraj się o to, by Twoja domena została usunięta z list RBL.
BAD_PTR_RECORD W IP nadawcy brakuje rekordu PTR.

Metody

get

 Pobierać statystyki ruchu w domenie w określonym dniu.

list

 Lista statystyk ruchu z wszystkich dostępnych dni.