REST Resource: domains.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

היחס בין הודעות אימייל שעברו את בדיקות ההתאמה של DMARC לבין כל הודעות האימייל שהתקבלו מהדומיין שאומתו בהצלחה באמצעות SPF או DKIM.
outboundEncryptionRatio

number

היחס בין הודעות אימייל יוצאות (מ-Gmail) שהתקבלו בהעברה מאובטחת (TLS).
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.

טיפוסים בני מנייה (enum)
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

סיווג השגיאה.

טיפוסים בני מנייה (enum)
DELIVERY_ERROR_CLASS_UNSPECIFIED ערך ברירת המחדל שבו אין להשתמש באופן מפורש.
PERMANENT_ERROR מסירת ההודעה נדחתה.
TEMPORARY_ERROR שגיאה זמנית במסירת ההודעה לנמען.

DeliveryErrorType

סוג שגיאת המסירה.

טיפוסים בני מנייה (enum)
DELIVERY_ERROR_TYPE_UNSPECIFIED ערך ברירת המחדל שבו אין להשתמש באופן מפורש.
RATE_LIMIT_EXCEEDED הדומיין או כתובת ה-IP שולחים תנועה בקצב גבוה בצורה חשודה, ולכן הוחלו מגבלות זמניות על קצב יצירת הבקשות. המגבלה תוסר כש-Gmail יהיה בטוח מספיק לגבי אופי התנועה.
SUSPECTED_SPAM קיים חשד שהתנועה היא ספאם בגלל סיבות שונות.
CONTENT_SPAMMY קיים חשד שהתנועה היא ספאמית, ספציפית לתוכן.
BAD_ATTACHMENT התנועה מכילה קבצים מצורפים שאינם נתמכים על ידי Gmail.
BAD_DMARC_POLICY הדומיין של השולח הגדיר מדיניות דחייה של DMARC.
LOW_IP_REPUTATION המוניטין של כתובת ה-IP של השולח נמוך מאוד.
LOW_DOMAIN_REPUTATION המוניטין של הדומיין השולח נמוך מאוד.
IP_IN_RBL כתובת ה-IP רשומה ברשימת Real-time Blackhole List ציבורית אחת או יותר. יש לפנות ל-RBL כדי להסיר את כתובת ה-IP שלכם מהרשימה.
DOMAIN_IN_RBL הדומיין מופיע ברשימת Real-time Blackhole List ציבורית אחת או יותר. יש לפנות ל-RBL כדי להסיר את הדומיין שלכם מהרשימה.
BAD_PTR_RECORD לכתובת ה-IP שממנה נשלח האימייל חסרה רשומת PTR.

שיטות

get

 קבלת נתונים סטטיסטיים על תנועת הגולשים מדומיין מסוים בתאריך ספציפי.

list

 הצגת רשימה של נתונים סטטיסטיים של תנועה לכל הימים הזמינים.