इस्तेमाल करने की सीमा

इस्तेमाल की सीमाएं, Google के इन्फ़्रास्ट्रक्चर को ऑटोमेटेड प्रोसेस से सुरक्षित रखती हैं. ये प्रोसेस, Display & Video 360 API का गलत तरीके से इस्तेमाल करती हैं. इससे यह पक्का होता है कि किसी एक डेवलपर की गतिविधियों से, बड़ी कम्यूनिटी पर बुरा असर न पड़े.

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

Display & Video 360 API, दो तरह की सीमाओं का इस्तेमाल करता है:

  • कुल कोटा की सीमाएं, जिनमें सभी ज़रूरी अनुरोधों की गिनती की जाती है.
  • कोटा की सीमाएं लिखें. इन सीमाओं के हिसाब से, लिखने के तरीकों के लिए किए गए सभी ज़रूरी अनुरोधों की गिनती की जाती है. लिखने के तरीकों को ऐसे तरीकों के तौर पर परिभाषित किया जाता है जो संसाधनों में बदलाव करते हैं. जैसे, create, patch, delete या bulkEdit. ध्यान दें कि कुछ तरीकों से, डेटा लिखने के लिए ज़्यादा कोटा खर्च होता है.

अगर आपका प्रोजेक्ट इनमें से किसी भी सीमा से ज़्यादा हो जाता है, तो ट्रैफ़िक को कम किया जा सकता है.

प्रोजेक्ट के लिए कोटा की सीमा

यहां दी गई डिफ़ॉल्ट कोटा सीमाएं, Display & Video 360 के सभी एपीआई संसाधनों और तरीकों के साथ शेयर की जाती हैं:

  • हर प्रोजेक्ट के लिए हर मिनट के कुल अनुरोध: 1500
  • प्रत्येक प्रोजेक्ट के लिए, हर मिनट में लिखने के अनुरोध: 700

विज्ञापन देने वाले के हिसाब से, अनुरोध के कोटे की सीमाएं

अनुरोध करने वाले यूआरएल में विज्ञापन देने वाले का आईडी डालने वाले तरीकों के लिए, "हर विज्ञापन देने वाले के लिए हर प्रोजेक्ट" के कोटे की अतिरिक्त सीमाएं लागू होती हैं.

यूआरएल पाथ में विज्ञापन देने वाले का आईडी बताने वाले सभी अनुरोधों को कोटा की इन सीमाओं के हिसाब से गिना जाएगा. जैसे, advertisers.lineItems, advertisers.creatives या advertisers.channels सेवाओं के लिए किए गए अनुरोध:

  • हर प्रोजेक्ट के लिए, विज्ञापन देने वाले हर व्यक्ति या कंपनी के हिसाब से, हर मिनट में किए गए कुल अनुरोध: 300
  • हर प्रोजेक्ट के लिए, विज्ञापन देने वाले हर व्यक्ति या कंपनी के हिसाब से, हर मिनट में अनुरोध लिखने की संख्या: 150

डेटा को बार-बार लिखने के तरीके

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

डेटा डालने के लिए ज़्यादा इस्तेमाल होने वाले तरीकों से किए गए अनुरोधों को, डेटा डालने के अनुरोध के कोटे के खर्च का हिसाब लगाते समय, पांच डेटा डालने की क्वेरी के तौर पर गिना जाता है. उदाहरण के लिए, एक मिनट में किए गए 100 स्टैंडर्ड लिखने के अनुरोध और 21 लिखने के ज़्यादा अनुरोधों (इनमें से किसी में भी विज्ञापन देने वाले के बारे में जानकारी नहीं दी गई है) को 205 लिखने की क्वेरी (100 + (21 * 5) = 205) के तौर पर गिना जाएगा. साथ ही, यह अनुरोधों के मौजूदा सामान्य कोटे की सीमा, हर मिनट में 200 लिखने की क्वेरी से ज़्यादा होगी.

नीचे दिए गए तरीकों को, डेटा को बार-बार लिखने वाले तरीके माना जाता है:

कोटा की सीमाएं पार करना

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

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

कोड RPC मैसेज सुझाई गई कार्रवाई
429 RESOURCE_EXHAUSTED संसाधन का इस्तेमाल पूरी तरह से कर लिया गया है (उदाहरण के लिए, कोटा देखें). Google API Console से अपने इस्तेमाल की जांच करें और अपने वर्कफ़्लो में बदलाव करें, ताकि अलग-अलग विज्ञापन देने वालों के अनुरोधों को बेहतर तरीके से एक साथ किया जा सके. इसके अलावा, अनुरोध भेजने की दर को सामान्य तौर पर कम किया जा सकता है.

Display & Video 360 API कोटा की सीमाओं को बढ़ाने का अनुरोध नहीं किया जा सकता.