REST Resource: domains.trafficStats

Tài nguyên: TrafficStats

Thống kê 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)
    }
  ]
}
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 có liên quan và ngày là ngày ở định dạng yyyymmdd tương ứng với những 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 các 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 các máy chủ email cho miền. Mỗi danh mục danh tiếng chỉ có một mục duy nhất, 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 hồi tiếp của nội dung 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ư được 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. Không bao gồm 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ố gắng xác thực bằng DKIM. Không bao gồm thư giả mạo.

dmarcSuccessRatio

number

Tỷ lệ thư vượt qua quy trình kiểm tra so khớp DMARC so với tất cả thư nhận được từ miền đã xác thực thành công bằng một trong hai SPF hoặc DKIM.

outboundEncryptionRatio

number

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

inboundEncryptionRatio

number

Tỷ lệ thư đến (so với 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 SPF hoặc DKIM.

deliveryErrors[]

object (DeliveryError)

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

IpReputation

Thông tin về danh tiếng IP cho một nhóm 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
  ]
}
Trường
reputation

enum (ReputationCategory)

Danh mục danh tiếng của địa chỉ IP này.

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 SPF hoặc DKIM.

sampleIps[]

string

Một mẫu về 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 phần "Miền và Trang tổng quan về danh tiếng IP" trong mục Trang tổng quan trên trang trợ giúp của Công cụ Postmaster.

Enum
REPUTATION_CATEGORY_UNSPECIFIED Giá trị mặc định tuyệt đối không được sử dụng một cách rõ ràng. Thuộc tính này thể hiện trạng thái không có thông tin về danh tiếng.
HIGH Có hồ sơ theo dõi hoạt động 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 email trong Gmail. Thư sẽ hiếm khi bị bộ lọc thư rác đánh dấu.
MEDIUM Được biết là 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 từ thực thể này sẽ có tỷ lệ gửi ở mức hợp lý, 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ó thể 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 trong Vòng hồi tiếp.

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

string

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

spamRatio

number

Tỷ lệ thư rác được người dùng đánh dấu bằng giá trị nhận dạng này so với tổng số thư được gửi vào hộp thư đến có giá trị nhận dạng đó.

DeliveryError

Chỉ số về một 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
}
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ệ giữa số thông báo xảy ra lỗi so với tất cả lưu lượng đã xác thực.

DeliveryErrorClass

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

Enum
DELIVERY_ERROR_CLASS_UNSPECIFIED Giá trị mặc định tuyệt đối không được sử dụng một cách rõ ràng.
PERMANENT_ERROR Việc gửi thư đã bị từ chối.
TEMPORARY_ERROR Tạm thời không gửi được thư đến người nhận.

DeliveryErrorType

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

Enum
DELIVERY_ERROR_TYPE_UNSPECIFIED Giá trị mặc định tuyệt đối không được sử dụng một cách rõ ràng.
RATE_LIMIT_EXCEEDED Miền hoặc IP đang gửi lưu lượng truy cập 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 có đủ sự tin tưởng về bản chất của lưu lượng truy cập.
SUSPECTED_SPAM Lưu lượng truy cập bị Gmail nghi ngờ là thư rác vì nhiều lý do.
CONTENT_SPAMMY Lưu lượng truy cập này bị nghi ngờ là lưu lượng truy cập không liên quan, chỉ liên quan đến nội dung có liên quan.
BAD_ATTACHMENT Lưu lượng truy cập có chứa tệp đính kèm không được Gmail 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 của địa chỉ IP gửi thư là rất thấp.
LOW_DOMAIN_REPUTATION Danh tiếng của miền gửi thư rất thấp.
IP_IN_RBL IP bị liệt kê trong một hoặc nhiều Danh sách lỗ hổng bảo mật theo thời gian thực công khai. Hãy làm việc với RBL để xoá IP của bạn.
DOMAIN_IN_RBL Miền có tên trong một hoặc nhiều Danh sách lỗ hổng bảo mật 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 bị xoá.
BAD_PTR_RECORD IP gửi thiếu bản ghi PTR.

Phương thức

get

Nhận thống kê lưu lượng truy cập cho tên 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 có sẵn.