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)
    }
  ]
}
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 esempio, mymail.miodominio.com) del dominio a cui si riferisce questa statistica sul traffico, mentre la data è la data nel 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. Questa metrica riguarda solo le email autenticate da DKIM.

ipReputations[]

object (IpReputation)

Informazioni sulla reputazione relative agli indirizzi IP dei server email del dominio. Esiste esattamente una voce per ogni categoria di reputazione ad eccezione di REPUTATION_CATEGORY_UNSPECIFIED.

domainReputation

enum (ReputationCategory)

Reputazione del dominio.

spammyFeedbackLoops[]

object (FeedbackLoop)

Identificatori Loop di feedback contenenti spam con i rispettivi tassi di spam individuali. Questa metrica riguarda solo il traffico autenticato da DKIM.

spfSuccessRatio

number

Il rapporto tra i messaggi autenticati correttamente con SPF e tutti i messaggi che hanno tentato di eseguire l'autenticazione con SPF. I messaggi falsificati sono esclusi.

dkimSuccessRatio

number

Il rapporto tra i messaggi autenticati correttamente con DKIM e quelli che hanno tentato di eseguire l'autenticazione con DKIM. I messaggi falsificati sono esclusi.

dmarcSuccessRatio

number

Il rapporto tra la posta che ha superato i controlli di allineamento DMARC e tutta la posta ricevuta dal dominio che ha eseguito correttamente l'autenticazione con SPF o DKIM.

outboundEncryptionRatio

number

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

inboundEncryptionRatio

number

Il rapporto tra la posta in arrivo (a 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 SPF o DKIM.

deliveryErrors[]

object (DeliveryError)

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

IpReputation

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

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 SPF o DKIM.

sampleIps[]

string

Un esempio di IP in questa categoria di reputazione.

ReputationCategory

La reputazione di un dominio o IP. Per ulteriori informazioni, consulta "Dominio & Dashboard Reputazione 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 Ha una buona reputazione in termini di tasso di spam molto basso e rispetta le linee guida per i mittenti di Gmail. Raramente la posta viene contrassegnata dal filtro antispam.
MEDIUM È noto per l'invio di messaggi validi, ma è incline all'invio intermittente di volumi ridotti di spam. La maggior parte delle email provenienti da questa entità avrà un buon tasso di recapito, tranne i casi in cui i livelli di spam saranno aumentati in modo significativo.
LOW È noto che invia regolarmente una considerevole quantità di spam ed è probabile che la posta di questo mittente venga contrassegnata come spam.
BAD In passato abbiamo inviato 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 del loop di feedback.

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

string

Identificatore del ciclo di feedback che identifica in modo univoco le singole campagne.

spamRatio

number

Il rapporto tra i messaggi spam contrassegnati dagli utenti con l'identificatore e il numero totale di messaggi nella posta in arrivo con quell'identificatore.

DeliveryError

Metrica su un particolare tipo di errore di recapito.

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 La consegna del messaggio è stata rifiutata.
TEMPORARY_ERROR Errore temporaneo di consegna 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 invia traffico con una frequenza sospetta e oltre la quale sono stati imposti dei limiti di frequenza temporanei. Il limite verrà rimosso quando Gmail riguarderà la natura del traffico.
SUSPECTED_SPAM Si sospetta che il traffico sia spam da Gmail, per vari motivi.
CONTENT_SPAMMY Si sospetta che il traffico contenga spam, specifico per i contenuti.
BAD_ATTACHMENT Il traffico contiene allegati non supportati da Gmail.
BAD_DMARC_POLICY Il dominio del mittente ha configurato un criterio di rifiuto DMARC.
LOW_IP_REPUTATION La reputazione IP dell'IP di invio è molto bassa.
LOW_DOMAIN_REPUTATION La reputazione del dominio di invio è molto bassa.
IP_IN_RBL L'IP è presente in una o più Real-time Blackhole List. Rivolgiti alla RBL per far rimuovere il tuo IP.
DOMAIN_IN_RBL Il dominio è presente in una o più Real-time Blackhole List. Rivolgiti alla RBL per far rimuovere il tuo dominio.
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.