REST Resource: domains.trafficStats

Resource: TrafficStats

Statistik traffic email yang berkaitan dengan tanggal tertentu.

Representasi 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
}
Kolom
name

string

Nama resource statistik traffic. Nama statistik traffic memiliki format domains/{domain}/trafficStats/{date}, dengan domain_name adalah nama domain yang sepenuhnya memenuhi syarat (yaitu, mymail.mydomain.com) dari domain yang terkait dengan statistik traffic ini dan date adalah tanggal dalam format yyyymmdd yang sesuai dengan statistik ini. Misalnya: domains/mymail.mydomain.com/trafficStats/20160807

userReportedSpamRatio

number

Rasio spam yang dilaporkan pengguna vs email yang dikirim ke kotak masuk. Hal ini berpotensi tidak akurat -- pengguna dapat melihat deskripsi kolom interval userReportedSpamRatioLowerBound dan userReportedSpamRatioUpperBound untuk jaminan akurasi yang lebih eksplisit. Metrik ini hanya berlaku untuk email yang diautentikasi oleh DKIM.

ipReputations[]

object (IpReputation)

Informasi reputasi yang berkaitan dengan alamat IP server email untuk domain. Ada tepat satu entri untuk setiap kategori reputasi kecuali REPUTATION_CATEGORY_UNSPECIFIED.

domainReputation

enum (ReputationCategory)

Reputasi domain.

spammyFeedbackLoops[]

object (FeedbackLoop)

ID Feedback Loop berisi spam dengan rasio spam masing-masing. Metrik ini hanya berkaitan dengan traffic yang diautentikasi oleh DKIM.

spfSuccessRatio

number

Rasio email yang berhasil diautentikasi dengan SPF vs. semua email yang mencoba diautentikasi dengan SPF. Email spoof dikecualikan.

dkimSuccessRatio

number

Rasio email yang berhasil diautentikasi dengan DKIM vs. semua email yang mencoba diautentikasi dengan DKIM. Email spoof dikecualikan.

dmarcSuccessRatio

number

Rasio email yang lulus pemeriksaan kesesuaian DMARC vs semua email yang diterima dari domain yang berhasil diautentikasi dengan SPF atau DKIM.

outboundEncryptionRatio

number

Rasio email keluar (dari Gmail) yang diterima melalui transmisi aman (TLS).

inboundEncryptionRatio

number

Rasio email masuk (ke Gmail), yang lulus transmisi aman (TLS) vs semua email yang diterima dari domain tersebut. Metrik ini hanya berkaitan dengan traffic yang lulus SPF atau DKIM.

deliveryErrors[]

object (DeliveryError)

Error pengiriman untuk domain. Metrik ini hanya berkaitan dengan traffic yang lulus SPF atau DKIM.

userReportedSpamRatioLowerBound

number

Batas bawah interval keyakinan untuk rasio spam yang dilaporkan pengguna. Jika kolom ini ditetapkan, nilai userReportedSpamRatio akan ditetapkan ke titik tengah interval ini sehingga tidak akurat. Namun, rasio sebenarnya dijamin berada di antara batas bawah ini dan batas atas yang sesuai 95% dari waktu. Metrik ini hanya berlaku untuk email yang diautentikasi oleh DKIM.

userReportedSpamRatioUpperBound

number

Batas atas interval keyakinan untuk rasio spam yang dilaporkan pengguna. Jika kolom ini ditetapkan, nilai userReportedSpamRatio akan ditetapkan ke titik tengah interval ini sehingga tidak akurat. Namun, rasio sebenarnya dijamin berada di antara batas atas ini dan batas bawah yang sesuai 95% dari waktu. Metrik ini hanya berlaku untuk email yang diautentikasi oleh DKIM.

IpReputation

Informasi Reputasi IP untuk kumpulan IP dalam kategori reputasi tertentu.

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

enum (ReputationCategory)

Kategori reputasi yang diwakili oleh reputasi IP ini.

ipCount

string (int64 format)

Jumlah total IP unik dalam kategori reputasi ini. Metrik ini hanya berkaitan dengan traffic yang lulus SPF atau DKIM.

sampleIps[]

string

Contoh IP dalam kategori reputasi ini.

ReputationCategory

Reputasi domain atau IP. Untuk informasi selengkapnya, lihat "Dasbor Reputasi Domain & IP" di bagian Dasbor di halaman bantuan Postmaster Tools.

Enum
REPUTATION_CATEGORY_UNSPECIFIED Nilai default yang tidak boleh digunakan secara eksplisit. Ini menunjukkan status saat tidak ada informasi reputasi yang tersedia.
HIGH Memiliki catatan bagus terkait rasio spam yang sangat rendah, dan mematuhi panduan pengirim Gmail. Email jarang ditandai oleh filter spam.
MEDIUM Diketahui sebagai pengirim email yang baik, tetapi rentan terhadap pengiriman spam dalam jumlah rendah. Sebagian besar email dari entitas ini akan memiliki tingkat pengiriman sedang, kecuali saat terjadi peningkatan level spam yang mencolok.
LOW Diketahui telah mengirimkan cukup banyak spam secara rutin. Email dari pengirim ini kemungkinan ditandai sebagai spam.
BAD Histori mengirimkan sangat banyak spam. Email dari entitas ini hampir selalu ditolak di tingkat SMTP atau ditandai sebagai spam.

FeedbackLoop

Informasi ID Feedback loop.

Representasi JSON
{
  "id": string,
  "spamRatio": number
}
Kolom
id

string

ID feedback loop yang secara unik mengidentifikasi setiap kampanye.

spamRatio

number

Rasio pesan spam yang ditandai pengguna dengan ID tersebut vs jumlah total pesan yang masuk ke kotak masuk dengan ID tersebut.

DeliveryError

Metrik tentang jenis error pengiriman tertentu.

Representasi JSON
{
  "errorClass": enum (DeliveryErrorClass),
  "errorType": enum (DeliveryErrorType),
  "errorRatio": number
}
Kolom
errorClass

enum (DeliveryErrorClass)

Class error pengiriman.

errorType

enum (DeliveryErrorType)

Jenis error pengiriman.

errorRatio

number

Rasio pesan tempat error terjadi vs. semua traffic yang diautentikasi.

DeliveryErrorClass

Class error pengiriman.

Enum
DELIVERY_ERROR_CLASS_UNSPECIFIED Nilai default yang tidak boleh digunakan secara eksplisit.
PERMANENT_ERROR Pengiriman pesan telah ditolak.
TEMPORARY_ERROR Kegagalan sementara pengiriman pesan kepada penerima.

DeliveryErrorType

Jenis error pengiriman.

Enum
DELIVERY_ERROR_TYPE_UNSPECIFIED Nilai default yang tidak boleh digunakan secara eksplisit.
RATE_LIMIT_EXCEEDED Domain atau IP mengirimkan traffic pada rasio tinggi yang mencurigakan, karena batas kapasitas yang sementara diberlakukan. Batas tersebut akan dicabut ketika Gmail cukup yakin dengan normalnya traffic.
SUSPECTED_SPAM Traffic dicurigai sebagai spam oleh Gmail karena berbagai alasan.
CONTENT_SPAMMY Traffic dicurigai berisi spam, khusus untuk konten tersebut.
BAD_ATTACHMENT Traffic berisi lampiran yang tidak didukung oleh Gmail.
BAD_DMARC_POLICY Domain pengirim telah menyiapkan kebijakan penolakan DMARC.
LOW_IP_REPUTATION Reputasi IP pengirim sangat rendah.
LOW_DOMAIN_REPUTATION Reputasi domain pengirim sangat rendah.
IP_IN_RBL IP tercantum dalam satu atau beberapa Daftar Blackhole Real-time publik. Hubungi admin RBL untuk menghapus IP Anda dari daftar.
DOMAIN_IN_RBL Domain tercantum dalam satu atau beberapa Daftar Blackhole Real-time publik. Hubungi admin RBL untuk menghapus domain Anda dari daftar.
BAD_PTR_RECORD IP pengirim tidak memiliki data PTR.

Metode

get

Mendapatkan statistik traffic untuk domain pada tanggal tertentu.

list

Mencantumkan statistik traffic untuk semua hari yang tersedia.