इस दस्तावेज़ में, Management API और Reporting API के लिए अनुरोध करने की सीमाओं और कोटा के बारे में जानकारी दी गई है.
लाखों साइटें Google Analytics का इस्तेमाल करती हैं. हम एपीआई अनुरोधों पर सीमाएं और कोटा लागू करते हैं, ताकि सिस्टम को ज़रूरत से ज़्यादा डेटा न मिले. इससे यह भी पक्का किया जाता है कि सिस्टम के संसाधनों को बराबर-बराबर बांटा जाए. सीमाओं और कोटे में बदलाव किया जा सकता है.
इस वीडियो में, Google Analytics API के लिए अनुरोध के कोटा को मैनेज करने के सबसे सही तरीकों के बारे में बताया गया है.
सामान्य कोटे की सीमाएं
ये कोटा Management API, Core Reporting API v3, एमसीएफ़ रिपोर्टिंग एपीआई, Metadata API, User Deletion API, और रीयल टाइम रिपोर्टिंग एपीआई पर लागू होते हैं:
- हर प्रोजेक्ट पर हर दिन 50,000 अनुरोध होते हैं, जिन्हें बढ़ाया जा सकता है.
- हर आईपी पते के लिए, 10 क्वेरी प्रति सेकंड (क्यूपीएस).
- एपीआई कंसोल में, एक मिलता-जुलता कोटा होता है, जिसे हर उपयोगकर्ता के हिसाब से हर 100 सेकंड के लिए किए जाने वाले अनुरोध के तौर पर जाना जाता है. डिफ़ॉल्ट रूप से, इसे हर उपयोगकर्ता के लिए हर 100 सेकंड में 100 अनुरोधों पर सेट किया जाता है. साथ ही, इसे ज़्यादा से ज़्यादा 1,000 अनुरोधों पर सेट किया जा सकता है. हालाँकि, एपीआई को भेजे जाने वाले अनुरोधों की संख्या, हर उपयोगकर्ता के लिए ज़्यादा से ज़्यादा 10 अनुरोधों तक सीमित है.
- अगर आपका ऐप्लिकेशन एक ही आईपी पते से सभी एपीआई अनुरोध करता है (यानी, आपके उपयोगकर्ताओं की ओर से), तो हर उपयोगकर्ता के लिए पूरा क्यूपीएस कोटा पाने के लिए, हर अनुरोध के साथ
userIPयाquotaUserपैरामीटर का इस्तेमाल करें. ज़्यादा जानकारी के लिए, स्टैंडर्ड क्वेरी पैरामीटर की खास जानकारी देखें.
Reporting APIs
नीचे दिए गए कोटे सभी Reporting API पर लागू होते हैं, जिनमें Core Reporting API v3, Analytics Reporting API v4, रीयल टाइम एपीआई v3, और मल्टी-चैनल फ़नल एपीआई v3 शामिल हैं:
- हर व्यू (प्रोफ़ाइल) के लिए, हर दिन 10,000 अनुरोध (इसे बढ़ाया नहीं जा सकता)
- हर व्यू (प्रोफ़ाइल) के लिए, एक साथ 10 अनुरोध (बढ़ाए नहीं जा सकते)
Reporting API के अनुरोध से जुड़ी गड़बड़ियां
अगर Reporting API को भेजा गया आपका अनुरोध, सर्वर की गड़बड़ी की वजह से फ़ेल हो जाता है, तो आपको रिस्पॉन्स कोड 500 या 503 मिलता है. अनुरोध फिर से सबमिट किया जा सकता है. हालांकि, अगर यह अनुरोध बार-बार अस्वीकार हो जाता है, तो इसे एक से ज़्यादा बार सबमिट न करें. Google Analytics
की अनुमति है:
- हर प्रोजेक्ट के लिए, हर व्यू (प्रोफ़ाइल) के लिए, हर घंटे 10 सर्वर की गड़बड़ी वाले अनुरोध
- हर प्रोजेक्ट के लिए, हर व्यू (प्रोफ़ाइल) के हिसाब से, हर दिन 50 सर्वर की गड़बड़ी वाले अनुरोध
अगर आपके पूरे न हो पाने वाले अनुरोधों की संख्या, इन कोटे से ज़्यादा हो जाती है, तो आपको यह गड़बड़ी दिखेगी:
Quota Error: The number of recent reporting API requests failing by server error is too high. You are temporarily blocked from the reporting API for at least an hour. Please send fewer server errors in the future to avoid being blocked.
अनुरोध सर्वर की गड़बड़ियों की संभावना को कम करने के लिए, अनुरोध को आसान बनाकर: तारीख की सीमा कम करें, अनुरोध में डाइमेंशन की संख्या कम करें या अनुरोध में मेट्रिक की संख्या कम करें.
नाकामयाब अनुरोध को लगातार फिर से सबमिट न करें. इसके बजाय, इसे फिर से सबमिट करने के लिए, एक्स्पोनेंशियल बैकऑफ़ लागू करें.
सर्वर की गड़बड़ी की दर के कोटा, हर घंटे और हर दिन के लिए गड़बड़ी की दर के कोटा के लिए, रोलिंग विंडो पर लागू किए जाते हैं. प्रोजेक्ट के एक घंटे बाद और पेयर के पहली सर्वर गड़बड़ी को देखने पर, कोटा रीसेट हो जाता है. अगर कोई प्रोजेक्ट और व्यू पेयर एक घंटे में सर्वर की 10 गड़बड़ियां भेजता है, तो प्रोजेक्ट और व्यू पेयर को एपीआई से ब्लॉक किया जाता है. यह ब्लॉक सर्वर की पहली गड़बड़ी के खत्म होने के एक घंटे बाद तक होता है.
उदाहरण के लिए, अगर प्रोजेक्ट और व्यू के जोड़े में पिछले 24 घंटों में सर्वर की गड़बड़ी नहीं भेजी गई है, तो इस प्रोजेक्ट और व्यू के लिए, इसके 50 कोटे में से 0 का इस्तेमाल किया जाएगा. मान लें कि यह प्रोजेक्ट और व्यू अब सुबह 6:12 बजे एक सर्वर गड़बड़ी भेजता है. अगर यह प्रोजेक्ट और व्यू अगले दिन सुबह 6:12 बजे से पहले सर्वर की 49 अतिरिक्त गड़बड़ियां भेजता है, तो यह प्रोजेक्ट और व्यू अगले दिन की सुबह 6:12 बजे तक ब्लॉक कर दिया जाएगा. अगले दिन सुबह 6:12 बजे, इस प्रोजेक्ट और व्यू के लिए सर्वर की गड़बड़ी की दर का कोटा पूरी तरह से रीसेट हो जाएगा.
Analytics Reporting API v4
ये कोटा सिर्फ़ Analytics Reporting API v4 पर लागू होते हैं:
- हर प्रोजेक्ट के लिए हर दिन किए जाने वाले अनुरोधों की संख्या: 50,000
- हर व्यू के हिसाब से (प्रोफ़ाइल) हर दिन मिलने वाले अनुरोधों की संख्या: 10,000 (इसे बढ़ाया नहीं जा सकता)
- हर प्रोजेक्ट के लिए, हर 100 सेकंड में मिले अनुरोधों की संख्या: 2,000
- हर प्रोजेक्ट के लिए, हर उपयोगकर्ता के हिसाब से हर 100 सेकंड में अनुरोधों की संख्या: 100 (Google API कंसोल में इसे बढ़ाकर 1,000 किया जा सकता है).
Google API (एपीआई) कंसोल में अपने प्रोजेक्ट के कोटा को देखा जा सकता है.
संसाधन आधारित कोटा
Analytics Reporting API v4 पर संसाधन पर आधारित कोटा लागू होने का विकल्प भी होता है. इस सुविधा की मदद से, Analytics 360 के ग्राहकों के लिए, सैंपलिंग के ज़्यादा थ्रेशोल्ड का इस्तेमाल किया जा सकता है.
स्टोरेज कोटे की तय सीमा से ज़्यादा हैं
अगर Google Analytics API के लिए अनुरोध करने की सीमा पार हो गई है, तो एपीआई गड़बड़ी कोड 403 या 429 दिखाता है. साथ ही, यह मैसेज भी दिखाता है कि खाते का कोटा खत्म हो गया है. ज़्यादा जानकारी के लिए, सेवा की शर्तें देखें.
अतिरिक्त कोटा का अनुरोध किया जा रहा है
सिर्फ़ इन्हें बढ़ाने का अनुरोध किया जा सकता है:
- हर प्रोजेक्ट के लिए रोज़ पढ़े जाने के अनुरोधों की संख्या (डिफ़ॉल्ट रूप से 50,000)
- हर प्रोजेक्ट के लिए रोज़ लिखने के अनुरोधों की संख्या (50 डिफ़ॉल्ट)
अपने प्रोजेक्ट के इस्तेमाल की सीमाएं देखने या बदलने या कोटा बढ़ाने का अनुरोध करने के लिए, यह तरीका अपनाएं:
- अगर आपके पास अपने प्रोजेक्ट के लिए, पहले से कोई बिलिंग खाता नहीं है, तो एक खाता बनाएं.
- एपीआई कंसोल में, एपीआई लाइब्रेरी के चालू एपीआई पेज पर जाएं और सूची से कोई एपीआई चुनें.
- कोटा से जुड़ी सेटिंग देखने और उनमें बदलाव करने के लिए, कोटा चुनें. इस्तेमाल के आंकड़े देखने के लिए, इस्तेमाल को चुनें.
कोटा की ज़्यादा से ज़्यादा सीमा को बढ़ाने का अनुरोध करने के लिए, कृपया Analytics API कोटा के लिए अनुरोध करने का फ़ॉर्म भरें. अनुरोध सबमिट करने से पहले, जानकारी को ज़रूर पढ़ें और कोटा अनुरोध फ़ॉर्म में दिए गए निर्देशों का पालन करें. Reporting API v4 के लिए, Google API कंसोल में एपीआई का नाम Google Analytics Reporting API है. अन्य सभी v3 एपीआई (उदाहरण के लिए, मैनेजमेंट एपीआई v3, Core Reporting API v3, Real Time Reporting API v3, User Deletion API v3) की सूची, Google API कंसोल में Analytics API में दी गई है.
कोटा मैनेजमेंट के बारे में ज़्यादा जानकारी पाने और कोटा इस्तेमाल करने के लिए अपने ऐप्लिकेशन को बेहतर बनाने का तरीका जानने के लिए, एपीआई पर नज़र रखना और कैपिंग इस्तेमाल करना लेख पढ़ें.