- Richiesta HTTP
- Parametri percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Data
- Prova!
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 |
Il nome della risorsa del dominio di cui vogliamo elencare le statistiche sul traffico. Deve avere il formato |
Parametri di query
Parametri | |
---|---|
startDate |
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 |
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 |
Dimensioni della pagina richiesta. Il server potrebbe restituire meno TrafficStats di quanto richiesto. Se non specificato, il server sceglierà un valore predefinito appropriato. |
pageToken |
Il valore nextPageToken restituito da una precedente richiesta List, se presente. Questo è il valore di |
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 ( |
Campi | |
---|---|
trafficStats[] |
L'elenco di TrafficStats. |
nextPageToken |
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:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Rappresentazione JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Campi | |
---|---|
year |
Anno della data. Il valore deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno. |
month |
Mese dell'anno. Il valore deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno. |
day |
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. |