Data API की सीमाएं और कोटा

Data API पर ये सीमाएं और कोटा लागू होते हैं.

कोटा कैसे लागू होते हैं

Google Analytics Data API v1 के सभी अनुरोधों के लिए, Google Cloud प्रोजेक्ट की ज़रूरत होती है. साथ ही, इन पर इस पेज पर बताए गए कोटा लागू होते हैं. कोटे का इस्तेमाल, कॉल करने वाले प्रोजेक्ट की पहचान करने के लिए इस्तेमाल किए गए तरीके के बावजूद किया जाता है. इनमें ये शामिल हैं:

  • OAuth 2.0 क्रेडेंशियल से पुष्टि किए गए अनुरोध.
  • सिर्फ़ एपीआई कुंजी का इस्तेमाल करके पुष्टि किए गए अनुरोध.

एपीआई कुंजियों का इस्तेमाल, किसी अनुरोध को किसी खास Google Cloud प्रोजेक्ट से जोड़ने के लिए किया जाता है. ऐसा कोटा और बिलिंग के लिए किया जाता है. आपके प्रोजेक्ट के क्रेडेंशियल या एपीआई पासकोड का इस्तेमाल करके किए गए सभी एपीआई कॉल, आपके प्रोजेक्ट और Google Analytics प्रॉपर्टी के लागू होने वाले कोटे के हिसाब से गिने जाएंगे.

कोटा कैटगरी

Data API के लिए, अनुरोध के कोटा की तीन कैटगरी होती हैं: कोर, रीयलटाइम, और फ़नल. कोर के तरीकों के लिए एपीआई अनुरोधों से, कोर के कोटे का शुल्क लिया जाता है. रीयलटाइम रिपोर्टिंग API के तरीकों के लिए किए गए अनुरोधों पर, रीयलटाइम रिपोर्टिंग API के कोटे के हिसाब से शुल्क लिया जाता है. हर अनुरोध में, सिर्फ़ एक तरह के कोटे का इस्तेमाल होता है.

कोटा कैटगरी एपीआई के तरीके
Core runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports
रीयलटाइम runRealtimeReport
फ़नल runFunnelReport

Analytics प्रॉपर्टी के कोटे

सभी अनुरोधों के लिए, प्रॉपर्टी के कोटे का इस्तेमाल किया जाता है.

कोटा का नाम स्टैंडर्ड प्रॉपर्टी की सीमा Analytics 360 प्रॉपर्टी की सीमा
हर दिन हर प्रॉपर्टी के लिए कोर टोकन 2,00,000 2,000,000
हर प्रॉपर्टी के लिए, हर घंटे के हिसाब से कोर टोकन 40,000 400,000
हर प्रोजेक्ट के लिए, हर प्रॉपर्टी के हिसाब से हर घंटे के लिए कोर टोकन 14,000 1,40,000
हर प्रॉपर्टी के लिए एक साथ किए जाने वाले मुख्य अनुरोध 10 50
हर प्रोजेक्ट, हर प्रॉपर्टी, और हर घंटे के हिसाब से मुख्य सर्वर की गड़बड़ियां 10 50
हर प्रॉपर्टी के लिए हर दिन के रीयलटाइम टोकन 2,00,000 2,000,000
हर प्रॉपर्टी के लिए, हर घंटे के हिसाब से रीयलटाइम टोकन 40,000 400,000
हर घंटे, हर प्रॉपर्टी के लिए हर प्रोजेक्ट के हिसाब से रीयलटाइम टोकन 14,000 1,40,000
हर प्रॉपर्टी के लिए, एक साथ किए जाने वाले अनुरोधों की रीयलटाइम संख्या 10 50
हर प्रोजेक्ट, हर प्रॉपर्टी, और हर घंटे के हिसाब से रीयलटाइम सर्वर की गड़बड़ियां 10 50
हर दिन हर प्रॉपर्टी के लिए फ़नल टोकन 2,00,000 2,000,000
हर प्रॉपर्टी के लिए, हर घंटे के हिसाब से फ़नल टोकन 40,000 400,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 ऑब्जेक्ट शामिल होगा. इसमें उस अनुरोध के लिए इस्तेमाल किए गए टोकन और बचे हुए कोटे की जानकारी होगी.