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)
    }
  ],
  "userReportedSpamRatioLowerBound": number,
  "userReportedSpamRatioUpperBound": number
}
フィールド
name

string

トラフィック統計情報のリソース名。トラフィック統計情報の名前は domains/{domain}/trafficStats/{date} の形式で、domain_name は、このトラフィック統計情報に関連するドメインの完全修飾ドメイン名（mymail.mydomain.com など）、date はこれらの統計情報に対応する日付（yyyymmdd 形式）です。例: domains/mymail.mydomain.com/trafficStats/20160807
userReportedSpamRatio

number

受信トレイに届いたメールのうち、ユーザーが迷惑メールとして報告したメールの比率。これは不正確な可能性があります。より明確な精度保証については、区間フィールド userReportedSpamRatioLowerBound と userReportedSpamRatioUpperBound の説明を参照してください。この指標は、DKIM で認証されたメールにのみ関連します。
ipReputations[]

object (IpReputation)

ドメインのメールサーバーの IP アドレスに関する評判情報。REPUTATION_CATEGORY_UNSPECIFIED を除き、評判カテゴリごとにエントリが 1 つずつあります。
domainReputation

enum (ReputationCategory)

ドメインのレピュテーション。
spammyFeedbackLoops[]

object (FeedbackLoop)

スパム的なフィードバック ループ ID と個々の迷惑メール率。この指標は、DKIM で認証されたトラフィックのみに関するものです。
spfSuccessRatio

number

SPF で正常に認証されたメールと、SPF で認証を試みたすべてのメールの比率。なりすましメールは除外されます。
dkimSuccessRatio

number

DKIM で正常に認証されたメールと、DKIM で認証を試みたすべてのメールの比率。なりすましメールは除外されます。
dmarcSuccessRatio

number

DMARC アライメント チェックに合格したメールと、SPF または DKIM のいずれかで正常に認証されたドメインから受信したすべてのメールの割合。
outboundEncryptionRatio

number

セキュアなトランスポート（TLS）で正常に認証されて（Gmail で）送信された送信メール（Gmail から）の割合。
inboundEncryptionRatio

number

セキュアなトランスポート（TLS）で正常に認証されて（Gmail で）受信した受信メール（Gmail へのメール）と、そのドメインから受信したすべてのメールの比率。この指標は、SPF または DKIM に合格したトラフィックのみに関するものです。
deliveryErrors[]

object (DeliveryError)

ドメインの配信エラー。この指標は、SPF または DKIM に合格したトラフィックのみに関するものです。
userReportedSpamRatioLowerBound

number

ユーザーが報告した迷惑メール率の信頼区間の下限。このフィールドが設定されている場合、userReportedSpamRatio の値はこの区間の中間点に設定されるため、不正確になります。ただし、実際の比率は 95% の確率でこの下限と対応する上限の間に収まります。この指標は、DKIM で認証されたメールにのみ関連します。
userReportedSpamRatioUpperBound

number

ユーザーが報告した迷惑メール率の信頼区間の上限。このフィールドが設定されている場合、userReportedSpamRatio の値はこの区間の中間点に設定されるため、不正確になります。ただし、実際の比率は 95% の確率でこの上限と対応する下限の間に収まります。この指標は、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 のヘルプページのダッシュボード セクションにある「ドメインと IP の評価ダッシュボード」をご覧ください。

列挙型
REPUTATION_CATEGORY_UNSPECIFIED 明示的に使用しないでください。評判に関する情報が利用できない状態を表します。
HIGH 迷惑メール率が非常に低いという実績があり、Gmail の送信ガイドラインも遵守している。この送信者からのメールが迷惑メールに分類されることはほとんどありません。
MEDIUM 正常なメールも送信することがわかっているが、少量の迷惑メールを断続的に送信する傾向がある。この送信者からのメールのほとんどがある程度の割合で受信される。ただし、迷惑メールのレベルを大きく引き上げた場合を除く。
LOW 定期的に相当量の迷惑メールを送信していることがわかっており、この送信者からのメールは迷惑メールとして処理されることが多い。
BAD 過去に大量の迷惑メールを送信したことがある。この送信者からのメールのほとんどは SMTP レベルで拒否されるか、迷惑メールとして処理されます。

FeedbackLoop

フィードバック ループ ID 情報。

JSON 表現 
{
  "id": string,
  "spamRatio": number
}
フィールド
id

string

個々のキャンペーンを一意に識別するフィードバック ループ ID。
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 のレピュテーションが非常に低いです。
LOW_DOMAIN_REPUTATION 送信元ドメインのレピュテーションが非常に低いです。
IP_IN_RBL IP が 1 つ以上の公開 Real-time Blackhole List に掲載されています。RBL に連絡して、あなたの IP をリストから外してもらいましょう。
DOMAIN_IN_RBL ドメインが 1 つ以上の公開 Real-time Blackhole List に掲載されています。RBL に連絡して、あなたのドメインをリストから外してもらいましょう。
BAD_PTR_RECORD 送信元の IP に PTR レコードがありません。

メソッド

get

 特定の日付のドメインのトラフィック統計情報を取得する。

list

 利用可能なすべての日付のトラフィック統計情報を一覧表示します。