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)

डोमेन के ईमेल सर्वर के आईपी पतों से जुड़ी, प्रतिष्ठा की जानकारी. 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

सुरक्षित ट्रांसपोर्ट (TLS) पर स्वीकार किए गए आउटगोइंग ईमेल (Gmail से) का अनुपात.
inboundEncryptionRatio

number

सुरक्षित ट्रांसपोर्ट (TLS) की मदद से आने वाले ईमेल (Gmail में) और उस डोमेन से मिलने वाले सभी ईमेल का अनुपात. यह मेट्रिक सिर्फ़ उस ट्रैफ़िक से जुड़ी होती है जो SPF या DKIM की जांच को पास कर लेता है.
deliveryErrors[]

object (DeliveryError)

डोमेन के लिए डिलीवरी से जुड़ी गड़बड़ियां. यह मेट्रिक सिर्फ़ उस ट्रैफ़िक से जुड़ी होती है जो SPF या DKIM की जांच को पास कर लेता है.
userReportedSpamRatioLowerBound

number

उपयोगकर्ता की ओर से स्पैम के तौर पर रिपोर्ट किए गए ईमेल के अनुपात के लिए, कॉन्फ़िडेंस इंटरवल की निचली सीमा. अगर यह फ़ील्ड सेट है, तो userReportedSpamRatio की वैल्यू इस इंटरवल के बीच में सेट होती है. इसलिए, यह सटीक नहीं होती. हालांकि, 95% समय तक यह पक्का होता है कि सही अनुपात, इस निचली सीमा और उससे जुड़ी ऊपरी सीमा के बीच होगा. यह मेट्रिक सिर्फ़ उन ईमेल के लिए है जिनकी पुष्टि DKIM से की गई है.
userReportedSpamRatioUpperBound

number

उपयोगकर्ता की ओर से रिपोर्ट किए गए स्पैम रेशियो के लिए, कॉन्फ़िडेंस इंटरवल का ऊपरी बाउंड. अगर यह फ़ील्ड सेट है, तो userReportedSpamRatio की वैल्यू इस इंटरवल के बीच में सेट होती है. इसलिए, यह सटीक नहीं होती. हालांकि, 95% समय तक यह पक्का होता है कि सही अनुपात, ऊपरी सीमा और उससे जुड़ी निचली सीमा के बीच होगा. यह मेट्रिक सिर्फ़ उन ईमेल के लिए है जिनकी पुष्टि DKIM से की गई है.

IpReputation

किसी खास कैटगरी में मौजूद आईपी के सेट के लिए, आईपी की साख की जानकारी.

JSON के काेड में दिखाना 
{
  "reputation": enum (ReputationCategory),
  "ipCount": string,
  "sampleIps": [
    string
  ]
}
फ़ील्ड
reputation

enum (ReputationCategory)

यह आईपी रेप्युटेशन, रेप्युटेशन कैटगरी को दिखाता है.
ipCount

string (int64 format)

इस कैटगरी में मौजूद यूनीक आईपी की कुल संख्या. यह मेट्रिक सिर्फ़ उस ट्रैफ़िक से जुड़ी होती है जो SPF या DKIM की जांच को पास कर लेता है.
sampleIps[]

string

इस कैटगरी में शामिल आईपी का सैंपल.

ReputationCategory

डोमेन या आईपी की छवि. ज़्यादा जानकारी के लिए, Postmaster Tools के सहायता पेज पर मौजूद डैशबोर्ड सेक्शन में, "डोमेन और आईपी की प्रतिष्ठा के डैशबोर्ड" देखें.

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 डोमेन या आईपी, संदिग्ध तरीके से सामान्य के मुकाबले ज़्यादा दर से ट्रैफ़िक भेज रहा है. इसकी वजह से दर की सीमा लागू की गई है. Gmail को ट्रैफ़िक के बारे में भरोसा हो जाने पर, सीमा हटा ली जाएगी.
SUSPECTED_SPAM Gmail को लगता है कि ट्रैफ़िक कई वजहों से स्पैम है.
CONTENT_SPAMMY किसी खास तरह के कॉन्टेंट वाले ट्रैफ़िक को स्पैम समझा जा सकता है.
BAD_ATTACHMENT ट्रैफ़िक में ऐसा अटैचमेंट है जो Gmail के साथ काम नहीं करता.
BAD_DMARC_POLICY ईमेल भेजने वाले डोमेन ने DMARC की अस्वीकार करने की नीति सेट अप की है.
LOW_IP_REPUTATION ईमेल भेजने वाले आईपी की आईपी प्रतिष्ठा बहुत खराब है.
LOW_DOMAIN_REPUTATION ईमेल भेजने वाले डोमेन की डोमेन प्रतिष्ठा बहुत खराब है.
IP_IN_RBL आईपी, एक या एक से ज़्यादा सार्वजनिक रीयल-टाइम ब्लैकहोल सूचियों में मौजूद है. अपने आईपी को सूची से हटाने के लिए, RBL को ठीक करें.
DOMAIN_IN_RBL डोमेन, एक या एक से ज़्यादा सार्वजनिक रीयल-टाइम ब्लैकहोल सूचियों में शामिल है. अपने डोमेन को सूची से हटाने के लिए, RBL को ठीक करें.
BAD_PTR_RECORD ईमेल भेजने वाले आईपी में पीटीआर रिकॉर्ड मौजूद नहीं है.

तरीके

get

 किसी खास तारीख को किसी डोमेन के लिए ट्रैफ़िक के आंकड़े पाएं.

list

 उपलब्ध सभी दिनों के लिए ट्रैफ़िक के आंकड़े दिखाएं.