Method: domains.trafficStats.list

Mevcut tüm günlere ait 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ı. domains/{domain_name} biçiminde olmalıdır (burada domain_name, tam nitelikli alan adıdır).

Sorgu parametreleri

Parametreler
startDate

object (Date)

Metriklerin alınacağı ilk gün (dahil edilecek değerler). hem startDate hem de endDate belirtilmeli veya belirtilmeden bırakılmalıdır. Yalnızca bir değer belirtilirse veya endDate, startDate tarihinden önceyse INVALID_ARGUMENT döndürülür.

endDate

object (Date)

Hariç tutulacak metriklerin en son günü. hem startDate hem de endDate belirtilmeli veya belirtilmeden bırakılmalıdır. Yalnızca bir değer belirtilirse veya endDate, startDate 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, trafficStats.list yöntemine yapılan önceki ç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

Sonuçların sonraki sayfasını almak için kullanılan jeton. Listede başka sonuç yoksa boş bırakın.

Yetkilendirme kapsamları

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

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

Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.

Tarih

Takvimin tamamını veya bir kısmını temsil eder (ör. doğum günü). Günün saati ve saat dilimi başka bir yerde belirtilmiş veya önemsiz. Tarih, Miladi Takvim'e göredir. Bu, aşağıdakilerden birini temsil edebilir:

  • Sıfır olmayan yıl, ay ve gün değerleriyle tam tarih.
  • Bir ay ve gün ile sıfır yıl (örneğin, bir 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 tarihi belirtmek için 0 arasında olmalıdır.

month

integer

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

day

integer

Ayın günü. 1 ile 31 arasında bir değer olmalı ve yıl ve ay için geçerlidir. Tek başına bir yılı ya da günün önemli olmadığı bir yılı ve ayı belirtmek için 0 değeri girilmelidir.