MetricDefinition

क्वेरी के लिए कोई खास मेट्रिक तय करता है. इसमें उपयोगकर्ता की ओर से तय किया गया नाम, बेस मेट्रिक का टाइप, और वैकल्पिक फ़िल्टर शामिल होते हैं.

JSON काेड में दिखाना 
{
  "name": string,
  "baseMetric": {
    object (BaseMetric)
  },
  "filter": string
}
फ़ील्ड
name

string

ज़रूरी है. यह मेट्रिक के लिए, उपयोगकर्ता की ओर से तय किया गया नाम है. इस नाम का इस्तेमाल, जवाब में इस मेट्रिक की वैल्यू के लिए कुंजी के तौर पर किया जाएगा.
baseMetric

object (BaseMetric)

ज़रूरी है. क्वेरी के लिए, मुख्य मेट्रिक.
filter

string

ज़रूरी नहीं. मेट्रिक पर लागू करने के लिए वैकल्पिक फ़िल्टर.

BaseMetric

क्वेरी के लिए बेस मेट्रिक तय करता है. यह पहले से तय की गई स्टैंडर्ड मेट्रिक या उपयोगकर्ता की ओर से तय की गई कस्टम मेट्रिक हो सकती है. हालांकि, यह सुविधा आने वाले समय में उपलब्ध हो सकती है.

JSON काेड में दिखाना 
{

  "standardMetric": enum (StandardMetric)
}
फ़ील्ड
यूनियन फ़ील्ड metric. क्वेरी के लिए खास मेट्रिक. metric इनमें से कोई एक हो सकती है:
standardMetric

enum (StandardMetric)

पहले से तय की गई स्टैंडर्ड मेट्रिक.

StandardMetric

पहले से तय की गई उन स्टैंडर्ड मेट्रिक की सूची दिखाता है जिनके लिए क्वेरी की जा सकती है.

Enums
STANDARD_METRIC_UNSPECIFIED तय नहीं की गई स्टैंडर्ड मेट्रिक. इस वैल्यू का सीधे तौर पर इस्तेमाल नहीं किया जाना चाहिए.
FEEDBACK_LOOP_ID

फ़ीडबैक लूप (एफ़बीएल) आईडी के लिए, पहले से तय की गई मेट्रिक. filter फ़ील्ड, एग्रीगेशन कुंजी का टाइप चुनने की सुविधा देता है. इस्तेमाल किया जा सकने वाला फ़ॉर्मैट: aggregation_key_type = "".

इस्तेमाल की जा सकने वाली वैल्यू:

  • FROM_HEADER: (डिफ़ॉल्ट) इस मेट्रिक में, From: हेडर डोमेन वाले ऐसे मैसेज शामिल होते हैं जो अनुरोध किए गए डोमेन से मेल खाते हैं.
  • ALL_DKIM: इस मेट्रिक में, डीकेआईएम से हस्ताक्षर किए गए उन डोमेन वाले मैसेज शामिल होते हैं जो अनुरोध किए गए डोमेन से मेल खाते हैं.
FEEDBACK_LOOP_SPAM_RATE

फ़ीडबैक लूप (एफ़बीएल) की स्पैम रेट के लिए, पहले से तय की गई मेट्रिक. filter फ़ील्ड के लिए, feedback_loop_id ज़रूरी है. हालांकि, इसमें aggregation_key_type को शामिल करना ज़रूरी नहीं है. इस्तेमाल किए जा सकने वाले फ़ॉर्मैट ये हैं:

  • feedback_loop_id = ""
  • feedback_loop_id = "" AND aggregation_key_type = ""

अगर aggregation_key_type को शामिल नहीं किया जाता है, तो डिफ़ॉल्ट तौर पर FROM_HEADER का इस्तेमाल किया जाता है.

इस्तेमाल की जा सकने वाली वैल्यू:

  • FROM_HEADER: (डिफ़ॉल्ट) इस मेट्रिक में, From: हेडर डोमेन वाले ऐसे मैसेज शामिल होते हैं जो अनुरोध किए गए डोमेन से मेल खाते हैं.
  • ALL_DKIM: इस मेट्रिक में, डीकेआईएम से हस्ताक्षर किए गए उन डोमेन वाले मैसेज शामिल होते हैं जो अनुरोध किए गए डोमेन से मेल खाते हैं.
SPAM_RATE स्पैम रेट के लिए, पहले से तय की गई मेट्रिक.
AUTH_SUCCESS_RATE पुष्टि करने के तरीकों (डीकेआईएम, एसपीएफ़, डीमार्क) की सफलता दर. फ़िल्टर का टाइप auth_type = "" होना चाहिए. इसमें इनमें से कोई एक हो सकता है: [spf, dkim, dmarc]
TLS_ENCRYPTION_MESSAGE_COUNT ट्रांज़िट में टीएलएस एन्क्रिप्ट किए गए मैसेज की दर. फ़िल्टर का टाइप traffic_direction = "" होना चाहिए. इसमें इनमें से कोई एक हो सकता है: [inbound, outbound]
TLS_ENCRYPTION_RATE ट्रांज़िट में टीएलएस एन्क्रिप्ट किए गए मैसेज की दर. फ़िल्टर का टाइप traffic_direction = "" होना चाहिए. इसमें इनमें से कोई एक हो सकता है: [inbound, outbound]
DELIVERY_ERROR_COUNT

डिलीवरी में हुई गड़बड़ियों की कुल संख्या. इसमें, अस्थायी या स्थायी तौर पर अस्वीकार किए गए मैसेज शामिल हैं. filter फ़ील्ड में, सीमित सिंटैक्स का इस्तेमाल किया जा सकता है. इस्तेमाल किए जा सकने वाले फ़ॉर्मैट ये हैं:

  • खाली: कोई फ़िल्टर लागू नहीं किया गया है.
  • error_type = ""
  • error_type = "" AND error_reason = ""

अगर कोई खाली फ़िल्टर दिया जाता है, तो मेट्रिक को गड़बड़ी के सभी टाइप और वजहों के हिसाब से एग्रीगेट किया जाएगा. अगर सिर्फ़ error_type तय किया जाता है, तो मेट्रिक को उस टाइप की सभी वजहों के हिसाब से एग्रीगेट किया जाएगा.

इस्तेमाल की जा सकने वाली वैल्यू:

  • अस्वीकार करें
  • temp_fail

इस्तेमाल की जा सकने वाली वैल्यू, पर निर्भर करती है:

  • 'अस्वीकार करें' के लिए: [bad_attachment, bad_or_missing_ptr_record, ip_in_rbls, low_domain_reputation, low_ip_reputation, spammy_content, stamp_policy_error, other]
  • 'temp_fail' के लिए: [anomalous_traffic_pattern, other]
DELIVERY_ERROR_RATE

डिलीवरी में हुई गड़बड़ी के तय किए गए टाइप के लिए, डिलीवरी में हुई गड़बड़ी की दर. filter फ़ील्ड में, सीमित सिंटैक्स का इस्तेमाल किया जा सकता है. इस्तेमाल किए जा सकने वाले फ़ॉर्मैट ये हैं:

  • खाली: कोई फ़िल्टर लागू नहीं किया गया है.
  • error_type = ""
  • error_type = "" AND error_reason = ""

अगर कोई खाली फ़िल्टर दिया जाता है, तो मेट्रिक को गड़बड़ी के सभी टाइप और वजहों के हिसाब से एग्रीगेट किया जाएगा. अगर सिर्फ़ error_type तय किया जाता है, तो मेट्रिक को उस टाइप की सभी वजहों के हिसाब से एग्रीगेट किया जाएगा.

इस्तेमाल की जा सकने वाली वैल्यू:

  • अस्वीकार करें
  • temp_fail

इस्तेमाल की जा सकने वाली वैल्यू, पर निर्भर करती है:

  • 'अस्वीकार करें' के लिए: [bad_attachment, bad_or_missing_ptr_record, ip_in_rbls, low_domain_reputation, low_ip_reputation, spammy_content, stamp_policy_error, other]
  • 'temp_fail' के लिए: [anomalous_traffic_pattern, other]