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 ricerca

Parametri
startDate

object (Date)

Il primo giorno delle metriche da recuperare, incluse. startDate ed endDate devono essere entrambe specificate o non specificate. Se ne viene specificato solo uno o se la data di fine è precedente nel tempo rispetto a startDate, viene restituito il valore INVALID_REMOVED.
endDate

object (Date)

Il giorno più recente delle metriche da recuperare. Data di inizio e data di fine devono essere entrambe specificate o non specificate. Se ne viene specificato solo uno o se la data di fine è precedente nel tempo rispetto a startDate, viene restituito il valore INVALID_REMOVED.
pageSize

integer

Dimensioni della pagina richiesta. Il server potrebbe restituire un numero inferiore di TrafficStats rispetto a quello richiesto. Se non 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 precedente chiamata 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 dei 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 alle autorizzazioni.

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 valori:

  • Una data completa, con valori di anno, mese e giorno diversi da zero.
  • Un mese e un giorno, con un anno zero (ad esempio, un anniversario).
  • Un anno per sé, con un mese e un giorno zero.
  • Un anno e un mese, con un giorno 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. Il valore deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.
month

integer

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

integer

Giorno del mese. Deve essere compreso tra 1 e 31 ed essere 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.