REST Resource: domains.trafficStats

แหล่งข้อมูล: สถิติการเข้าชม

สถิติการรับส่งอีเมลในวันที่ที่ระบุ

การแสดง 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)
    }
  ]
}
ช่อง
name

string

ชื่อทรัพยากรของสถิติการเข้าชม ชื่อสถิติการเข้าชมอยู่ในรูปแบบ domains/{domain}/trafficStats/{date} โดยที่ domain_name คือชื่อโดเมนที่สมบูรณ์ในตัวเอง (เช่น mymail.mydomain.com) ของโดเมนที่สถิติการเข้าชมนี้เกี่ยวข้อง และวันที่คือวันที่ในรูปแบบ yyyymmdd ที่สอดคล้องกับสถิติเหล่านี้ ตัวอย่างเช่น domains/mymail.mydomain.com/trafficStats/20160807
userReportedSpamRatio

number

อัตราส่วนของจดหมายขยะที่ผู้ใช้รายงานเทียบกับอีเมลที่ส่งไปยังกล่องจดหมาย เมตริกนี้เกี่ยวข้องกับอีเมลที่ตรวจสอบสิทธิ์โดย DKIM เท่านั้น
ipReputations[]

object (IpReputation)

ข้อมูลชื่อเสียงที่เกี่ยวข้องกับที่อยู่ IP ของเซิร์ฟเวอร์อีเมลสำหรับโดเมน แต่ละหมวดหมู่ความน่าเชื่อถือจะมีเพียงรายการเดียวเท่านั้น ยกเว้น REPUTATION_CATEGORY_UNSPECIFIED
domainReputation

enum (ReputationCategory)

ชื่อเสียงของโดเมน
spammyFeedbackLoops[]

object (FeedbackLoop)

ตัวระบุลูปความคิดเห็นที่เป็นสแปมอยู่ด้วยอัตราสแปมเฉพาะบุคคล เมตริกนี้เกี่ยวข้องกับการรับส่งข้อมูลที่ตรวจสอบสิทธิ์โดย DKIM เท่านั้น
spfSuccessRatio

number

อัตราส่วนของอีเมลที่ตรวจสอบสิทธิ์ด้วย SPF เรียบร้อยแล้วเทียบกับอีเมลทั้งหมดที่พยายามตรวจสอบสิทธิ์ด้วย SPF แต่จะไม่รวมอีเมลที่ปลอมแปลง
dkimSuccessRatio

number

อัตราส่วนของอีเมลที่ตรวจสอบสิทธิ์ด้วย DKIM สำเร็จเทียบกับอีเมลทั้งหมดที่พยายามตรวจสอบสิทธิ์ด้วย DKIM แต่จะไม่รวมอีเมลที่ปลอมแปลง
dmarcSuccessRatio

number

อัตราส่วนของอีเมลที่ผ่านการตรวจสอบความสอดคล้อง DMARC เมื่อเทียบกับอีเมลทั้งหมดที่ได้รับจากโดเมนที่ตรวจสอบสิทธิ์ด้วย SPF หรือ DKIM เรียบร้อยแล้ว
outboundEncryptionRatio

number

อัตราส่วนของอีเมลขาออก (จาก Gmail) ที่ยอมรับผ่านการส่งที่ปลอดภัย (TLS)
inboundEncryptionRatio

number

อัตราส่วนของอีเมลขาเข้า (ต่อ Gmail) ซึ่งผ่านการส่งที่ปลอดภัย (TLS) เทียบกับอีเมลทั้งหมดที่ได้รับจากโดเมนนั้น เมตริกนี้เกี่ยวข้องกับการรับส่งข้อมูลที่ผ่าน SPF หรือ DKIM เท่านั้น
deliveryErrors[]

object (DeliveryError)

ข้อผิดพลาดในการส่งโดเมน เมตริกนี้เกี่ยวข้องกับการรับส่งข้อมูลที่ผ่าน SPF หรือ DKIM เท่านั้น

IpReputation

ข้อมูลชื่อเสียงของ IP สำหรับชุดของ IP ในหมวดหมู่ชื่อเสียงที่ระบุ

การแสดง JSON 
{
  "reputation": enum (ReputationCategory),
  "ipCount": string,
  "sampleIps": [
    string
  ]
}
ช่อง
reputation

enum (ReputationCategory)

หมวดหมู่ความน่าเชื่อถือที่ความน่าเชื่อถือ IP นี้แสดง
ipCount

string (int64 format)

จำนวน IP ที่ไม่ซ้ำกันทั้งหมดในหมวดหมู่ชื่อเสียงนี้ เมตริกนี้เกี่ยวข้องกับการรับส่งข้อมูลที่ผ่าน SPF หรือ DKIM เท่านั้น
sampleIps[]

string

ตัวอย่างของ IP ในหมวดหมู่ชื่อเสียงนี้

ReputationCategory

ชื่อเสียงของโดเมนหรือ IP สำหรับข้อมูลเพิ่มเติม โปรดดูที่ "แดชบอร์ดชื่อเสียงของโดเมนและ IP" ในส่วนหน้าแดชบอร์ดบนหน้าความช่วยเหลือของเครื่องมือ Postmaster

Enum
REPUTATION_CATEGORY_UNSPECIFIED ค่าเริ่มต้นที่ไม่ควรใช้อย่างชัดแจ้ง นี่เป็นรัฐที่ไม่มีข้อมูลชื่อเสียง
HIGH มีประวัติที่ดีว่าอัตราจดหมายขยะต่ำและปฏิบัติตามหลักเกณฑ์ผู้ส่งของ Gmail ตัวกรองจดหมายขยะไม่ค่อยทำเครื่องหมายอีเมล
MEDIUM เป็นที่ทราบว่าส่งอีเมลที่มีคุณภาพ แต่มีแนวโน้มที่จะส่งจดหมายขยะในปริมาณต่ำมาด้วย อีเมลส่วนใหญ่จากเอนทิตีนี้จะมีอัตราการนำส่งในระดับพอใช้ ยกเว้นเมื่อระดับจดหมายขยะสูงขึ้นอย่างเห็นได้ชัด
LOW เป็นที่ทราบว่าส่งจดหมายขยะปริมาณมากเป็นประจำ และอีเมลจากผู้ส่งมักจะถูกทำเครื่องหมายว่าเป็นจดหมายขยะ
BAD ประวัติการส่งจดหมายขยะในปริมาณที่สูงมาก อีเมลจากเอนทิตีนี้มักจะถูกปฏิเสธที่ระดับ SMTP หรือถูกทำเครื่องหมายว่าเป็นจดหมายขยะเกือบทุกครั้ง

FeedbackLoop

ข้อมูลตัวระบุลูปความคิดเห็น

การแสดง JSON 
{
  "id": string,
  "spamRatio": number
}
ช่อง
id

string

ตัวระบุลูปความคิดเห็นที่ระบุแคมเปญแต่ละรายการโดยไม่ซ้ำกัน
spamRatio

number

อัตราส่วนของผู้ใช้ที่เป็นข้อความสแปมซึ่งมีตัวระบุดังกล่าว เทียบกับจำนวนข้อความทั้งหมดในกล่องจดหมายที่มีตัวระบุนั้น

DeliveryError

เมตริกสำหรับประเภทข้อผิดพลาดในการนำส่งที่เจาะจง

การแสดง JSON 
{
  "errorClass": enum (DeliveryErrorClass),
  "errorType": enum (DeliveryErrorType),
  "errorRatio": number
}
ช่อง
errorClass

enum (DeliveryErrorClass)

ประเภทข้อผิดพลาดในการนำส่ง
errorType

enum (DeliveryErrorType)

ประเภทของข้อผิดพลาดในการนำส่ง
errorRatio

number

อัตราส่วนของข้อความที่เกิดข้อผิดพลาดเทียบกับปริมาณการรับส่งข้อมูลที่ได้รับการตรวจสอบสิทธิ์ทั้งหมด

DeliveryErrorClass

ประเภทข้อผิดพลาดในการนำส่ง

Enum
DELIVERY_ERROR_CLASS_UNSPECIFIED ค่าเริ่มต้นที่ไม่ควรใช้อย่างชัดแจ้ง
PERMANENT_ERROR การส่งข้อความถูกปฏิเสธ
TEMPORARY_ERROR ส่งข้อความไปยังผู้รับไม่สำเร็จชั่วคราว

DeliveryErrorType

ประเภทของข้อผิดพลาดในการนำส่ง

Enum
DELIVERY_ERROR_TYPE_UNSPECIFIED ค่าเริ่มต้นที่ไม่ควรใช้อย่างชัดแจ้ง
RATE_LIMIT_EXCEEDED โดเมนหรือ IP ส่งการรับส่งข้อมูลในอัตราที่สูงจนน่าสงสัย เนื่องจากมีการกำหนดขีดจำกัดอัตราชั่วคราวไว้ Gmail จะยกเลิกข้อจำกัดดังกล่าวเมื่อมีความมั่นใจพอควรในลักษณะของการรับส่งข้อความ
SUSPECTED_SPAM Gmail สงสัยว่าการรับส่งข้อมูลนี้เป็นสแปมด้วยเหตุผลหลายประการ
CONTENT_SPAMMY ระบบสงสัยว่าการรับส่งข้อความเป็นจดหมายขยะเนื่องจากเนื้อหาโดยเฉพาะ
BAD_ATTACHMENT การรับส่งข้อมูลมีไฟล์แนบที่ Gmail ไม่รองรับ
BAD_DMARC_POLICY โดเมนผู้ส่งมีการตั้งค่านโยบายการปฏิเสธ DMARC
LOW_IP_REPUTATION IP ที่ส่งมีความน่าเชื่อถือของ IP ที่ส่งต่ำมาก
LOW_DOMAIN_REPUTATION โดเมนที่ส่งมีความน่าเชื่อถือต่ำมาก
IP_IN_RBL IP อยู่ในรายการ Real-time Blackhole สาธารณะอย่างน้อย 1 รายการ ติดต่อ RBL เพื่อขอให้นำ IP ของคุณออกจากผลการค้นหา
DOMAIN_IN_RBL โดเมนมีรายชื่ออยู่ในรายการ Real-time Blackhole สาธารณะอย่างน้อย 1 รายการ ติดต่อ RBL เพื่อขอให้นำโดเมนของคุณออกจากรายการดังกล่าว
BAD_PTR_RECORD IP ที่ส่งไม่มีระเบียน PTR

วิธีการ

get

 ดูสถิติการเข้าชมสำหรับโดเมนในวันที่ที่ระบุ

list

 แสดงรายการสถิติการเข้าชมสำหรับวันที่มีให้บริการทั้งหมด