Method: domains.trafficStats.list

सभी उपलब्ध दिनों के ट्रैफ़िक के आंकड़ों की सूची बनाएं. अगर उपयोगकर्ता के पास डोमेन के लिए trafficStats ऐक्सेस करने की अनुमति नहीं है, तो अनुमति_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 वैल्यू कोई मिलती है, तो वह मिलती है. यह ListTrafficStatsResponse.next_page_token की वैल्यू है, जो पिछले कॉल के दौरान trafficStats.list तरीके से दी गई थी.

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

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

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

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

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

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

object (TrafficStats)

trafficStats की सूची.

nextPageToken

string

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

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

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

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

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

तारीख

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

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

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

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

integer

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

month

integer

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

day

integer

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