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

تعداد للمقاييس المعيارية المحدّدة مسبقًا التي يمكن الاستعلام عنها.

عمليات التعداد
STANDARD_METRIC_UNSPECIFIED مقياس معياري غير محدّد يجب عدم استخدام هذه القيمة مباشرةً.
FEEDBACK_LOOP_ID

مقياس محدّد مسبقًا لمعرّف "تقرير الملاحظات والآراء" يتيح حقل filter اختيار نوع مفتاح التجميع. التنسيق المتاح: aggregation_key_type = "".

القيم المتاحة :

  • FROM_HEADER: (تلقائي) يشمل المقياس الرسائل التي يتطابق نطاق عنوان "من:" فيها مع النطاق المطلوب.
  • ALL_DKIM: يشمل المقياس الرسائل التي يتطابق أحد نطاقات 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: (تلقائي) يشمل المقياس الرسائل التي يتطابق نطاق عنوان "من:" فيها مع النطاق المطلوب.
  • ALL_DKIM: يشمل المقياس الرسائل التي يتطابق أحد نطاقات DKIM الموقَّعة فيها مع النطاق المطلوب.
SPAM_RATE مقياس محدّد مسبقًا لمعدّل الرسائل غير المرغوب فيها
AUTH_SUCCESS_RATE معدّل نجاح آليات المصادقة (DKIM وSPF وDMARC) يجب أن يكون نوع الفلتر 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]
  • بالنسبة إلى "فشل مؤقت": [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]
  • بالنسبة إلى "فشل مؤقت": [anomalous_traffic_pattern, other]