MetricDefinition

Definisce una metrica specifica da interrogare, inclusi un nome definito dall'utente, il tipo di metrica di base e filtri facoltativi.

Rappresentazione JSON 
{
  "name": string,
  "baseMetric": {
    object (BaseMetric)
  },
  "filter": string
}
Campi
name

string

Obbligatorio. Il nome definito dall'utente per questa metrica. Questo nome verrà utilizzato come chiave per il valore di questa metrica nella risposta.
baseMetric

object (BaseMetric)

Obbligatorio. La metrica sottostante da interrogare.
filter

string

Facoltativo. Filtri facoltativi da applicare alla metrica.

BaseMetric

Specifica la metrica di base da interrogare, che può essere una metrica standard predefinita o una metrica personalizzata definita dall'utente (se supportata in futuro).

Rappresentazione JSON 
{

  "standardMetric": enum (StandardMetric)
}
Campi
Campo unione metric. La metrica specifica da interrogare. metric può essere solo uno dei seguenti tipi:
standardMetric

enum (StandardMetric)

Una metrica standard predefinita.

StandardMetric

Elenca le metriche standard predefinite su cui è possibile eseguire query.

Enum
STANDARD_METRIC_UNSPECIFIED Metrica standard non specificata. Questo valore non deve essere utilizzato direttamente.
FEEDBACK_LOOP_ID

Metrica predefinita per l'ID Feedback Loop (FBL). Il campo filter supporta la selezione del tipo di chiave di aggregazione. Formato supportato: aggregation_key_type = "".

Valori supportati:

  • FROM_HEADER: (impostazione predefinita) la metrica include i messaggi con il dominio dell'intestazione Da: corrispondente al dominio richiesto.
  • ALL_DKIM: la metrica include i messaggi con uno dei domini DKIM firmati corrispondenti al dominio richiesto.
FEEDBACK_LOOP_SPAM_RATE

Metrica predefinita per il tasso di spam di Feedback Loop (FBL). Il campo filter richiede un feedback_loop_id e accetta facoltativamente un aggregation_key_type. I formati supportati sono:

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

Se aggregation_key_type viene omesso, il valore predefinito è FROM_HEADER.

Valori supportati:

  • FROM_HEADER: (impostazione predefinita) la metrica include i messaggi con il dominio dell'intestazione Da: corrispondente al dominio richiesto.
  • ALL_DKIM: la metrica include i messaggi con uno dei domini DKIM firmati che corrisponde al dominio richiesto.
SPAM_RATE Metrica predefinita per il tasso di spam.
AUTH_SUCCESS_RATE Il tasso di successo dei meccanismi di autenticazione (DKIM, SPF, DMARC). Il filtro deve essere di tipo auth_type = "", dove è uno dei seguenti valori: [spf, dkim, dmarc]
TLS_ENCRYPTION_MESSAGE_COUNT Il filtro del tasso di messaggi con crittografia TLS in transito deve essere di tipo traffic_direction = "", dove è uno dei seguenti valori: [inbound, outbound]
TLS_ENCRYPTION_RATE Il filtro del tasso di messaggi con crittografia TLS in transito deve essere di tipo traffic_direction = "", dove è uno dei seguenti valori: [inbound, outbound]
DELIVERY_ERROR_COUNT

Il conteggio totale degli errori di recapito riscontrati (rifiuti temporanei o permanenti). Il campo filter supporta una sintassi limitata. I formati supportati sono:

  • Vuoto: non viene applicato alcun filtro.
  • error_type = ""
  • error_type = "" AND error_reason = ""

Se viene fornito un filtro vuoto, la metrica verrà aggregata in base a tutti i tipi e motivi di errore. Se è specificato solo error_type, la metrica verrà aggregata in base a tutti i motivi per quel tipo.

Valori supportati:

  • rifiuta
  • temp_fail

I valori supportati dipendono da :

  • Per "reject": [bad_attachment, bad_or_missing_ptr_record, ip_in_rbls, low_domain_reputation, low_ip_reputation, spammy_content, stamp_policy_error, other]
  • Per "temp_fail": [anomalous_traffic_pattern, other]
DELIVERY_ERROR_RATE

Tasso errori di recapito per il tipo di errore di recapito specificato. Il campo filter supporta una sintassi limitata. I formati supportati sono:

  • Vuoto: non viene applicato alcun filtro.
  • error_type = ""
  • error_type = "" AND error_reason = ""

Se viene fornito un filtro vuoto, la metrica verrà aggregata in base a tutti i tipi e motivi di errore. Se è specificato solo error_type, la metrica verrà aggregata in base a tutti i motivi per quel tipo.

Valori supportati:

  • rifiuta
  • temp_fail

I valori supportati dipendono da :

  • Per "reject": [bad_attachment, bad_or_missing_ptr_record, ip_in_rbls, low_domain_reputation, low_ip_reputation, spammy_content, stamp_policy_error, other]
  • Per "temp_fail": [anomalous_traffic_pattern, other]