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 fa riferimento le statistiche sul traffico e 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 spam segnalato dagli utenti e 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 per il dominio. Esiste una sola voce per ogni categoria di reputazione tranne REPUTATION_CATEGORY_UNSPECIFIED.

domainReputation

enum (ReputationCategory)

Reputazione del dominio.

spammyFeedbackLoops[]

object (FeedbackLoop)

Identificatori del loop di feedback contenenti spam, con i relativi tassi di spam individuali. Questa metrica riguarda solo il traffico autenticato da DKIM.

spfSuccessRatio

number

Il rapporto tra la posta che ha eseguito l'autenticazione con SPF e tutta la posta che ha tentato di eseguire l'autenticazione con SPF. La posta oggetto di spoofing è esclusa.

dkimSuccessRatio

number

Il rapporto tra la posta autenticata correttamente con DKIM rispetto a tutta la posta che ha tentato di autenticare con DKIM. La posta oggetto di 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

La percentuale di posta in uscita (da Gmail) che è stata accettata tramite il trasporto sicuro (TLS).

inboundEncryptionRatio

number

Il rapporto tra la posta in arrivo (e Gmail) che ha superato il trasporto sicuro (TLS) rispetto a 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.

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 dalla reputazione di questo 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, vedi "Dashboard della reputazione di dominio e IP" nella sezione Dashboard della pagina della guida 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 inviare messaggi di buona qualità, ma si tende a inviare a intermittenza un volume ridotto di spam. La maggior parte delle email inviate da questa entità avrà un buon tasso di recapito, tranne nei casi di un aumento significativo dei livelli di spam.
LOW È noto che invia regolarmente una notevole quantità di spam e la posta di questo mittente probabilmente verrà contrassegnata come spam.
BAD Storia relativa all'invio di un volume enorme 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 ciclo 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 contrassegnati come spam 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 consegna.

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 consegna.

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 Errore temporaneo di recapito 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 una frequenza sospetta e elevata, a causa della quale sono stati imposti dei limiti di frequenza temporanei. Il limite verrà rimosso una volta che Gmail avrà acquisito una conoscenza sufficiente della natura del traffico.
SUSPECTED_SPAM Gmail sospetta che il traffico sia spam 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 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. Collabora con la RBL per far rimuovere il tuo IP.
DOMAIN_IN_RBL Il dominio è presente in una o più Real-time Blackhole List. Rimuovi il tuo dominio con la 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.