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