- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- तारीख
- इसे आज़माएं!
उपलब्ध सभी दिनों के लिए ट्रैफ़िक के आंकड़े दिखाएं. अगर उपयोगकर्ता के पास डोमेन के लिए TrafficStats को ऐक्सेस करने की अनुमति नहीं है, तो PERMISSION_DENIED दिखाता है.
एचटीटीपी अनुरोध
GET https://gmailpostmastertools.googleapis.com/v1/{parent=domains/*}/trafficStats
यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
parent |
उस डोमेन के रिसॉर्स का नाम जिसका ट्रैफ़िक आंकड़ा हमें देखना है. इसका फ़ॉर्मैट |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
startDate |
मेट्रिक का सबसे पहला दिन, जिसमें डेटा शामिल है. startDate और endDate, दोनों को बताना ज़रूरी है या दोनों को बताना ज़रूरी नहीं है. अगर सिर्फ़ एक वैल्यू दी गई है या endDate, startDate से पहले की है, तो INVALID_ARGUMENT दिखेगा. |
endDate |
एक्सक्लूज़िव डेटा पाने के लिए, मेट्रिक का सबसे हाल का दिन. startDate और endDate, दोनों को बताना ज़रूरी है या दोनों को बिना बताए छोड़ा जा सकता है. अगर सिर्फ़ एक वैल्यू दी गई है या endDate, startDate से पहले की है, तो INVALID_ARGUMENT दिखेगा. |
pageSize |
पेज का अनुरोध किया गया साइज़. हो सकता है कि सर्वर, अनुरोध किए गए TrafficStats से कम दिखाए. अगर कोई वैल्यू नहीं दी जाती है, तो सर्वर कोई सही डिफ़ॉल्ट वैल्यू चुन लेगा. |
pageToken |
अगर सूची के लिए किए गए किसी पिछले अनुरोध से nextPageToken वैल्यू मिली है, तो वह वैल्यू. यह |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
trafficStats.list के लिए रिस्पॉन्स मैसेज.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{
"trafficStats": [
{
object ( |
फ़ील्ड | |
---|---|
trafficStats[] |
TrafficStats की सूची. |
nextPageToken |
नतीजों के अगले पेज को वापस लाने के लिए टोकन. अगर सूची में कोई और नतीजा नहीं है, तो यह खाली होता है. |
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/postmaster.readonly
ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.
तारीख
कैलेंडर की पूरी या कुछ तारीख दिखाता है, जैसे कि जन्मदिन. दिन का समय और टाइम ज़ोन, कहीं और बताया गया है या यह जानकारी ज़रूरी नहीं है. तारीख, ग्रेगोरियन कैलेंडर के हिसाब से होती है. यह इनमें से किसी एक को दिखा सकता है:
- साल, महीने, और दिन की वैल्यू शून्य से ज़्यादा होनी चाहिए.
- साल के तौर पर शून्य के साथ महीना और दिन (उदाहरण के लिए, सालगिरह).
- साल, जिसमें महीना और दिन शून्य है.
- साल और महीना, जिसमें दिन की वैल्यू शून्य हो. उदाहरण के लिए, क्रेडिट कार्ड के खत्म होने की तारीख.
मिलते-जुलते टाइप:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON के काेड में दिखाना |
---|
{ "year": integer, "month": integer, "day": integer } |
फ़ील्ड | |
---|---|
year |
तारीख का साल. यह संख्या 1 से 9999 के बीच होनी चाहिए. अगर साल के बिना तारीख बतानी है, तो 0 डालें. |
month |
साल का महीना. यह 1 से 12 के बीच की कोई संख्या होनी चाहिए. अगर महीने और दिन के बिना साल की जानकारी देनी है, तो 0 डालें. |
day |
महीने का दिन. यह वैल्यू 1 से 31 के बीच की होनी चाहिए. साथ ही, यह साल और महीने के लिए मान्य होनी चाहिए. इसके अलावा, साल या साल और महीने के लिए 0 भी डाला जा सकता है, जहां दिन की वैल्यू का कोई मतलब नहीं है. |