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

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

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

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

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

ये कोटा मैनेजमेंट एपीआई, कोर रिपोर्टिंग एपीआई v3, एमसीएफ़ रिपोर्टिंग एपीआई, मेटाडेटा एपीआई, उपयोगकर्ता को मिटाने वाले एपीआई, और रीयल-टाइम रिपोर्टिंग एपीआई पर लागू होते हैं:

  • हर दिन प्रोजेक्ट के लिए 50,000 अनुरोध. इसे बढ़ाया जा सकता है.
  • हर आईपी पते पर 10 क्वेरी (सेकंड में).
    • एपीआई कंसोल में, इससे मिलता-जुलता कोटा होता है. इसे हर उपयोगकर्ता के लिए, हर 100 सेकंड के अनुरोध के तौर पर बताया जाता है. यह डिफ़ॉल्ट रूप से हर उपयोगकर्ता के लिए हर 100 सेकंड के लिए 100 अनुरोध पर सेट है और इसे ज़्यादा से ज़्यादा 1,000 के लिए सेट किया जा सकता है. हालांकि, एपीआई पर हर उपयोगकर्ता के लिए ज़्यादा से ज़्यादा 10 अनुरोध हो सकते हैं.
    • अगर आपका ऐप्लिकेशन किसी एक आईपी पते से सभी एपीआई अनुरोध करता है (यानी, आपके उपयोगकर्ताओं की ओर से), तो हर उपयोगकर्ता के लिए पूरा QPS कोटा पाने के लिए, हर अनुरोध के साथ 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 जीबी
  • लागत डेटा की खास सीमाएं:
    • हर तारीख के लिए 100 एमबी (ga:date). उदाहरण के लिए, अगर आप एक अपलोड में 2014-10-10 और 2014-10-10 के लिए 50 एमबी का डेटा दूसरे अपलोड में इंपोर्ट करते हैं, तो इसका मतलब है कि आप उस डेटा सेट के लिए 10-10-2014 की 100 एमबी की सीमा तक पहुंच गए हैं.

प्रयोग API

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

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

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

  • DRAFT
  • READY_TO_RUN
  • RUNNING

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

नमूनारहित रिपोर्ट API

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

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

उपयोगकर्ता अनुमति API

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

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

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

  • हर बैच अनुरोध के लिए, 300 उपयोगकर्ताओं को अनुमति देने का अनुरोध
  • 30 बैच के उपयोगकर्ता अनुमति लिखने के अनुरोधों की गिनती 1 अनुरोध को लिखने के रूप में की गई

कोटा सीमा पार हो गई

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

अनुरोध भेजने की सीमा बढ़ाने का अनुरोध करना

आप सिर्फ़ इसे बढ़ाने के लिए अनुरोध कर सकते हैं:

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

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

ज़्यादा से ज़्यादा कोटा बढ़ाने का अनुरोध करने के लिए, कृपया Analytics API कोटा अनुरोध फ़ॉर्म का इस्तेमाल करें. अनुरोध सबमिट करने से पहले, पक्का करें कि आपने जानकारी देख ली हो और कोटा अनुरोध फ़ॉर्म में दिए गए निर्देशों का पालन किया हो. रिपोर्टिंग एपीआई v4 के लिए, Google API Console में एपीआई का नाम Google Analytics रिपोर्टिंग एपीआई है. अन्य सभी v3 एपीआई (उदाहरण के लिए, मैनेजमेंट एपीआई v3, कोर रिपोर्टिंग एपीआई v3, रीयल-टाइम रिपोर्टिंग एपीआई v3, यूज़र डिलिशन एपीआई (एपीआई) v3) Google API (एपीआई) कंसोल में Analytics API के तहत सूची में शामिल हैं.

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