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

इस दस्तावेज़ में, 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 पैरामीटर का इस्तेमाल करें. ज़्यादा जानकारी के लिए, स्टैंडर्ड क्वेरी पैरामीटर की खास जानकारी देखें.

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

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

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