Method: domains.trafficStats.list

Wyświetl statystyki ruchu dla wszystkich dostępnych dni. Zwraca uprawnienie PERMISSION_DENIED, jeśli użytkownik nie ma uprawnień dostępu do statystyk ruchu w domenie.

Żą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, dla której mamy wyświetlić statystyki ruchu. Powinien mieć postać domains/{domain_name}, gdzie nazwa_domeny to pełna i jednoznaczna nazwa domeny.

Parametry zapytania

Parametry
startDate

object (Date)

Najwcześniejszy dzień, z którego dane mają pobierać wartości włącznie. Musisz podać obie daty (startDate) i endDate (lub obie te wartości) albo pozostawić je nieokreślone. Jeśli została określona tylko jedna wartość lub data zakończenia jest wcześniejsza niż data rozpoczęcia, zwracana jest wartość Część IARC.
endDate

object (Date)

Dzień, z którego dane mają być pobierane tylko w przypadku wyłączności. Musisz podać obie daty rozpoczęcia i daty zakończenia albo obie te wartości nieokreślone. Jeśli została określona tylko jedna wartość lub data zakończenia jest wcześniejsza niż data rozpoczęcia, zwracana jest wartość Część IARC.
pageSize

integer

Żądany rozmiar strony. Serwer może zwrócić mniejszą liczbę statystyk ruchu niż zażądano. Jeśli wartość ta nie zostanie określona, serwer wybierze odpowiednie ustawienie domyślne.
pageToken

string

Wartość nextPageToken zwrócona z poprzedniego żądania listy (jeśli miała miejsce). To jest wartość ListTrafficStatsResponse.next_page_token zwrócona z poprzedniego wywołania metody trafficStats.list.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Wiadomość z odpowiedzią 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 ruchu.
nextPageToken

string

Token do pobrania następnej strony wyników lub pusty, jeśli na liście nie ma więcej wyników.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w przewodniku po autoryzacji.

Data

Reprezentuje całą datę kalendarzową lub jej część, na przykład datę urodzin. Pora dnia i strefa czasowa są podane w innym miejscu lub są nieistotne. Data odnosi się do kalendarza gregoriańskiego. Może to być:

  • Pełna data oraz wartości roku, miesiąca i dnia inne niż zero.
  • Miesiąc i dzień z zerowym rokiem (na przykład rocznica).
  • Jeden rok z zerowym miesiącem i dniem zerowym.
  • Rok i miesiąc z zerowym dniem (na przykład data ważności karty kredytowej).

Podobne typy:

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

integer

Rok daty. Należy podać wartość z zakresu od 1 do 9999 lub 0, aby określić datę bez roku.
month

integer

Miesiąc w roku. Należy podać wartość z zakresu od 1 do 12 lub 0, aby określić rok bez miesiąca i dnia.
day

integer

Dzień miesiąca. Należy podać wartość z zakresu od 1 do 31 i ważną dla roku i miesiąca lub 0, aby określić sam rok lub rok i miesiąc, w którym dzień nie jest istotny.