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

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

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

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

समय से जुड़ी गड़बड़ियां

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

सीमाएं

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

दूसरी तरह की सीमाएं

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