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

טיפוסים בני מנייה (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 מערכת Gmail חושדת שהתנועה היא ספאם בגלל סיבות שונות.
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.

Methods

get

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

list

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