Method: domains.trafficStats.list

Zugriffsstatistiken für alle verfügbaren Tage auflisten. Gibt PERMISSION_DENIED zurück, wenn der Nutzer keine Berechtigung zum Zugriff auf TrafficStats für die Domain hat.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Der Ressourcenname der Domain, deren Besucherstatistiken aufgelistet werden sollen. Er sollte das Format domains/{domain_name} haben, wobei „domain_name“ der voll qualifizierte Domainname ist.

Abfrageparameter

Parameter
startDate

object (Date)

Der früheste Tag der abzurufenden Messwerte, einschließlich. startDate und endDate müssen beide angegeben oder beide nicht angegeben werden. Wenn nur eines angegeben ist oder endDate vor startDate liegt, wird INVALID_ARGUMENT zurückgegeben.
endDate

object (Date)

Der letzte Tag der abzurufenden Messwerte, ausgenommen. startDate und endDate müssen beide angegeben oder beide nicht angegeben werden. Wenn nur eines angegeben ist oder endDate vor startDate liegt, wird INVALID_ARGUMENT zurückgegeben.
pageSize

integer

Angeforderte Seitengröße. Der Server gibt möglicherweise weniger TrafficStats-Daten zurück, als angefordert. Wenn keine Angabe gemacht wird, wählt der Server einen geeigneten Standardwert aus.
pageToken

string

Der Wert "nextPageToken" wurde gegebenenfalls von einer vorherigen Listenanfrage zurückgegeben. Dies ist der Wert von ListTrafficStatsResponse.next_page_token, der vom vorherigen Aufruf der Methode trafficStats.list zurückgegeben wurde.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für trafficStats.list

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "trafficStats": [
    {
      object (TrafficStats)
    }
  ],
  "nextPageToken": string
}
Felder
trafficStats[]

object (TrafficStats)

Die Liste der TrafficStats.
nextPageToken

string

Token zum Abrufen der nächsten Ergebnisseite. Leer, wenn keine weiteren Ergebnisse in der Liste vorhanden sind.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.

Datum

Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Die Uhrzeit und die Zeitzone werden entweder an einer anderen Stelle angegeben oder sind nicht relevant. Das Datum wird relativ zum gregorianischen Kalender angegeben. Das kann Folgendes bedeuten:

  • Ein vollständiges Datum mit Werten für Jahr, Monat und Tag, die nicht 0 sind.
  • Einen Monat und Tag mit dem Wert „0“ für das Jahr (z. B. ein Jahrestag).
  • Ein Jahr für sich, mit dem Wert „0“ für Monat und Tag.
  • Ein Jahr und ein Monat mit dem Wert „0“ für den Tag (z. B. das Ablaufdatum einer Kreditkarte).

Ähnliche Typen:

JSON-Darstellung 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Felder
year

integer

Das Jahr des Datums. Es muss zwischen 1 und 9999 liegen oder kann 0 sein, wenn ein Datum ohne Jahresangabe angegeben wird.
month

integer

Monat eines Jahres. Die Angabe muss zwischen 1 und 12 liegen. Sie kann auch 0 sein, wenn ein Jahr ohne Monat und Tag angegeben wird.
day

integer

Tag des Monats. Die Angabe muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Sie kann auch 0 sein, wenn das Jahr bzw. der Monat angegeben wird, der Tag selbst jedoch nicht von Belang ist.