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_ARGUMENT दिखेगा.

endDate

object (Date)

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

pageSize

integer

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

pageToken

string

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

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

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

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

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 भी डाला जा सकता है, जहां दिन की वैल्यू का कोई मतलब नहीं है.