Method: domains.trafficStats.list

सभी उपलब्ध दिनों के ट्रैफ़िक आंकड़ों की सूची बनाएं. अगर उपयोगकर्ता के पास डोमेन के लिए trafficStats तक पहुंचने की अनुमति नहीं है, तो PERMISSION_DENIED देता है.

एचटीटीपी अनुरोध

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

यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
parent

string

उस डोमेन के संसाधन का नाम जिसके ट्रैफ़िक के आंकड़ों को हम सूची में डालना चाहते हैं. इसका फ़ॉर्म domains/{domain_name} होना चाहिए, जिसमेंdomain_name पूरी तरह क्वालिफ़ाइड डोमेन नेम है.

क्वेरी पैरामीटर

पैरामीटर
startDate

object (Date)

वह दिन जिसमें मेट्रिक शामिल की जानी हैं. startDate और endDate, दोनों की जानकारी नहीं दी जानी चाहिए या दोनों को नहीं बताया जाना चाहिए. अगर सिर्फ़ एक वैल्यू दी गई है या endDate, startDate से पहले की है, तो INVALID_ वर्ण दिखेगा.
endDate

object (Date)

खास फिर से पाने के लिए मेट्रिक का सबसे हाल का दिन. startDate और endDate दोनों को तय किया जाना चाहिए या दोनों को तय नहीं किया जाना चाहिए. अगर सिर्फ़ एक वैल्यू दी गई है या endDate, startDate से पहले की है, तो INVALID_ वर्ण दिखेगा.
pageSize

integer

पेज का वह साइज़ जिसके लिए अनुरोध किया गया है. सर्वर अनुरोध से कम trafficStats लौटा सकता है. अगर यह जानकारी नहीं दी गई है, तो सर्वर कोई सही डिफ़ॉल्ट विकल्प चुन लेगा.
pageToken

string

अगर कोई पिछले 'सूची अनुरोध' से NextPageToken मिला है, तो उसकी वैल्यू. यह trafficStats.list के पिछले कॉल से लौटाए गए ListTrafficStatsResponse.next_page_token की वैल्यू है.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

trafficStats.list के लिए जवाब.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना 
{
  "trafficStats": [
    {
      object (TrafficStats)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
trafficStats[]

object (TrafficStats)

ट्रैफ़िक आंकड़ों की सूची.
nextPageToken

string

नतीजों का अगला पेज दिखाने के लिए टोकन. अगर सूची में कोई और नतीजा नहीं है, तो इसे खाली छोड़ा जा सकता है.

अनुमति देने के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.

तारीख

कैलेंडर की पूरी या कुछ तारीख दिखाता है, जैसे कि जन्मदिन. दिन का समय और टाइम ज़ोन या तो किसी दूसरी जगह पर बताया गया है या बहुत कम है. तारीख ग्रिगॉरियन कैलेंडर के हिसाब से है. यह इनमें से किसी एक चीज़ को दिखा सकता है:

  • साल, महीने, और दिन की वैल्यू के अलावा, पूरी तारीख.
  • महीना और दिन, जिसमें कोई साल नहीं हो. उदाहरण के लिए, सालगिरह.
  • अपने-आप में, साल की शुरुआत, जिसमें शून्य महीना और एक शून्य दिन होता है.
  • साल और महीना, जिसमें शून्य दिन हो (उदाहरण के लिए, क्रेडिट कार्ड के खत्म होने की तारीख).

मिलते-जुलते टाइप:

जेएसओएन के काेड में दिखाना 
{
  "year": integer,
  "month": integer,
  "day": integer
}
फ़ील्ड
year

integer

तारीख का साल. 1 से 9999 के बीच होना चाहिए या बिना साल वाली तारीख बताने के लिए 0 होना चाहिए.
month

integer

साल का महीना. बिना महीना और दिन के किसी साल के बारे में बताने के लिए, यह 1 से 12 के बीच होना चाहिए या 0 होना चाहिए.
day

integer

महीने का दिन. 1 से 31 के बीच होना चाहिए और साल और महीने के लिए मान्य होना चाहिए या खुद में किसी साल या किसी साल और महीने के बारे में बताने के लिए 0 मान्य होना चाहिए, जिसमें दिन अहम नहीं होता है.