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）で、date は統計情報が対応する日付（yyyymmdd 形式）です。例: domain/mymail.mydomain.com/trafficStats/20160807
userReportedSpamRatio

number

ユーザーが迷惑メールとして報告した件数と、受信トレイに送信されたメールの割合（%）です。この指標は、DKIM で認証されたメールにのみ関係します。
ipReputations[]

object (IpReputation)

ドメインのメールサーバーの IP アドレスに関するレピュテーション情報。評価カテゴリごとに 1 つのエントリ（REPUTATION_CATEGORY_UNSPECIFIED を除く）があります。
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 からの）送信メールの割合。
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 のレピュテーション。詳細は「ドメインとIP レピュテーション ダッシュボード」Postmaster Tools ヘルプページの [ダッシュボード] セクションにあります。

列挙型
REPUTATION_CATEGORY_UNSPECIFIED 明示的に使用すべきでないデフォルト値。これは、レピュテーション情報が利用できない状態を表します。
HIGH 迷惑メール率が非常に低いという実績があり、Gmail の送信ガイドラインも遵守しています。メールが迷惑メールフィルタでマークされることはほとんどありません。
MEDIUM 良質なメールを送ることはわかっているが、少量の迷惑メールが断続的に送信される傾向がある。この組織からのほとんどのメールは、迷惑メールのレベルが著しく増加した場合を除き、かなりの割合で配信されます。
LOW 大量の迷惑メールが定期的に送信されることがわかっており、この送信者からのメールは迷惑メールに分類される可能性があります。
BAD 膨大な量の迷惑メールを送信してきた履歴このエンティティから送信されたメールは、ほとんどの場合 SMTP レベルで拒否されるか、迷惑メールに分類されます。

FeedbackLoop

フィードバック ループの識別子情報。

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

string

個々のキャンペーンを一意に識別するフィードバック ループ ID。
spamRatio

number

ユーザーが ID で迷惑メールとマークしたメールと、その ID で受信トレイに入ったメールの総数の割合。

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 つ以上の公開の Real-time Blackhole List に記載されています。RBL に連絡して IP を除外する。
DOMAIN_IN_RBL このドメインは、1 つまたは複数の公開されているリアルタイム・ブラックホール・リスト（Real-time Blackhole List）に掲載されています。RBL に連絡してドメインを除外してもらう。
BAD_PTR_RECORD 送信元 IP に PTR レコードがありません。

メソッド

get

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

list

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