एपीआई अनुरोधों पर सीमाएं और कोटा

इस दस्तावेज़ में मैनेजमेंट एपीआई और Reporting API के लिए अनुरोध करने की सीमाओं और कोटा के बारे में बताया गया है.

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

इस वीडियो में, Google Analytics API अनुरोध के कोटा को मैनेज करने के सबसे सही तरीकों के बारे में बताया गया है.

सामान्य कोटे की सीमाएं

ये कोटा, Management API, Core Reporting API v3, एमसीएफ़ रिपोर्टिंग एपीआई, मेटाडेटा एपीआई, User Deletion API, और रीयल टाइम रिपोर्टिंग एपीआई पर लागू होते हैं:

  • हर प्रोजेक्ट के लिए हर दिन 50,000 अनुरोध होते हैं, जिन्हें बढ़ाया जा सकता है.
  • हर आईपी पते के लिए 10 क्वेरी प्रति सेकंड (क्यूपीएस).
    • एपीआई कंसोल में, इससे मिलता-जुलता कोटे होता है, जिसे हर उपयोगकर्ता के लिए हर 100 सेकंड के अनुरोध के तौर पर जाना जाता है. डिफ़ॉल्ट रूप से, हर उपयोगकर्ता के लिए हर 100 सेकंड में 100 अनुरोध सेट किए जाते हैं. साथ ही, इसे 1,000 से ज़्यादा कभी नहीं रखा जा सकता. हालांकि, एपीआई को भेजे जाने वाले अनुरोधों की संख्या के लिए, हर उपयोगकर्ता के लिए हर सेकंड ज़्यादा से ज़्यादा 10 अनुरोध तय किए जा सकते हैं.
    • अगर आपका ऐप्लिकेशन एक ही आईपी पते से सभी एपीआई अनुरोध करता है (यानी, आपके उपयोगकर्ताओं की ओर से), तो हर उपयोगकर्ता के लिए पूरा क्यूपीएस कोटा पाने के लिए, हर अनुरोध के साथ userIP या quotaUser पैरामीटर का इस्तेमाल करें. ज़्यादा जानकारी के लिए, स्टैंडर्ड क्वेरी पैरामीटर की खास जानकारी देखें.

मैनेजमेंट एपीआई

Google Analytics इन मैनेजमेंट एपीआई के अनुरोधों पर कोटा लागू करता है:

एपीआई लिखें

ये कोटा, राइट (insert, update, patch, और delete) अनुरोधों पर लागू होते हैं:

  • हर दिन हर प्रोजेक्ट से लिखने के 50 अनुरोध, जिन्हें बढ़ाया जा सकता है
  • हर खाता आईडी के लिए 1.5 क्वेरी प्रति सेकंड (क्यूपीएस)

अनुरोध करते समय होने वाली गड़बड़ियों का डेटा सेव करने की अनुमति दें

अगर जवाब लिखने का आपका अनुरोध पूरा नहीं हो पाता है और आपको रिस्पॉन्स कोड 500 या 503 मिलता है, तो उसे फिर से सबमिट किया जा सकता है. Google Analytics इनकी अनुमति देता है:

  • हर घंटे 50 असफल लिखने के अनुरोध.

अगर हर घंटे 50 से ज़्यादा ऐसे अनुरोध सबमिट किए जाते हैं जिन्हें लिखने में सफल नहीं हुआ, तो आपको यह गड़बड़ी दिखेगी:

Quota Error: The number of recent failed writes is too high.

विफल होने वाले लिखने के अनुरोध को लगातार फिर से सबमिट करने के बजाय, उसे फिर से सबमिट करने के लिए एक्स्पोनेंशियल बैकऑफ़ लागू करें.

डेटा इंपोर्ट एपीआई

ये कोटा खास तौर पर Uploads संसाधन के लिए होते हैं:

  • लाइफ़टाइम में एक्सटेंडेड डेटा इंपोर्ट स्टोरेज की सीमाएं (कलेक्शन एपीआई और SDK टूल से भेजे गए हिट डेटा पर लागू नहीं होता):
  • हर प्रॉपर्टी के लिए 50 डेटा सेट
  • हर दिन हर प्रॉपर्टी के लिए 50 अपलोड कार्रवाइयां
  • अपलोड की गई हर फ़ाइल के लिए 1 जीबी
  • लागत डेटा से जुड़ी खास सीमाएं:
    • हर तारीख के लिए (ga:date) हर डेटा सेट के लिए 100 एमबी. उदाहरण के लिए, अगर 2014-10-2014 के लिए आपने एक अपलोड में 50 MB डेटा इंपोर्ट किया है और 2014-10-10 को दूसरे अपलोड में 50 MB डेटा इंपोर्ट किया है, तो आप उस डेटा सेट की 2014-10-10 को 100 एमबी की सीमा तक पहुंच गए हैं.

एक्सपेरिमेंट एपीआई

यह कोटा केवल प्रयोगों पर लागू होता है:

  • प्रति व्यू (प्रोफ़ाइल) 12 प्रयोग

इनमें से किसी एक प्रयोग वाले प्रयोग statuses को इस कोटा में गिना जाता है:

  • DRAFT
  • READY_TO_RUN
  • RUNNING

एक दिन से ज़्यादा समय के लिए खत्म हुए प्रयोगों (स्थिति = ENDED) को इस कोटा में नहीं गिना जाता.

नमूनारहित रिपोर्ट एपीआई

ये कोटा सिर्फ़ नमूनारहित रिपोर्ट पर लागू होते हैं:

  • नमूनारहित रिपोर्ट बनाने के लिए एपीआई अनुरोधों की गिनती, सामान्य अनुरोध लिखें कोटे में की जाती है.
  • एपीआई उसी हर प्रॉपर्टी के लिए, हर दिन टोकन सिस्टम का इस्तेमाल करता है जिसका इस्तेमाल वेब इंटरफ़ेस, नमूनारहित रिपोर्ट बनाने के लिए करता है.
  • बिना सैंपल वाली रिपोर्ट की संख्या ज़्यादा से ज़्यादा 3,500 हो सकती है. इस सीमा तक पहुंचने पर, एपीआई के नतीजों की मदद से बिना सैंपल वाली रिपोर्ट बनाने की कोशिश करते समय, इस गड़बड़ी का मैसेज दिखेगा:
    Error creating this entity. You have reached the maximum allowed entities of this type.

उपयोगकर्ता की अनुमति का एपीआई

यह कोटा सिर्फ़ उपयोगकर्ता की अनुमतियों पर लागू होता है:

  • एक उपयोगकर्ता के पास ज़्यादा से ज़्यादा 100 Analytics खाते हो सकते हैं. 100 Analytics खाते वाले किसी उपयोगकर्ता को नए खाते में जोड़ने से गड़बड़ी होती है.

उपयोगकर्ता की अनुमतियों के लिए, बैच किए गए लिखने (delete, insert, update) के अनुरोधों पर ये कोटा लागू होते हैं:

  • हर बैच अनुरोध के लिए, 300 उपयोगकर्ता अनुमति के अनुरोध लिखने की सुविधा
  • उपयोगकर्ता की अनुमति के बैच के लिए 30 अनुरोध, जिन्हें एक लिखने के अनुरोध के तौर पर गिना गया

स्टोरेज कोटा पार हो गई है

अगर Google Analytics API के लिए अनुरोध करने की सीमा पार हो गई है, तो एपीआई गड़बड़ी कोड 403 या 429 दिखाता है. साथ ही, यह मैसेज भी दिखाता है कि खाते का कोटा खत्म हो गया है. ज़्यादा जानकारी के लिए सेवा की शर्तें देखें.

अतिरिक्त कोटा का अनुरोध किया जा रहा है

सिर्फ़ इन्हें बढ़ाने का अनुरोध किया जा सकता है:

अपने प्रोजेक्ट के इस्तेमाल की सीमाएं देखने या बदलने या कोटा बढ़ाने का अनुरोध करने के लिए, यह तरीका अपनाएं:

  1. अगर आपके पास अपने प्रोजेक्ट के लिए पहले से कोई बिलिंग खाता नहीं है, तो एक खाता बनाएं.
  2. एपीआई कंसोल में, एपीआई लाइब्रेरी के चालू किए गए एपीआई पेज पर जाएं और सूची से कोई एपीआई चुनें.
  3. कोटा से जुड़ी सेटिंग देखने और उनमें बदलाव करने के लिए, कोटा चुनें. इस्तेमाल के आंकड़े देखने के लिए, इस्तेमाल को चुनें.

तय की गई सीमा को बढ़ाने का अनुरोध करने के लिए, कृपया 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 में दी गई है.

कोटा मैनेजमेंट के बारे में ज़्यादा जानकारी पाने और कोटा इस्तेमाल के लिए, अपने ऐप्लिकेशन को बेहतर बनाने का तरीका जानने के लिए, एपीआई और कैपिंग के इस्तेमाल को मॉनिटर करना देखें.