Method: domains.trafficStats.list

Lista statystyk ruchu z wszystkich dostępnych dni. Zwraca wartość PERMISSION_DENIED, jeśli użytkownik nie ma uprawnień dostępu do statystyk ruchu w przypadku danej domeny.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Nazwa zasobu domeny, której statystyki ruchu chcemy wyświetlić. Musi mieć postać domains/{domain_name}, gdzie domain_name to pełna i jednoznaczna nazwa domeny.

Parametry zapytania

Parametry
startDate

object (Date)

Najwcześniejszy dzień, w którym mają być pobrane dane. Musisz podać zarówno startDate, jak i endDate albo nie podawać żadnej z tych wartości. Jeśli podano tylko jedną wartość lub wartość endDate jest wcześniejsza niż startDate, zwracany jest błąd INVALID_ARGUMENT.
endDate

object (Date)

Najnowszy dzień danych, które mają być pobrane. Musisz podać zarówno startDate, jak i endDate, albo nie podawać żadnej z tych wartości. Jeśli podano tylko jedną wartość lub data endDate jest wcześniejsza niż data startDate, zwracany jest błąd INVALID_ARGUMENT.
pageSize

integer

Żądany rozmiar strony. Serwer może zwrócić mniej danych TrafficStats niż żądana liczba. Jeśli nie zostanie określone, serwer wybierze odpowiedni domyślny.
pageToken

string

Wartość nextPageToken zwrócona z poprzedniego żądania List (jeśli takie było). Jest to wartość ListTrafficStatsResponse.next_page_token zwrócona z poprzedniego wywołania metody trafficStats.list.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na trafficStats.list.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "trafficStats": [
    {
      object (TrafficStats)
    }
  ],
  "nextPageToken": string
}
Pola
trafficStats[]

object (TrafficStats)

Lista statystyk dotyczących ruchu.
nextPageToken

string

Token do pobierania następnej strony wyników lub pusty, jeśli na liście nie ma już żadnych wyników.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.

Data

Reprezentuje całą lub częściową datę kalendarzową, np. urodziny. Godzina i strefa czasowa są określone w innym miejscu lub nie mają znaczenia. Data jest podawana w kalendarzu gregoriańskim. Może to być:

  • Pełna data z wartościami roku, miesiąca i dnia innymi niż 0.
  • miesiąc i dzień z zerowym rokiem (np. rocznica).
  • Rok bez miesiąca i dnia.
  • Rok i miesiąc z zerowym dniem (np. data ważności karty kredytowej).

Powiązane typy:

Zapis JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Pola
year

integer

Rok daty. Musi być liczbą z zakresu 1–9999 lub 0, jeśli chcesz podać datę bez roku.
month

integer

Miesiąc w roku. Wartość musi mieścić się w przedziale od 1 do 12, lub 0, jeśli chcesz określić rok bez miesiąca i dnia.
day

integer

Dzień miesiąca. Musi zawierać wartość od 1 do 31 i być prawidłową dla roku lub miesiąca albo 0, aby określić tylko rok lub rok i miesiąc, w których przypadku dzień nie ma znaczenia.