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