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

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

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

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