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 アドレスに関する評価情報。評価カテゴリごとにエントリは 1 つだけです（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

送信メール（Gmail から）がセキュアなトランスポート（TLS）を介して承認された割合。
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 ヘルプページの [ダッシュボード] セクションの [ドメインと 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 が 1 つ以上の公開されているリアルタイム ブラックホール リストに掲載されている。RBL に連絡して IP の除外を依頼します。
DOMAIN_IN_RBL ドメインが 1 つ以上の公開されているリアルタイム ブラックホール リストに掲載されている。RBL に連絡して、ドメインを除外してもらう。
BAD_PTR_RECORD 送信元 IP に PTR レコードがない。

Methods

get

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

list

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