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

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

Reporting APIs

नीचे दिए गए कोटा सभी Reporting API पर लागू होते हैं, जिनमें Core Reporting API v3, Analytics Reporting API v4, रीयल टाइम एपीआई v3, और मल्टी-चैनल फ़नल एपीआई v3 शामिल हैं:

  • हर व्यू (प्रोफ़ाइल) के लिए हर दिन 10,000 अनुरोध (बढ़ाए नहीं जा सकते)
  • हर व्यू (प्रोफ़ाइल) के लिए एक साथ 10 अनुरोध (बढ़ाए नहीं जा सकते)
Analytics रीयल टाइम रिपोर्टिंग एपीआई कॉल को, दूसरे Analytics एपीआई से अलग गिना जाता है. इसका मतलब है कि Analytics रीयल टाइम रिपोर्टिंग एपीआई का इस्तेमाल करके हर दिन हर व्यू (प्रोफ़ाइल) में 10,000 कॉल किए जा सकते हैं और किसी भी दूसरे Analytics एपीआई का इस्तेमाल करके, हर व्यू (प्रोफ़ाइल) के लिए हर दिन 10,000 कॉल किए जा सकते हैं.

यह व्यवहार कोटा मैनेज करने के लिए बेहतर और सुरक्षित तरीका देता है. इससे, Analytics रीयल टाइम रिपोर्टिंग एपीआई का इस्तेमाल करने पर, बार-बार आने वाले कॉल किसी एक व्यू (प्रोफ़ाइल) के लिए, दिन के बाकी समय में गलती से अन्य सभी Analytics 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 कोटे में से किसी भी कोटे का इस्तेमाल किया होगा. मान लें कि इस प्रोजेक्ट और व्यू ने अब सुबह 6:12 बजे एक सर्वर गड़बड़ी भेजी. अगर यह प्रोजेक्ट और व्यू अगले दिन सुबह 6:12 बजे से पहले सर्वर की 49 और गड़बड़ी भेजता है, तो यह प्रोजेक्ट और व्यू अगले दिन सुबह 6:12 बजे तक ब्लॉक रहेगा. अगले दिन सुबह 6:12 बजे, इस प्रोजेक्ट और व्यू के लिए सर्वर की गड़बड़ी की दर का कोटा पूरी तरह से रीसेट हो जाएगा.

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

अगर 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 में दी गई है.

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