REST Resource: domains.trafficStats

Tài nguyên: TrafficStats

Số liệu thống kê về lưu lượng truy cập qua 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)
    }
  ],
  "userReportedSpamRatioLowerBound": number,
  "userReportedSpamRatioUpperBound": number
}
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 số liệu 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 đến và date 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ệ giữa số lượng thư rác do người dùng báo cáo so với số lượng email đã được gửi vào hộp thư đến. Điều này có thể không chính xác – người dùng nên tham khảo nội dung mô tả về các trường khoảng thời gian userReportedSpamRatioLowerBound và userReportedSpamRatioUpperBound để đảm bảo độ chính xác rõ ràng hơn. Chỉ số này chỉ áp dụng cho những email được xác thực bằng DKIM.
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. Mỗi danh mục danh tiếng chỉ có đúng một mục nhập, ngoại trừ REPUTATION_CATEGORY_UNSPECIFIED.
domainReputation

enum (ReputationCategory)

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

object (FeedbackLoop)

Mã vòng hồi tiếp vi phạm cùng với 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 xác thực bằng DKIM.
spfSuccessRatio

number

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

number

Tỷ lệ thư đã 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 việc tuân thủ 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 phương thức truyền tải an toàn (TLS).
inboundEncryptionRatio

number

Tỷ lệ thư đến (vào Gmail) đã vượt qua phương thức 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 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 SPF hoặc DKIM.
userReportedSpamRatioLowerBound

number

Giới hạn dưới của khoảng tin cậy cho tỷ lệ thư rác do người dùng báo cáo. Nếu bạn đặt trường này, thì giá trị của userReportedSpamRatio sẽ được đặt thành điểm giữa của khoảng thời gian này và do đó không chính xác. Tuy nhiên, tỷ lệ thực sự được đảm bảo nằm giữa giới hạn dưới này và giới hạn trên tương ứng trong 95% trường hợp. Chỉ số này chỉ áp dụng cho những email được xác thực bằng DKIM.
userReportedSpamRatioUpperBound

number

Giới hạn trên của khoảng tin cậy cho tỷ lệ thư rác do người dùng báo cáo. Nếu bạn đặt trường này, thì giá trị của userReportedSpamRatio sẽ được đặt thành điểm giữa của khoảng thời gian này và do đó không chính xác. Tuy nhiên, tỷ lệ thực sự được đảm bảo nằm giữa giới hạn trên này và giới hạn dưới tương ứng trong 95% trường hợp. Chỉ số này chỉ áp dụng cho những email được xác thực bằng DKIM.

IpReputation

Thông tin về uy tín của địa chỉ IP cho một nhóm địa chỉ IP thuộc một danh mục uy tín 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 mà danh tiếng của địa chỉ IP này đại diện.
ipCount

string (int64 format)

Tổng số IP riêng biệt trong danh mục uy tín 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ẫu IP thuộc danh mục uy tín này.

ReputationCategory

Danh tiếng của một miền hoặc địa chỉ IP. Để biết thêm thông tin, hãy xem phần "Trang tổng quan về danh tiếng của miền và 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 không được sử dụng một cách rõ ràng. Trạng thái này thể hiện trạng thái không có thông tin về uy tín.
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 của Gmail dành cho người gửi. Thư sẽ hiếm khi bị các bộ lọc thư rác đánh dấu.
MEDIUM Được biết là gửi thư hợp lệ, 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 ở mức vừa phải, trừ khi 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ư nhận được từ người gửi này có khả năng sẽ bị đánh dấu là thư rác.
BAD Có 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 gần 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 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ệ giữa số lượng thư rác do người dùng đánh dấu có giá trị nhận dạng so với tổng số thư có giá trị nhận dạng đó trong hộp thư đến.

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 khi gửi thư.
errorType

enum (DeliveryErrorType)

Loại lỗi khi gửi thư.
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 khi gửi thư.

Enum
DELIVERY_ERROR_CLASS_UNSPECIFIED Giá trị mặc định không được sử dụng một cách rõ ràng.
PERMANENT_ERROR Đã từ chối phân phối thư.
TEMPORARY_ERROR Temporarily failure of message delivery to the recipient (Tạm thời không gửi được thư đến người nhận).

DeliveryErrorType

Loại lỗi khi gửi thư.

Enum
DELIVERY_ERROR_TYPE_UNSPECIFIED Giá trị mặc định 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 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 này sẽ được gỡ bỏ khi Gmail đủ tin tưởng về bản chất của lưu lượng.
SUSPECTED_SPAM Lưu lượng bị Gmail nghi ngờ là nội dung rác vì nhiều lý do.
CONTENT_SPAMMY Lưu lượng bị nghi ngờ là nội dung rác, cụ thể là do nội dung.
BAD_ATTACHMENT Lưu lượng 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 ở mức rất thấp.
LOW_DOMAIN_REPUTATION Danh tiếng của miền gửi thư ở mức rất thấp.
IP_IN_RBL Địa chỉ IP có trong một hoặc nhiều Danh sách hố đen thời gian thực công khai. Hãy làm việc với RBL để đưa địa chỉ IP của bạn ra khỏi danh sách này.
DOMAIN_IN_RBL Miền có trong một hoặc nhiều Danh sách đen công khai theo thời gian thực. Hãy làm việc với RBL để đưa miền của bạn ra khỏi danh sách này.
BAD_PTR_RECORD Địa chỉ IP gửi bị thiếu bản ghi PTR.

Phương thức

get

 Xem số liệu thống kê về lưu lượng truy cập của 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 có sẵn.