REST Resource: domains.trafficStats

แหล่งข้อมูล: 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)
    }
  ],
  "userReportedSpamRatioLowerBound": number,
  "userReportedSpamRatioUpperBound": number
}
ช่อง
name

string

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

number

อัตราส่วนของจดหมายขยะที่ผู้ใช้รายงานเทียบกับอีเมลที่ส่งไปยังกล่องจดหมาย ซึ่งอาจไม่ถูกต้อง ผู้ใช้อาจต้องดูคำอธิบายของฟิลด์ช่วงเวลา userReportedSpamRatioLowerBound และ userReportedSpamRatioUpperBound เพื่อรับประกันความถูกต้องที่ชัดเจนยิ่งขึ้น เมตริกนี้เกี่ยวข้องกับอีเมลที่ผ่านการตรวจสอบสิทธิ์โดย 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 เท่านั้น
userReportedSpamRatioLowerBound

number

ขอบเขตล่างของช่วงความเชื่อมั่นสำหรับอัตราจดหมายขยะที่ผู้ใช้รายงาน หากตั้งค่าช่องนี้ไว้ ระบบจะตั้งค่า userReportedSpamRatio เป็นจุดกึ่งกลางของช่วงเวลานี้ จึงมีความคลาดเคลื่อน อย่างไรก็ตาม เรารับประกันว่าอัตราส่วนจริงจะอยู่ระหว่างขอบเขตล่างนี้กับขอบเขตบนที่เกี่ยวข้อง 95% ของเวลา เมตริกนี้เกี่ยวข้องกับอีเมลที่ผ่านการตรวจสอบสิทธิ์โดย DKIM เท่านั้น
userReportedSpamRatioUpperBound

number

ขอบเขตบนของช่วงความเชื่อมั่นสำหรับอัตราจดหมายขยะที่ผู้ใช้รายงาน หากตั้งค่าช่องนี้ไว้ ระบบจะตั้งค่า userReportedSpamRatio เป็นจุดกึ่งกลางของช่วงเวลานี้ จึงมีความคลาดเคลื่อน อย่างไรก็ตาม เรารับประกันว่าอัตราส่วนจริงจะอยู่ระหว่างขอบเขตบนนี้กับขอบเขตล่างที่เกี่ยวข้อง 95% ของเวลา เมตริกนี้เกี่ยวข้องกับอีเมลที่ผ่านการตรวจสอบสิทธิ์โดย 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 ที่ส่งมีความน่าเชื่อถือต่ำมาก
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

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