Data API पर ये सीमाएं और कोटा लागू होते हैं.
कोटा कैसे लागू होते हैं
Google Analytics Data API v1 के सभी अनुरोधों के लिए, Google Cloud प्रोजेक्ट की ज़रूरत होती है. साथ ही, इन पर इस पेज पर बताए गए कोटा लागू होते हैं. कोटा का इस्तेमाल, अनुरोध करने वाले प्रोजेक्ट की पहचान करने के लिए इस्तेमाल किए गए तरीके के हिसाब से किया जाता है. इनमें ये शामिल हैं:
- OAuth 2.0 क्रेडेंशियल से पुष्टि किए गए अनुरोध.
- सिर्फ़ एपीआई पासकोड का इस्तेमाल करके पुष्टि किए गए अनुरोध.
कोटा और बिलिंग के मकसद से, किसी अनुरोध को किसी खास Google Cloud प्रोजेक्ट से जोड़ने के लिए, एपीआई पासकोड का इस्तेमाल किया जाता है. आपके प्रोजेक्ट के क्रेडेंशियल या एपीआई पासकोड का इस्तेमाल करके किए गए सभी एपीआई कॉल, आपके प्रोजेक्ट और Google Analytics प्रॉपर्टी के लागू होने वाले कोटा के हिसाब से गिने जाएंगे.
कोटा की कैटगरी
Data API के अनुरोध के कोटा की तीन कैटगरी हैं: कोर, रीयलटाइम, और फ़नल. कोर के तरीकों के लिए किए गए एपीआई अनुरोधों पर, कोर के कोटा के हिसाब से शुल्क लगता है. रीयलटाइम के तरीकों के लिए किए गए एपीआई अनुरोधों पर, रीयलटाइम के कोटा के हिसाब से शुल्क लगता है. हर अनुरोध के लिए, सिर्फ़ एक तरह के कोटा का इस्तेमाल किया जाता है.
| कोटा की कैटगरी | एपीआई के तरीके |
|---|---|
| कोर | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
| रीयलटाइम | runRealtimeReport |
| फ़नल | runFunnelReport |
Analytics प्रॉपर्टी के कोटा
सभी अनुरोधों के लिए, प्रॉपर्टी के कोटा का इस्तेमाल किया जाता है.
| कोटा का नाम | स्टैंडर्ड प्रॉपर्टी की सीमा | Analytics 360 प्रॉपर्टी की सीमा |
|---|---|---|
| हर दिन हर प्रॉपर्टी के लिए कोर टोकन | 2,00,000 | 20,00,000 |
| हर घंटे हर प्रॉपर्टी के लिए कोर टोकन | 40,000 | 4,00,000 |
| हर घंटे हर प्रोजेक्ट के लिए हर प्रॉपर्टी के कोर टोकन | 14,000 | 1,40,000 |
| हर प्रॉपर्टी के लिए एक साथ किए जाने वाले कोर अनुरोध | 10 | 50 |
| हर घंटे हर प्रोजेक्ट के लिए हर प्रॉपर्टी की कोर सर्वर से जुड़ी गड़बड़ियां | 10 | 50 |
| हर दिन हर प्रॉपर्टी के लिए रीयलटाइम टोकन | 2,00,000 | 20,00,000 |
| हर घंटे हर प्रॉपर्टी के लिए रीयलटाइम टोकन | 40,000 | 4,00,000 |
| हर घंटे हर प्रोजेक्ट के लिए हर प्रॉपर्टी के रीयलटाइम टोकन | 14,000 | 1,40,000 |
| हर प्रॉपर्टी के लिए एक साथ किए जाने वाले रीयलटाइम अनुरोध | 10 | 50 |
| हर घंटे हर प्रोजेक्ट के लिए हर प्रॉपर्टी की रीयलटाइम सर्वर से जुड़ी गड़बड़ियां | 10 | 50 |
| हर दिन हर प्रॉपर्टी के लिए फ़नल टोकन | 2,00,000 | 20,00,000 |
| हर घंटे हर प्रॉपर्टी के लिए फ़नल टोकन | 40,000 | 4,00,000 |
| हर घंटे हर प्रोजेक्ट के लिए हर प्रॉपर्टी के फ़नल टोकन | 14,000 | 1,40,000 |
| हर प्रॉपर्टी के लिए एक साथ किए जाने वाले फ़नल अनुरोध | 10 | 50 |
| हर घंटे हर प्रोजेक्ट के लिए हर प्रॉपर्टी की फ़नल सर्वर से जुड़ी गड़बड़ियां | 10 | 50 |
- एक साथ किए जाने वाले अनुरोधों की संख्या का आकलन, एक साथ किए जा रहे अनुरोधों की संख्या के हिसाब से किया जाता है. अनुरोधों की संख्या कम करने के लिए, नए अनुरोध भेजने से पहले पिछले अनुरोधों के पूरा होने का इंतज़ार करें.
- सर्वर की गड़बड़ियां, 500 और 503 कोड वाली गड़बड़ियां होती हैं. सर्वर की गड़बड़ियों के कोटा के हिसाब से शुल्क सिर्फ़ तब लगता है, जब किसी अनुरोध की वजह से सर्वर में कोई गड़बड़ी होती है. जब किसी प्रोजेक्ट और प्रॉपर्टी के लिए, सर्वर की गड़बड़ियों का कोटा खत्म हो जाता है, तो उस प्रोजेक्ट से उस प्रॉपर्टी के लिए किए गए सभी अनुरोध ब्लॉक कर दिए जाते हैं. गड़बड़ी वाले रिस्पॉन्स की पूरी सूची देखने के लिए, गड़बड़ी वाले रिस्पॉन्स देखें.
- हर अनुरोध के लिए, हर घंटे हर प्रॉपर्टी के लिए टोकन और हर घंटे हर प्रोजेक्ट के लिए हर प्रॉपर्टी के टोकन, दोनों के कोटा का इस्तेमाल किया जाता है. इसका मतलब है कि "हर घंटे हर प्रॉपर्टी के लिए टोकन" का कोटा खत्म होने से पहले, "हर घंटे हर प्रोजेक्ट के लिए हर प्रॉपर्टी के टोकन" का कोटा खत्म हो सकता है. ऐसा तब होगा, जब एक प्रॉपर्टी को तीन से ज़्यादा प्रोजेक्ट ऐक्सेस कर रहे हों.
प्रॉपर्टी के लिए, हर घंटे 120 ऐसे अनुरोध किए जा सकते हैं जिन पर थ्रेशोल्ड लागू हो सकता है. userAgeBracket, userGender, brandingInterest, audienceId, और audienceName डाइमेंशन पर थ्रेशोल्ड लागू हो सकता है. सीमाएं इसलिए तय की जाती हैं, ताकि रिपोर्ट देखने वाला कोई व्यक्ति अलग-अलग उपयोगकर्ताओं की डेमोग्राफ़िक्स या रुचियों का पता न लगा सके.
प्रॉपर्टी के टोकन का कोटा
Google Analytics Data API v1 के हर अनुरोध के लिए, टोकन का इस्तेमाल किया जाता है. कितने टोकन का इस्तेमाल किया जाएगा, यह अनुरोध की जटिलता पर निर्भर करता है. ज़्यादातर अनुरोधों के लिए 10 या इससे कम टोकन का इस्तेमाल किया जाता है. हालांकि, ज़्यादा जटिल अनुरोधों के लिए ज़्यादा टोकन का इस्तेमाल किया जाता है.
टोकन के इस्तेमाल पर असर डालने वाली चीज़ें
किसी अनुरोध के लिए टोकन की सटीक लागत, उसे पूरा करते समय तय की जाती है. इसलिए, पहले से सटीक लागत का अनुमान लगाना मुश्किल होता है. लागत पर, अनुरोध और Google Analytics प्रॉपर्टी में मौजूद डेटा, दोनों से जुड़े कई फ़ैक्टर का असर पड़ता है. इन फ़ैक्टर की वजह से लागत बढ़ सकती है:
- लाइनों की संख्या: ज़्यादा लाइनों का अनुरोध करना.
- डाइमेंशन और मेट्रिक की संख्या: ज़्यादा डाइमेंशन और मेट्रिक शामिल करना.
- फ़िल्टर की जटिलता: फ़िल्टर के जटिल एक्सप्रेशन का इस्तेमाल करना.
- तारीख की सीमा की अवधि: ज़्यादा लंबी अवधि के लिए क्वेरी करना.
- डेटा की संख्या: ज़्यादा संख्या वाले डाइमेंशन (कई यूनीक वैल्यू, जैसे कि
pagePath, कस्टम डाइमेंशन) से टोकन की लागत काफ़ी बढ़ सकती है. - प्रॉपर्टी के इवेंट का वॉल्यूम: ज़्यादा वॉल्यूम वाले इवेंट की प्रॉपर्टी पर की गई क्वेरी के लिए, कम डेटा वाली प्रॉपर्टी पर की गई उसी क्वेरी के मुकाबले ज़्यादा टोकन का इस्तेमाल किया जा सकता है.
टोकन के इस्तेमाल की निगरानी करना
अपने खास एपीआई कॉल के लिए टोकन की लागत का पता लगाने का सबसे असरदार तरीका यह है कि अनुरोध के मुख्य हिस्से में, "returnPropertyQuota": true पैरामीटर शामिल किया जाए.
इसके बाद, एपीआई के जवाब में PropertyQuota ऑब्जेक्ट शामिल होगा. इसमें, उस खास अनुरोध के लिए इस्तेमाल किए गए टोकन और बचे हुए कोटा की जानकारी दी जाएगी.