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)
    }
  ]
}
필드
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

SPF 또는 DKIM으로 인증된 도메인에서 받은 모든 메일의 대비 DMARC 정렬 검사를 통과한 메일의 비율입니다.
outboundEncryptionRatio

number

보안 전송 (TLS)을 통해 수락된 발신 메일 (Gmail 발신)의 비율입니다.
inboundEncryptionRatio

number

해당 도메인에서 수신된 모든 메일 대비 보안 전송 (TLS)을 통과한 수신 메일 (Gmail 대비)의 비율입니다. 이 측정항목은 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의 평판 자세한 내용은 Postmaster Tools 도움말 페이지의 Dashboards(대시보드) 섹션에 있는 "Domain & IP Reputation Dashboards(도메인 및 IP 평판 대시보드)"를 참조하세요.

열거형
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

전송 오류 클래스입니다.

열거형
DELIVERY_ERROR_CLASS_UNSPECIFIED 명시적으로 사용해서는 안 되는 기본값입니다.
PERMANENT_ERROR 메시지 전송이 거부되었습니다.
TEMPORARY_ERROR 수신자에게 일시적으로 메일이 전송되지 않았습니다.

DeliveryErrorType

전송 오류의 유형입니다.

열거형
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가 하나 이상의 공개 실시간 블랙홀 리스트에 등록되어 있습니다. RBL과 협조하여 IP를 목록에서 삭제합니다.
DOMAIN_IN_RBL 도메인이 하나 이상의 공개 실시간 블랙홀 리스트에 등록되어 있습니다. RBL에 협조하여 도메인을 삭제합니다.
BAD_PTR_RECORD 발신 IP에 PTR 레코드가 누락되었습니다.

방법

get

 특정 날짜에 도메인 트래픽 통계를 가져옵니다.

list

 사용 가능한 모든 날짜의 트래픽 통계를 나열합니다.