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