MetricDefinition

یک معیار خاص برای پرس‌وجو تعریف می‌کند، شامل نام تعریف‌شده توسط کاربر، نوع معیار پایه و فیلترهای اختیاری.

نمایش JSON 
{
  "name": string,
  "baseMetric": {
    object (BaseMetric)
  },
  "filter": string
}
فیلدها
name

string

الزامی. نام تعریف‌شده توسط کاربر برای این معیار. این نام به عنوان کلید مقدار این معیار در پاسخ استفاده خواهد شد.

baseMetric

object ( BaseMetric )

الزامی. معیار اصلی برای پرس‌وجو.

filter

string

اختیاری. فیلترهای اختیاری برای اعمال روی معیار.

بیس‌متریک

معیار پایه برای پرس‌وجو را مشخص می‌کند که می‌تواند یک معیار استاندارد از پیش تعریف‌شده یا یک معیار سفارشی تعریف‌شده توسط کاربر (در صورت پشتیبانی در آینده) باشد.

نمایش JSON 
{

  "standardMetric": enum (StandardMetric)
}
فیلدها
metric فیلد اتحادیه. معیار خاص برای پرس و جو. metric می‌تواند فقط یکی از موارد زیر باشد:
standardMetric

enum ( StandardMetric )

یک معیار استاندارد از پیش تعریف شده.

استانداردمتریک

معیارهای استاندارد از پیش تعریف شده‌ای را که می‌توان در مورد آنها پرس و جو کرد، فهرست می‌کند.

انوم‌ها
STANDARD_METRIC_UNSPECIFIED معیار استاندارد نامشخص. این مقدار نباید مستقیماً استفاده شود.
FEEDBACK_LOOP_ID

معیار از پیش تعریف شده برای شناسه حلقه بازخورد (FBL). فیلد filter از انتخاب نوع کلید تجمیع پشتیبانی می‌کند. قالب پشتیبانی شده: aggregation_key_type = " «. (یا: "باورم نمی‌شود که آدم‌ها اشتباه می‌کنند.")

پشتیبانی شده ارزش‌ها:

  • FROM_HEADER : (پیش‌فرض) این معیار شامل پیام‌هایی با دامنه سرآیند From: مطابق با دامنه درخواستی است.
  • ALL_DKIM : این معیار شامل پیام‌هایی است که یکی از دامنه‌های DKIM امضا شده آنها با دامنه درخواستی مطابقت دارد.
FEEDBACK_LOOP_SPAM_RATE

معیار از پیش تعریف شده برای نرخ هرزنامه حلقه بازخورد (FBL). فیلد filter به یک feedback_loop_id نیاز دارد و به صورت اختیاری aggregation_key_type را می‌پذیرد. فرمت‌های پشتیبانی شده عبارتند از:

  • feedback_loop_id = " «
  • feedback_loop_id = " "و aggregation_key_type =" «

اگر aggregation_key_type حذف شود، به طور پیش‌فرض روی FROM_HEADER قرار می‌گیرد.

پشتیبانی شده ارزش‌ها:

  • FROM_HEADER : (پیش‌فرض) این معیار شامل پیام‌هایی با دامنه سرآیند From: مطابق با دامنه درخواستی است.
  • ALL_DKIM : این معیار شامل پیام‌هایی است که یکی از دامنه‌های DKIM امضا شده آنها با دامنه درخواستی مطابقت دارد.
SPAM_RATE معیار از پیش تعریف شده برای نرخ هرزنامه.
AUTH_SUCCESS_RATE میزان موفقیت مکانیسم‌های احراز هویت (DKIM، SPF، DMARC). فیلتر باید از نوع auth_type =" باشد. «کجا» یکی از موارد زیر است: [spf، dkim، dmarc]
TLS_ENCRYPTION_MESSAGE_COUNT نرخ پیام‌هایی که در حین انتقال با TLS رمزگذاری شده‌اند، فیلتر باید از نوع traffic_direction =" باشد. «کجا» یکی از موارد زیر است: [ورودی، خروجی]
TLS_ENCRYPTION_RATE نرخ پیام‌هایی که در حین انتقال با TLS رمزگذاری شده‌اند، فیلتر باید از نوع traffic_direction =" باشد. «کجا» یکی از موارد زیر است: [ورودی، خروجی]
DELIVERY_ERROR_COUNT

تعداد کل خطاهای تحویل رخ داده (رد شدن موقت یا دائمی). فیلد filter از سینتکس محدودی پشتیبانی می‌کند. فرمت‌های پشتیبانی شده عبارتند از:

  • خالی: هیچ فیلتری اعمال نشده است.
  • error_type = " «
  • error_type = " "و 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 = " "و 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]