- HTTP-Anfrage
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- Datum
- Testen!
Traffic-Statistiken für alle verfügbaren Tage auflisten. Gibt PERMISSION_DENIED zurück, wenn der Nutzer nicht berechtigt ist, auf TrafficStats für die Domain zuzugreifen.
HTTP-Anfrage
GET https://gmailpostmastertools.googleapis.com/v1/{parent=domains/*}/trafficStats
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
parent |
Der Ressourcenname der Domain, deren Traffic-Statistiken aufgelistet werden sollen. Er sollte das Format |
Abfrageparameter
Parameter | |
---|---|
startDate |
Der früheste Tag, an dem die Messwerte (inklusive) abgerufen werden sollen. „startDate“ und „endDate“ müssen beide angegeben werden oder beide dürfen nicht angegeben werden. Ist nur einer angegeben oder liegt das Enddatum vor dem Startdatum, wird INVALID_ARGUMENT zurückgegeben. |
endDate |
Der letzte Tag, an dem die Messwerte exklusiv abgerufen werden sollen. „startDate“ und „endDate“ müssen beide angegeben sein oder beide dürfen nicht angegeben werden. Ist nur einer angegeben oder liegt das Enddatum vor dem Startdatum, wird INVALID_ARGUMENT zurückgegeben. |
pageSize |
Angeforderte Seitengröße. Der Server gibt möglicherweise weniger TrafficStats zurück als angefordert. Wenn kein Wert angegeben ist, wählt der Server einen geeigneten Standardwert aus. |
pageToken |
Der Wert "nextPageToken" wurde gegebenenfalls von einer vorherigen Listenanfrage zurückgegeben. Dies ist der Wert von |
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 ( |
Felder | |
---|---|
trafficStats[] |
Die Liste der TrafficStats. |
nextPageToken |
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. Tageszeit und Zeitzone werden entweder an anderer Stelle angegeben oder sind unbedeutend. Das Datum bezieht sich auf den gregorianischen Kalender. Dies kann Folgendes bedeuten:
- Ein vollständiges Datum mit Werten für Jahr, Monat und Tag ungleich null.
- Monat und Tag mit einem Jahr 0 (z. B. ein Jahrestag)
- Ein Jahr für sich allein, mit einem Monat 0 und einem Tag 0.
- Ein Jahr und ein Monat mit einem Tag null (z. B. das Ablaufdatum einer Kreditkarte).
Ähnliche Typen:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON-Darstellung |
---|
{ "year": integer, "month": integer, "day": integer } |
Felder | |
---|---|
year |
Jahr des Datums. Der Wert muss zwischen 1 und 9999 liegen, oder 0, um ein Datum ohne Jahr anzugeben. |
month |
Monat eines Jahres. Muss zwischen 1 und 12 liegen, oder 0, um ein Jahr ohne Monat und Tag anzugeben. |
day |
Tag eines Monats Der Wert muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Mit 0 können Sie ein Jahr allein oder ein Jahr und einen Monat angeben, bei dem der Tag nicht von Bedeutung ist. |