- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- Tarih
- Deneyin.
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 |
Trafik istatistiklerini listelemek istediğimiz alanın kaynak adı. |
Sorgu parametreleri
Parametreler | |
---|---|
startDate |
Metriklerin alınacağı ilk gün (dahil edilecek değerler). startDate ve endDate hem belirtilmeli hem de 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 |
Hariç tutulacak metriklerin en son günü. startDate ve endDate hem belirtilmeli hem de 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 |
İstenen sayfa boyutu. Sunucu, istenenden daha az TrafficStats döndürebilir. Belirtilmemişse sunucu uygun bir varsayılan seçer. |
pageToken |
Varsa önceki Liste isteğinden döndürülen nextPageToken değeri. Bu, |
İ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 ( |
Alanlar | |
---|---|
trafficStats[] |
Trafik İstatistikleri listesi. |
nextPageToken |
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:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON gösterimi |
---|
{ "year": integer, "month": integer, "day": integer } |
Alanlar | |
---|---|
year |
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 |
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 |
Ayın günü. 1 ile 31 arasında bir değer olmalı ve yıl ve ay için geçerlidir. Yalnızca yılı belirtmek için 0 değerini veya günün önemli olmadığı bir yılı ve ayı belirtmek için 0 değerini girin. |