Method: domains.trafficStats.list

Mevcut tüm günlere ait trafik istatistiklerini listeleyin. Kullanıcının alan için TrafficStats'e erişme izni yoksa PERMISSION_DENIED döndürülür.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
parent

string

Trafik istatistiklerini listelemek istediğimiz alanın kaynak adı. domains/{domain_name} biçiminde olmalıdır. Buradaki alan_adı, tam nitelikli alan adıdır.

Sorgu parametreleri

Parametreler
startDate

object (Date)

Alınacak metriklerin dahili en erken günü. Hem startDate hem de endDate belirtilmeli veya her ikisi de belirtilmemelidir. Yalnızca biri belirtilirse veya endDate, startDate'dan daha erken bir tarihse INVALID_ARGUMENT döndürülür.
endDate

object (Date)

Özel olarak alınacak metriklerin en son günü. startDate ve endDate değerlerinin ikisi de belirtilmeli veya ikisi de belirtilmemelidir. Yalnızca biri belirtilirse veya endDate, startDate'dan daha önceyse INVALID_ARGUMENT döndürülür.
pageSize

integer

İstenen sayfa boyutu. Sunucu, istenenden daha az TrafficStats döndürebilir. Belirtilmemişse sunucu uygun bir varsayılan değer seçer.
pageToken

string

Önceki bir listeleme isteğinden döndürülen nextPageToken değeri (varsa). Bu, trafficStats.list yöntemine yapılan önceki çağrıdan döndürülen ListTrafficStatsResponse.next_page_token değerini ifade eder.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

trafficStats.list için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "trafficStats": [
    {
      object (TrafficStats)
    }
  ],
  "nextPageToken": string
}
Alanlar
trafficStats[]

object (TrafficStats)

TrafficStats listesi.
nextPageToken

string

Sonuçların bir sonraki sayfasını almak için kullanılan jeton veya listede başka sonuç yoksa boş.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.

Tarih

Doğum günü gibi takvim tarihlerinin tamamını veya bir kısmını temsil eder. Saat ve saat dilimi başka bir yerde belirtilmiş veya önemsizdir. Tarih, Gregoryen takvimine göredir. Bu, aşağıdakilerden birini temsil edebilir:

  • Sıfır olmayan yıl, ay ve gün değerleri içeren tam tarih.
  • Sıfır yılı olan bir ay ve gün (ör. yıldönümü).
  • Ay ve gün bilgisi olmayan bir yıl.
  • Sıfır gün içeren bir yıl ve ay (ör. kredi kartı son kullanma tarihi).

İlgili türler:

JSON gösterimi 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Alanlar
year

integer

Tarihin yılı. 1 ile 9999 arasında veya yıl olmadan tarih belirtmek için 0 olmalıdır.
month

integer

Yılın ayı. 1 ile 12 arasında veya ay ve gün olmadan bir yıl belirtmek için 0 olmalıdır.
day

integer

Ayın günü. 1 ile 31 arasında olmalı ve yıl ile ay için geçerli olmalıdır. 0 değerini kullanarak da yıl veya gününün önemli olmadığı bir yıl ve ay belirtebilirsiniz.