सीमाएं और कोटा, Google के इंफ़्रास्ट्रक्चर को अपने-आप काम करने वाली ऐसी प्रोसेस से बचाते हैं जो गलत तरीके से Data ट्रांसफ़र एपीआई का इस्तेमाल करती है. किसी एपीआई से बार-बार अनुरोध करने की वजह, टाइप करने में किसी तरह की गड़बड़ी हो सकती है. यह एक ऐसा सिस्टम भी हो सकता है जिसे सही तरीके से डिज़ाइन न किया गया हो और जिससे बेवजह एपीआई कॉल किए जा सकें. वजह चाहे जो भी हो, किसी खास सोर्स से आने वाले ट्रैफ़िक को, Google Workspace सिस्टम की पूरी सेहत के लिए ब्लॉक करना ज़रूरी है. इससे यह पक्का हो जाता है कि किसी डेवलपर की कार्रवाई की वजह से, पूरी कम्यूनिटी पर बुरा असर न पड़े.
एपीआई अनुरोध पूरे नहीं हो पाए
अगर आपका एपीआई अनुरोध पूरा नहीं हो पाता है, तो आपके ऐप्लिकेशन को एचटीटीपी स्टेटस कोड का रिस्पॉन्स मिलेगा. 403 के स्टेटस कोड में, गलत इनपुट के बारे में गड़बड़ी की जानकारी दी गई है. वहीं, 503 के एचटीटीपी स्टेटस कोड में गड़बड़ी की जानकारी है, जो बताती है कि एपीआई की तय सीमा पार हो गई है. इन जवाबों की मदद से, आपका कस्टम ऐप्लिकेशन इन गड़बड़ियों का पता लगाकर सही
कार्रवाई कर सकता है.
एक तय समयावधि में अनुरोध पूरे करें
अगर आपके अनुरोधों को किसी तय समय में पूरा करना ज़रूरी है, तो अपने अनुरोध साथ-साथ भेजें या अपने Java या C# ऐप्लिकेशन में एक से ज़्यादा थ्रेड का इस्तेमाल करें. उदाहरण के लिए, अपने अनुरोधों को महीने या किसी दूसरी समयावधि के हिसाब से बांट लें. थ्रेड के मामले में, 10 थ्रेड से शुरू करने की कोशिश करें. हर अनुरोध के लिए एक थ्रेड होनी चाहिए. थ्रेड के सुझाव में कुछ समस्याएं हैं और यह एपीआई के सभी मामलों के लिए काम का नहीं है. अगर अनुरोधों की संख्या बहुत ज़्यादा हो जाती है, तो कोटा से जुड़ी गड़बड़ियां होंगी.
समय के हिसाब से होने वाली गड़बड़ियां
समय के हिसाब से होने वाली गड़बड़ियों (हर थ्रेड के लिए X सेकंड के लिए ज़्यादा से ज़्यादा N चीज़ें), खास तौर पर,
503 स्टेटस कोड की गड़बड़ियों के लिए, हमारा सुझाव है कि आप
इस अपवाद को पहचान लें. साथ ही,
एक्स्पोनेंशियल बैकऑफ़
एल्गोरिदम का इस्तेमाल करके, असफल कॉल को फिर से कोशिश करने से पहले थोड़ा इंतज़ार करें. किसी थ्रेड के डेटा ट्रांसफ़र एपीआई का उदाहरण
है. इसमें पांच सेकंड तक इंतज़ार करना और फ़ेल हो चुके कॉल को फिर से कोशिश करना है. अगर अनुरोध पूरा हो जाता है, तो दूसरी थ्रेड के लिए भी इस पैटर्न को दोहराएं. अगर दूसरा अनुरोध पूरा नहीं होता है, तो आपके ऐप्लिकेशन को, अनुरोध की फ़्रीक्वेंसी के आधार पर तब तक स्केल करना चाहिए, जब तक कि कॉल पूरा नहीं हो जाता. उदाहरण
के लिए, शुरुआत के पांच सेकंड की देरी को 10 सेकंड तक बढ़ाएं और जो कॉल पूरा नहीं हो पाया उसे फिर से करके देखें. साथ ही,
फिर से कोशिश करने की सीमा तय करें. उदाहरण के लिए, आपका ऐप्लिकेशन उपयोगकर्ता को गड़बड़ी दिखाए, इससे पहले अलग-अलग देरी के साथ
पांच से सात बार अनुरोध करके देखें.
सीमाएं
| एपीआई लिमिट की कैटगरी | सीमाएं |
|---|---|
| क्वेरी प्रति सेकंड (QPS) | डेवलपर प्रोजेक्ट के लिए, हर खाते के लिए 10 क्वेरी प्रति सेकंड (क्यूपीएस) की सीमा तय की गई है. |
कोटा
| एपीआई कोटा की कैटगरी | कोटा |
|---|---|
| हर दिन ज़्यादा से ज़्यादा एपीआई अनुरोध | हर दिन ज़्यादा से ज़्यादा 5,00,000 एपीआई अनुरोध किए जा सकते हैं. |
| संग्रहित करें, मैसेज खत्म होने की तारीख | ग्रुप संग्रह की समयसीमा खत्म नहीं होती. जब तक ग्रुप को मिटाया नहीं जाता, तब तक मैसेज संग्रह में रहते हैं. ईमेल के रखरखाव की नीति से, ग्रुप के संग्रह में मौजूद मैसेज पर कोई असर नहीं पड़ता. |
| मेल मैसेज का साइज़ | मेल मैसेज का साइज़ 25 एमबी से ज़्यादा नहीं होना चाहिए. इस सीमा में मैसेज के मेटा डेटा हेडर, मुख्य भाग, और सभी अटैचमेंट शामिल हैं. |
दूसरी तरह की सीमाएं
| दूसरी तरह की सीमाएं | सीमाएं और दिशा-निर्देश |
|---|---|
| कॉन्टेंट टाइप के फ़ॉर्मैट | ईमेल मैसेज, स्टैंडर्ड आरएफ़सी 822 टेक्स्ट फ़ॉर्मैट में होना चाहिए.
माइग्रेट किए गए ईमेल को अपलोड करने के लिए, अनुरोध के कॉन्टेंट टाइप के फ़ॉर्मैट में, Content-type: message/rfc822 हेडर का इस्तेमाल किया जाता है.
|
| एपीआई की जांच के नतीजों में डेटा फ़ॉर्मैट | रिस्पॉन्स का डेटा फ़ॉर्मैट, JavaScript ऑब्जेक्ट नोटेशन (JSON) है. |
| डेटा स्टोर करने की जगह से जुड़ी नीतियां | डेटा ट्रांसफ़र एपीआई, डेटा की जगह से जुड़ी नीतियों के साथ काम नहीं करता. इसके लिए, अनुबंध की वजहों से डेटा को खास भौगोलिक या राजनैतिक सीमाओं में सेव करना ज़रूरी है. अगर आपके खाते के लिए, डेटा की जगह की जानकारी ज़रूरी है, तो डेटा ट्रांसफ़र एपीआई का इस्तेमाल न करें. |
| पैरलल मैसेज इंसर्शन | 'डेटा ट्रांसफ़र एपीआई', अलग-अलग ग्रुप के संग्रह में ईमेल शामिल करने के अनुरोधों के साथ काम करता है. हालांकि, डेटा ट्रांसफ़र एपीआई में, एक ही ग्रुप संग्रह में पैरलल मैसेज इंसर्शन की सुविधा काम नहीं करती. एपीआई के इस वर्शन में, एक साथ कई अनुरोध भी काम नहीं करते. |
| बिना अनुमति वाले अनुरोध | 'डेटा ट्रांसफ़र एपीआई' बिना अनुमति के किसी भी अनुरोध को स्वीकार नहीं करता है. अगर अनुमति वाला कोई टोकन नहीं दिया गया है, तो उस अनुरोध को बिना अनुमति के भेजे गए अनुरोध के तौर पर माना जाता है. |