इस्तेमाल करने की सीमाएं और कोटा

सीमाएं और कोटा, Google के इंफ़्रास्ट्रक्चर को ऐसी ऑटोमेटेड प्रोसेस से बचाते हैं जो Reseller API का गलत तरीके से इस्तेमाल करती है. किसी एपीआई से बहुत ज़्यादा अनुरोध, टाइप करने में हुई किसी सामान्य गड़बड़ी की वजह से हो सकते हैं. इसके अलावा, यह भी हो सकता है कि सिस्टम को ठीक से डिज़ाइन न किया गया हो और वह बिना वजह एपीआई कॉल कर रहा हो. वजह चाहे जो भी हो, जब किसी सोर्स से आने वाला ट्रैफ़िक एक तय सीमा तक पहुंच जाता है, तो उसे ब्लॉक करना ज़रूरी होता है. इससे Google Workspace सिस्टम को सही तरीके से काम करने में मदद मिलती है. इससे यह पक्का होता है कि किसी डेवलपर की कार्रवाइयों से, बड़े समुदाय पर बुरा असर नहीं पड़ सकता.

एपीआई अनुरोध पूरे नहीं हो पाए

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

समय के हिसाब से होने वाली गड़बड़ियां

समय पर आधारित सभी गड़बड़ियों (हर थ्रेड के लिए N सेकंड में ज़्यादा से ज़्यादा N चीज़ें) के लिए, हमारा सुझाव है कि आपका कोड अपवाद को पकड़े. खास तौर पर, 503 स्टेटस कोड की गड़बड़ियों के लिए. साथ ही, एक्सपोनेंशियल बैकऑफ़ एल्गोरिदम का इस्तेमाल करके, कॉल को फिर से आज़माने से पहले कुछ समय इंतज़ार करें. एक थ्रेड के लिए Reseller API का उदाहरण यह है कि पांच सेकंड तक इंतज़ार करें और पूरे नहीं हुए कॉल को फिर से आज़माएं. अगर अनुरोध पूरा हो जाता है, तो अन्य थ्रेड के लिए भी यही तरीका दोहराएं. अगर दूसरा अनुरोध पूरा नहीं होता है, तो आपके ऐप्लिकेशन को अनुरोध की फ़्रीक्वेंसी को तब तक कम करना चाहिए, जब तक कॉल पूरा न हो जाए. उदाहरण के लिए, कॉल शुरू होने में लगने वाले शुरुआती पांच सेकंड के समय को बढ़ाकर 10 सेकंड करें. इसके बाद, कॉल कनेक्ट न होने की समस्या को ठीक करने के लिए फिर से कोशिश करें. साथ ही, फिर से कोशिश करने की सीमा तय करें. उदाहरण के लिए, उपयोगकर्ता को गड़बड़ी का मैसेज दिखाने से पहले, अनुरोध को पांच से सात बार फिर से भेजें. हर बार अनुरोध भेजने के बीच कुछ समय का अंतर रखें.

सीमाएं

एपीआई की सीमा से जुड़ी कैटगरी	सीमाएं
सदस्यता purchaseOrderId	इस प्रॉपर्टी में, ज़्यादा से ज़्यादा 80 सामान्य टेक्स्ट वर्णों का इस्तेमाल किया जा सकता है.
सदस्यता maxResults	maxResults क्वेरी स्ट्रिंग में 1 से 100 नतीजे हो सकते हैं. डिफ़ॉल्ट रूप से, 20 नतीजे दिखाए जाते हैं.
ट्रांसफ़र टोकन (customerAuthToken)	ग्राहक का ट्रांसफ़र टोकन, जनरेट होने के 30 दिनों तक मान्य रहता है.
किसी ग्राहक के लिए उपयोगकर्ताओं की ज़्यादा से ज़्यादा संख्या	आपके कानूनी समझौते के हिसाब से, ज़्यादा से ज़्यादा 50,000 उपयोगकर्ता हो सकते हैं. इसके अलावा, रीसेलर के साथ हुए कानूनी समझौते में तय की गई संख्या के हिसाब से भी उपयोगकर्ता हो सकते हैं.
बिना अनुमति के किए गए अनुरोध	Google, Reseller API के लिए बिना अनुमति वाले अनुरोधों को स्वीकार नहीं करता. अगर अनुमति देने वाला टोकन नहीं दिया जाता है, तो अनुरोध को बिना अनुमति के किया गया अनुरोध माना जाता है. ज़्यादा जानकारी के लिए, पहचान की पुष्टि करने और अनुमति देने के बारे में जानें लेख पढ़ें.

अन्य तरह की सीमाएं

अन्य तरह की सीमाएं	सीमाएं और दिशा-निर्देश
डेटा फ़ॉर्मैट	डेटा फ़ॉर्मैट, JavaScript Object Notation JSON में है. JSON एक सामान्य इंटरनेट फ़ॉर्मैट है. यह किसी भी डेटा स्ट्रक्चर को दिखाने का तरीका उपलब्ध कराता है. JSON एक टेक्स्ट फ़ॉर्मैट है. यह किसी भी भाषा पर निर्भर नहीं करता. हालांकि, इसमें ऐसे नियमों का इस्तेमाल किया जाता है जिनके बारे में C-फ़ैमिली की भाषाओं के प्रोग्रामर जानते हैं. जैसे, C, C++, C#, Java, JavaScript, Perl, और Python.
समय का फ़ॉर्मैट	सभी तारीख और समय, मिलीसेकंड में Epoch converter में होते हैं. यह फ़ॉर्मैट, सदस्यता बनाने के समय, प्लान की प्रतिबद्धता शुरू और खत्म होने के समय, और बिना किसी शुल्क के 30 दिनों तक आज़माने की सुविधा खत्म होने के समय की वैल्यू पर लागू होता है.