REST Resource: domains.trafficStats

Tài nguyên: TrafficStats

Số liệu thống kê về lưu lượng truy cập email liên quan đến một ngày cụ thể.

Biểu diễn dưới dạng 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)
    }
  ]
}
Các trường
name

string

Tên tài nguyên của số liệu thống kê về lưu lượng truy cập. Tên thống kê lưu lượng truy cập có dạng domains/{domain}/trafficStats/{date}, trong đó domain_name là tên miền đủ điều kiện (ví dụ: mymail.mydomain.com) của miền mà số liệu thống kê lưu lượng truy cập này liên quan và ngày tháng là ngày ở định dạng yyyymmdd tương ứng với các số liệu thống kê này. Ví dụ: domains/mymail.mydomain.com/trafficStats/20160807
userReportedSpamRatio

number

Tỷ lệ thư rác do người dùng báo cáo so với email được gửi vào hộp thư đến. Chỉ số này chỉ liên quan đến những email do DKIM xác thực.
ipReputations[]

object (IpReputation)

Thông tin về danh tiếng liên quan đến địa chỉ IP của máy chủ email cho miền. Chỉ có đúng một mục nhập cho mỗi danh mục danh tiếng, ngoại trừ REPUTATION_CATEGORY_UNSPECIFIED.
domainReputation

enum (ReputationCategory)

Danh tiếng của miền.
spammyFeedbackLoops[]

object (FeedbackLoop)

Giá trị nhận dạng vòng lặp phản hồi rác kèm theo tỷ lệ thư rác riêng lẻ. Chỉ số này chỉ liên quan đến lưu lượng truy cập được DKIM xác thực.
spfSuccessRatio

number

Tỷ lệ thư đã xác thực thành công bằng SPF so với tất cả thư đã cố xác thực bằng SPF. Loại thư giả mạo.
dkimSuccessRatio

number

Tỷ lệ thư được xác thực thành công bằng DKIM so với tất cả thư đã cố xác thực bằng DKIM. Loại thư giả mạo.
dmarcSuccessRatio

number

Tỷ lệ thư đã vượt qua các bước kiểm tra căn chỉnh DMARC so với tất cả thư nhận được từ miền đã xác thực thành công bằng SPF hoặc DKIM.
outboundEncryptionRatio

number

Tỷ lệ thư đi (từ Gmail) được chấp nhận thông qua truyền tải an toàn (TLS).
inboundEncryptionRatio

number

Tỷ lệ thư đến (vào Gmail) đã vượt qua truyền tải an toàn (TLS) so với tất cả thư nhận được từ miền đó. Chỉ số này chỉ liên quan đến lưu lượng truy cập đã vượt qua ngưỡng SPF hoặc DKIM.
deliveryErrors[]

object (DeliveryError)

Lỗi gửi thư cho miền. Chỉ số này chỉ liên quan đến lưu lượng truy cập đã vượt qua ngưỡng SPF hoặc DKIM.

IpReputation

Thông tin về Danh tiếng IP cho một nhóm địa chỉ IP trong một danh mục danh tiếng cụ thể.

Biểu diễn dưới dạng JSON 
{
  "reputation": enum (ReputationCategory),
  "ipCount": string,
  "sampleIps": [
    string
  ]
}
Các trường
reputation

enum (ReputationCategory)

Danh mục danh tiếng mà IP này đại diện.
ipCount

string (int64 format)

Tổng số IP duy nhất trong danh mục danh tiếng này. Chỉ số này chỉ liên quan đến lưu lượng truy cập đã vượt qua ngưỡng SPF hoặc DKIM.
sampleIps[]

string

Một mẫu IP trong danh mục danh tiếng này.

ReputationCategory

Danh tiếng của miền hoặc IP. Để biết thêm thông tin, hãy xem "Trang tổng quan về danh tiếng miền và IP" trong phần Trang tổng quan trên trang trợ giúp Công cụ Postmaster.

Enum
REPUTATION_CATEGORY_UNSPECIFIED Giá trị mặc định không bao giờ được sử dụng rõ ràng. Đây là trạng thái không có thông tin về danh tiếng.
HIGH Có hồ sơ theo dõi tốt với tỷ lệ thư rác rất thấp và tuân thủ các nguyên tắc dành cho người gửi trong Gmail. Thư sẽ hiếm khi bị bộ lọc thư rác đánh dấu.
MEDIUM Được biết là có thể gửi thư tốt, nhưng có thể gửi một lượng nhỏ thư rác không liên tục. Hầu hết email do thực thể này gửi sẽ có tỷ lệ gửi được khá tốt, trừ phi có sự gia tăng đáng kể về mức độ thư rác.
LOW Được biết là thường xuyên gửi một lượng thư rác đáng kể và thư từ người gửi này có khả năng sẽ bị đánh dấu là thư rác.
BAD Lịch sử gửi một lượng thư rác vô cùng lớn. Thư do thực thể này gửi hầu như luôn bị từ chối ở cấp SMTP hoặc bị đánh dấu là thư rác.

FeedbackLoop

Thông tin về giá trị nhận dạng Vòng lặp phản hồi.

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "spamRatio": number
}
Các trường
id

string

Giá trị nhận dạng vòng lặp phản hồi giúp xác định riêng từng chiến dịch.
spamRatio

number

Tỷ lệ giữa số thư rác do người dùng đánh dấu bằng giá trị nhận dạng so với tổng số thư trong hộp thư đến có giá trị nhận dạng đó.

DeliveryError

Chỉ số về loại lỗi phân phối cụ thể.

Biểu diễn dưới dạng JSON 
{
  "errorClass": enum (DeliveryErrorClass),
  "errorType": enum (DeliveryErrorType),
  "errorRatio": number
}
Các trường
errorClass

enum (DeliveryErrorClass)

Loại lỗi phân phối.
errorType

enum (DeliveryErrorType)

Loại lỗi phân phối.
errorRatio

number

Tỷ lệ thư xảy ra lỗi so với tất cả lưu lượng truy cập đã xác thực.

DeliveryErrorClass

Loại lỗi phân phối.

Enum
DELIVERY_ERROR_CLASS_UNSPECIFIED Giá trị mặc định không bao giờ được sử dụng rõ ràng.
PERMANENT_ERROR Đã từ chối gửi thư.
TEMPORARY_ERROR Lỗi tạm thời khi gửi thư cho người nhận.

DeliveryErrorType

Loại lỗi phân phối.

Enum
DELIVERY_ERROR_TYPE_UNSPECIFIED Giá trị mặc định không bao giờ được sử dụng rõ ràng.
RATE_LIMIT_EXCEEDED Miền hoặc IP đang gửi lưu lượng với tốc độ cao đáng ngờ, do đó giới hạn tốc độ tạm thời đã được áp đặt. Giới hạn sẽ được gỡ bỏ khi Gmail đủ tin tưởng về bản chất của lưu lượng truy cập.
SUSPECTED_SPAM Lưu lượng bị nghi ngờ là thư rác, bởi Gmail, vì nhiều lý do.
CONTENT_SPAMMY Lưu lượng này bị nghi ngờ là lưu lượng vi phạm, chỉ liên quan đến nội dung trên trang.
BAD_ATTACHMENT Lưu lượng truy cập có chứa những tệp đính kèm mà Gmail không hỗ trợ.
BAD_DMARC_POLICY Miền của người gửi đã thiết lập chính sách từ chối DMARC.
LOW_IP_REPUTATION Danh tiếng IP của IP gửi là rất thấp.
LOW_DOMAIN_REPUTATION Miền gửi thư có danh tiếng rất thấp.
IP_IN_RBL IP bị liệt kê trong một hoặc nhiều Danh sách lỗ đen theo thời gian thực công khai. Hãy làm việc với RBL để đưa IP của bạn ra khỏi danh sách.
DOMAIN_IN_RBL Miền có trong một hoặc nhiều Danh sách lỗ đen theo thời gian thực công khai. Hãy làm việc với RBL để đưa miền của bạn ra khỏi danh sách.
BAD_PTR_RECORD IP gửi bị thiếu bản ghi PTR.

Phương thức

get

 Nhận số liệu thống kê về lưu lượng truy cập cho một miền vào một ngày cụ thể.

list

 Liệt kê số liệu thống kê về lưu lượng truy cập cho tất cả các ngày hiện có.