Method: domains.trafficStats.list

Mevcut tüm günler için trafik istatistiklerini listeleyin. Kullanıcının alan adı için TrafficStats'a erişim izni yoksa PERMISSION_DENIED değerini döndürü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ı. Alan_adı tam alan adıdır. Burada domains/{domain_name} biçiminde olmalıdır.

Sorgu parametreleri

Parametreler
startDate

object (Date)

Metriklerin alınacağı en erken gün dahil olmak üzere. startDate ve endDate belirtilmelidir ya da her ikisi de belirtilmemiştir. Yalnızca bir tane belirtilirse veya endDate, başlangıç tarihinden önceyse, INVALID_ARGUMENT döndürülür.

endDate

object (Date)

Hariç tutulacak metriklerin en son günü. startDate ve endDate belirtilmelidir veya her ikisi de belirtilmemiştir. Yalnızca bir tane belirtilirse veya endDate, başlangıç tarihinden ö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 seçer.

pageToken

string

Varsa önceki Liste isteğinden döndürülen nextPageToken değeri. Bu, önceki trafficStats.list yöntemine yapılan çağrıdan döndürülen ListTrafficStatsResponse.next_page_token değeridir.

İ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)

Trafik İstatistikleri listesi.

nextPageToken

string

Sonraki sonuç sayfasını almak için jeton veya listede başka sonuç yoksa boştur.

Yetkilendirme kapsamları

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

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

Daha fazla bilgi için Yetkilendirme kılavuzuna göz atın.

Tarih

Takvim tarihinin tamamını veya bir kısmını (ör. doğum günü) temsil eder. Günün saati ve saat dilimi, başka bir yerde belirtilmiş veya önemsiz. Tarih, Miladi Takvim ile görecelidir. Aşağıdakilerden birini gösterebilir:

  • Sıfır olmayan yıl, ay ve gün değerleriyle tam tarih.
  • Sıfır yıllı bir ay ve gün (örneğin, yıl dönümü).
  • Tek başına bir yıl (sıfır ay ve sıfır gün).
  • Sıfır gün içeren bir yıl ve ay (örneğin, 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 içermeyen bir 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 olup yıl ve ay için geçerli olmalıdır veya tek başına yıl ya da günün önemli olmadığı yıl ve ay belirtmek için 0 olmalıdır.