REST Resource: domains.trafficStats

Risorsa: TrafficStats

Statistiche sul traffico email relative a una data specifica.

Rappresentazione 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
}
Campi
name

string

Il nome della risorsa delle statistiche sul traffico. I nomi delle statistiche sul traffico hanno il formato domains/{domain}/trafficStats/{date}, dove nome_dominio è il nome di dominio completo (ad es. mymail.mydomain.com) del dominio a cui si riferiscono queste statistiche sul traffico e data è la data in formato aaaammgg a cui corrispondono queste statistiche. Ad esempio: domains/mymail.mydomain.com/trafficStats/20160807
userReportedSpamRatio

number

Il rapporto tra lo spam segnalato dagli utenti e le email inviate alla Posta in arrivo. Questo valore è potenzialmente impreciso. Gli utenti possono fare riferimento alla descrizione dei campi intervallo userReportedSpamRatioLowerBound e userReportedSpamRatioUpperBound per garanzie di accuratezza più esplicite. Questa metrica riguarda solo le email autenticate tramite DKIM.
ipReputations[]

object (IpReputation)

Informazioni sulla reputazione relative agli indirizzi IP dei server di posta per il dominio. Esiste una sola voce per ogni categoria di reputazione, ad eccezione di REPUTATION_CATEGORY_UNSPECIFIED.
domainReputation

enum (ReputationCategory)

La reputazione del dominio.
spammyFeedbackLoops[]

object (FeedbackLoop)

Identificatori Feedback Loop con spam con i relativi tassi di spam. Questa metrica riguarda solo il traffico autenticato tramite DKIM.
spfSuccessRatio

number

Il rapporto tra la posta autenticata correttamente con SPF e tutta la posta che ha tentato di autenticarsi con SPF. La posta con spoofing è esclusa.
dkimSuccessRatio

number

Il rapporto tra la posta autenticata correttamente con DKIM e tutta la posta che ha tentato di autenticarsi con DKIM. La posta con spoofing è esclusa.
dmarcSuccessRatio

number

Il rapporto tra la posta che ha superato i controlli di allineamento DMARC e tutta la posta ricevuta dal dominio che è stata autenticata correttamente con SPF o DKIM.
outboundEncryptionRatio

number

Il rapporto tra la posta in uscita (da Gmail) accettata tramite trasporto sicuro (TLS).
inboundEncryptionRatio

number

Il rapporto tra la posta in arrivo (verso Gmail) che ha superato il trasporto sicuro (TLS) e tutta la posta ricevuta da quel dominio. Questa metrica riguarda solo il traffico che ha superato i controlli SPF o DKIM.
deliveryErrors[]

object (DeliveryError)

Errori di recapito per il dominio. Questa metrica riguarda solo il traffico che ha superato i controlli SPF o DKIM.
userReportedSpamRatioLowerBound

number

Il limite inferiore dell'intervallo di confidenza per il rapporto di spam segnalato dagli utenti. Se questo campo è impostato, il valore di userReportedSpamRatio viene impostato sul punto medio di questo intervallo ed è quindi approssimativo. Tuttavia, il rapporto reale è garantito per essere compreso tra questo limite inferiore e il limite superiore corrispondente il 95% delle volte. Questa metrica riguarda solo le email autenticate tramite DKIM.
userReportedSpamRatioUpperBound

number

Il limite superiore dell'intervallo di confidenza per il rapporto di spam segnalato dagli utenti. Se questo campo è impostato, il valore di userReportedSpamRatio viene impostato sul punto medio di questo intervallo ed è quindi approssimativo. Tuttavia, il rapporto reale è garantito per essere compreso tra questo limite superiore e il limite inferiore corrispondente il 95% delle volte. Questa metrica riguarda solo le email autenticate tramite DKIM.

IpReputation

Informazioni sulla reputazione IP per un insieme di IP in una categoria di reputazione specifica.

Rappresentazione JSON 
{
  "reputation": enum (ReputationCategory),
  "ipCount": string,
  "sampleIps": [
    string
  ]
}
Campi
reputation

enum (ReputationCategory)

La categoria di reputazione rappresentata da questa reputazione IP.
ipCount

string (int64 format)

Numero totale di IP univoci in questa categoria di reputazione. Questa metrica riguarda solo il traffico che ha superato i controlli SPF o DKIM.
sampleIps[]

string

Un esempio di IP in questa categoria di reputazione.

ReputationCategory

La reputazione di un dominio o di un IP. Per ulteriori informazioni, consulta "Dashboard per la reputazione del dominio e dell'IP" nella sezione Dashboard della pagina di assistenza di Postmaster Tools.

Enum
REPUTATION_CATEGORY_UNSPECIFIED Il valore predefinito che non deve mai essere utilizzato esplicitamente. Rappresenta lo stato in cui non sono disponibili informazioni sulla reputazione.
HIGH In passato è stato rilevato un tasso di spam molto basso e la posta è conforme alle linee guida per i mittenti di Gmail. Il filtro antispam raramente contrassegna la posta come spam.
MEDIUM La posta è generalmente "buona", ma saltuariamente potrebbero essere state rilevate piccole quantità di spam. La maggior parte delle email provenienti da questa entità ha un buon tasso di recapitabilità, eccetto i casi in cui i livelli di spam subiscono un aumento significativo.
LOW In passato sono state rilevate abitualmente quantità considerevoli di spam ed è probabile che la posta di questo mittente venga contrassegnata come spam.
BAD Cronologia di invio di enormi quantità di spam. La posta proveniente da questa entità verrà quasi sempre rifiutata a livello di SMTP o contrassegnata come spam.

FeedbackLoop

Informazioni sull'identificatore Feedback Loop.

Rappresentazione JSON 
{
  "id": string,
  "spamRatio": number
}
Campi
id

string

Identificatore del feedback loop che identifica in modo univoco le singole campagne.
spamRatio

number

Il rapporto tra i messaggi contrassegnati come spam dall'utente con l'identificatore e il numero totale di messaggi nella Posta in arrivo con lo stesso identificatore.

DeliveryError

Metrica relativa a un determinato tipo di errore di importazione.

Rappresentazione JSON 
{
  "errorClass": enum (DeliveryErrorClass),
  "errorType": enum (DeliveryErrorType),
  "errorRatio": number
}
Campi
errorClass

enum (DeliveryErrorClass)

La classe dell'errore di recapito.
errorType

enum (DeliveryErrorType)

Il tipo di errore di recapito.
errorRatio

number

Il rapporto tra i messaggi in cui si è verificato l'errore e tutto il traffico autenticato.

DeliveryErrorClass

La classe dell'errore di recapito.

Enum
DELIVERY_ERROR_CLASS_UNSPECIFIED Il valore predefinito che non deve mai essere utilizzato esplicitamente.
PERMANENT_ERROR Il recapito del messaggio è stato rifiutato.
TEMPORARY_ERROR Mancata consegna temporanea del messaggio al destinatario.

DeliveryErrorType

Il tipo di errore di recapito.

Enum
DELIVERY_ERROR_TYPE_UNSPECIFIED Il valore predefinito che non deve mai essere utilizzato esplicitamente.
RATE_LIMIT_EXCEEDED Il dominio o l'IP inviano traffico con un'alta frequenza che desta sospetti, e perciò sono stati imposti dei limiti di frequenza temporanei. Il limite verrà rimosso una volta che Gmail avrà confermato la natura del traffico.
SUSPECTED_SPAM Gmail sospetta che il traffico sia spam per vari motivi.
CONTENT_SPAMMY Si sospetta che il traffico abbia contenuti di spam.
BAD_ATTACHMENT Il traffico contiene allegati non supportati da Gmail.
BAD_DMARC_POLICY Il dominio mittente ha impostato un criterio DMARC di rifiuto.
LOW_IP_REPUTATION La reputazione dell'IP di invio è molto scarsa.
LOW_DOMAIN_REPUTATION La reputazione del dominio di invio è molto bassa.
IP_IN_RBL L'IP è presente in uno o più Real-time Blackhole List pubblici. Rimuovi il tuo IP dalla RBL.
DOMAIN_IN_RBL Il dominio è presente in una o più Real-time Blackhole List. Rimuovi il tuo dominio dalla RBL.
BAD_PTR_RECORD Nell'IP di invio manca un record PTR.

Metodi

get

 Visualizza le statistiche sul traffico per un dominio in una data specifica.

list

 Elenca le statistiche sul traffico per tutti i giorni disponibili.