- Richiesta HTTP
- Parametri del 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 ricerca
Parametri | |
---|---|
startDate |
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 |
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 |
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 |
Il valore nextPageToken restituito da una precedente richiesta di elenco, 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 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:
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. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza giorno e mese. |
day |
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. |