Method: domains.trafficStats.list

Elenca le statistiche sul traffico per tutti i giorni disponibili. Restituisce PERMISSION_DENIED se l'utente non ha l'autorizzazione per accedere a TrafficStats per il dominio.

Richiesta HTTP

GET https://gmailpostmastertools.googleapis.com/v1/{parent=domains/*}/trafficStats

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Il nome della risorsa del dominio di cui vogliamo elencare le statistiche sul traffico. Deve avere il formato domains/{domain_name}, dove nome_dominio è il nome di dominio completo.

Parametri di query

Parametri
startDate

object (Date)

Il primo giorno delle metriche da recuperare, incluso. startDate e endDate devono essere entrambi specificati o entrambi non specificati. Se ne viene specificato solo uno o se endDate è precedente a startDate, viene restituito INVALID_ARGUMENT.
endDate

object (Date)

Il giorno più recente delle metriche da recuperare in modo esclusivo. startDate e endDate devono essere entrambi specificati o entrambi non specificati. Se ne viene specificato solo uno o se la data di fine è precedente a quella di inizio, viene restituito INVALID_ARGUMENT.
pageSize

integer

Dimensioni della pagina richiesta. Il server potrebbe restituire meno dati TrafficStats rispetto a quelli richiesti. Se non viene specificato, il server sceglierà un valore predefinito appropriato.
pageToken

string

Il valore nextPageToken restituito da una precedente richiesta di elenco, se presente. Questo è il valore di ListTrafficStatsResponse.next_page_token restituito dalla chiamata precedente al metodo trafficStats.list.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per trafficStats.list.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "trafficStats": [
    {
      object (TrafficStats)
    }
  ],
  "nextPageToken": string
}
Campi
trafficStats[]

object (TrafficStats)

L'elenco di TrafficStats.
nextPageToken

string

Token per recuperare la pagina di risultati successiva o vuoto se non ci sono altri risultati nell'elenco.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/postmaster.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

Data

Rappresenta una data di calendario intera o parziale, ad esempio un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Può rappresentare uno dei seguenti elementi:

  • Una data completa, con valori di anno, mese e giorno diversi da zero.
  • Un mese e un giorno, con un anno pari a zero (ad esempio un anniversario).
  • Un anno da solo, con un mese e un giorno pari a zero.
  • Un anno e un mese, con un giorno pari a zero (ad esempio, la data di scadenza di una carta di credito).

Tipi correlati:

Rappresentazione JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campi
year

integer

Anno della data. Deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.
month

integer

Mese di un anno. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno.
day

integer

Giorno di un mese. Deve essere compreso tra 1 e 31 e valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e un mese in cui il giorno non è significativo.