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

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

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

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

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

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

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

Reporting APIs

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

  • हर दिन व्यू (प्रोफ़ाइल) पर, हर दिन 10,000 अनुरोध
  • हर व्यू (प्रोफ़ाइल) पर एक साथ 10 अनुरोध किए जा सकते हैं (बढ़ाए नहीं जा सकते)

रिपोर्टिंग एपीआई के अनुरोध से जुड़ी गड़बड़ियां

अगर रिपोर्टिंग एपीआई को भेजा गया आपका अनुरोध, सर्वर की किसी गड़बड़ी के साथ पूरा नहीं हो पाता है, तो आपको रिस्पॉन्स कोड 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 बजे, सर्वर की गड़बड़ी दर का कोटा इस प्रोजेक्ट और व्यू के लिए पूरी तरह से रीसेट हो जाएगा.

Analytics रिपोर्टिंग एपीआई v4

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

  • हर प्रोजेक्ट के लिए रोज़ाना अनुरोध की संख्या: 50,000
  • हर व्यू (प्रोफ़ाइल) के हिसाब से हर दिन मिलने वाले अनुरोधों की संख्या: 10,000 (ज़्यादा नहीं किए जा सकते)
  • हर प्रोजेक्ट के लिए, हर 100 सेकंड में किए जाने वाले अनुरोधों की संख्या: 2,000
  • हर प्रोजेक्ट के लिए, हर उपयोगकर्ता के हिसाब से हर 100 सेकंड में किए जाने वाले अनुरोधों की संख्या: 100 (Google API (एपीआई) कंसोल में 1,000 तक बढ़ाया जा सकता है).

आप Google API (एपीआई) कंसोल में अपने प्रोजेक्ट और इसके कोटा देख सकते हैं.

संसाधन आधारित कोटा

Analytics रिपोर्टिंग API v4 भी वैकल्पिक संसाधन आधारित कोटा से नियंत्रित होता है, जो Analytics 360 ग्राहकों के लिए ज़्यादा सैंपलिंग थ्रेशोल्ड का इस्तेमाल करने देता है.

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

अगर 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 के तहत सूची में शामिल हैं.

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