Method: domains.trafficStats.list

Elenca le statistiche sul traffico per tutti i giorni disponibili. Restituisce PERMISSION_DENIED se l'utente non dispone dell'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 giorno più recente delle metriche da recuperare inclusivi. startDate e endDate devono essere entrambe specificate oppure entrambe non devono essere specificate. Se ne viene specificato solo uno o se la data di fine è anteriore nel tempo rispetto alla data di inizio, viene restituito INVALID_ARGUMENT.

endDate

object (Date)

Il giorno più recente delle metriche da recuperare esclusivamente. startDate e endDate devono essere entrambe specificate oppure entrambe non devono essere specificate. Se ne viene specificato solo uno o se la data di fine è anteriore nel tempo rispetto alla data di inizio, viene restituito INVALID_ARGUMENT.

pageSize

integer

Dimensioni della pagina richiesta. Il server potrebbe restituire meno TrafficStats di quanto richiesto. Se non specificato, il server sceglierà un valore predefinito appropriato.

pageToken

string

Il valore nextPageToken restituito da una precedente richiesta List, 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 successiva dei risultati 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, come un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Può trattarsi di uno dei seguenti valori:

  • Una data completa, con valori diversi da zero per anno, mese e giorno.
  • Un mese e un giorno con zero anni (ad esempio, un anniversario).
  • Un anno a sé stante, con uno zero mese e uno zero-day.
  • Un anno e un mese, con zero-day (ad esempio, la data di scadenza della carta di credito).

Tipi correlati:

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

integer

Anno della data. Il valore deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.

month

integer

Mese dell'anno. Il valore 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 deve essere valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e mese in cui il giorno non è significativo.