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

היחס בין הודעות אימייל שעברו בדיקות התאמה של 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 ודומיינים' בקטע 'מרכזי בקרה' בדף העזרה של 'כלים לניהול אימייל'.

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

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

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

DeliveryErrorType

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

טיפוסים בני מנייה (enums)
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 רשומה ברשימת Real-time Blackhort ציבורית אחת או יותר. יש לפנות ל-RBL כדי להסיר את כתובת ה-IP שלך מהרשימה.
DOMAIN_IN_RBL הדומיין רשום ברשימת Real-time Blackhor אחת או יותר. יש לפנות ל-RBL כדי להסיר את הדומיין שלך מהרשימה.
BAD_PTR_RECORD בכתובת ה-IP שממנה נשלח האימייל חסרה רשומת PTR.

שיטות

get

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

list

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