Mail Admin Quarantine API, हर Google Cloud प्रोजेक्ट के लिए हर मिनट के हिसाब से इस्तेमाल का कोटा लागू करता है. इससे Google Workspace के उस इन्फ़्रास्ट्रक्चर को सुरक्षित रखा जाता है जो क्वॉरंटीन किए गए मैसेज को खोजता है और उन्हें वापस लाता है. कोटा को इस आधार पर ग्रुप किया जाता है कि कोई तरीका किस तरह का काम करता है.
कोटा
यहां दी गई टेबल में कोटा की जानकारी दी गई है. हर कोटा, हर मिनट और हर क्लाउड प्रोजेक्ट के हिसाब से होता है. इसमें उन सभी अनुरोधों की गिनती की जाती है जो प्रोजेक्ट, Google Workspace के सभी ग्राहकों और एडमिन के तौर पर काम करने वाले लोगों के लिए करता है.
| कोटा | वैल्यू | तरीके |
|---|---|---|
| खोज और सूची के अनुरोध | हर मिनट 60 अनुरोध | customers.quarantinedMessages.list, customers.quarantinedMessages.search |
| पढ़ने के अनुरोध | हर मिनट 1,200 अनुरोध | customers.quarantinedMessages.get, customers.quarantines.get, customers.quarantines.list, customers.operations.get |
| डेटा में बदलाव करने के अनुरोध | हर मिनट 300 अनुरोध | customers.quarantinedMessages.release, customers.quarantinedMessages.deny, customers.quarantinedMessages.batchRelease, customers.quarantinedMessages.batchDeny |
हर एपीआई कॉल को एक अनुरोध के तौर पर गिना जाता है. इससे कोई फ़र्क़ नहीं पड़ता कि पेज का साइज़ क्या है या बैच के तरीकों के लिए, बैच में कितने मैसेज हैं. उदाहरण के लिए, 500 मैसेज वाले batchRelease अनुरोध के लिए, डेटा डालने का एक अनुरोध इस्तेमाल होता है.
Google Cloud Console में, अपने प्रोजेक्ट के लिए कोटे के मौजूदा इस्तेमाल की जानकारी देखी जा सकती है. इसके लिए, एपीआई और सेवाएं > चालू एपीआई और सेवाएं > Admin Quarantine API > कोटा और सिस्टम की सीमाएं पर जाएं.
अनुरोध से जुड़ी पाबंदियां
| सीमा | वैल्यू |
|---|---|
list और search अनुरोधों के लिए, ज़्यादा से ज़्यादा pageSize |
300 मैसेज |
batchRelease या batchDeny के हर अनुरोध में ज़्यादा से ज़्यादा कितने मैसेज भेजे जा सकते हैं |
500 मैसेज |
| खोज और सूची विंडो | पिछले 30 दिनों में मिले मैसेज |
कोटे से जुड़ी गड़बड़ियां ठीक करना
जब आपका प्रोजेक्ट कोटे से ज़्यादा इस्तेमाल किया जाता है, तो एपीआई, एचटीटीपी 429 गड़बड़ी दिखाता है. साथ ही, स्टेटस RESOURCE_EXHAUSTED दिखाता है:
{
"error": {
"code": 429,
"message": "Quota exceeded for quota metric 'Search and list quarantined messages requests' and limit 'Search and list requests per minute per project' of service 'mailadminquarantine.googleapis.com' for consumer 'project_number:123456789012'.",
"status": "RESOURCE_EXHAUSTED"
}
}
कोटा की सीमा में रहने के लिए:
- एक्स्पोनेंशियल बैकऑफ़ के साथ फिर से कोशिश करें.
429गड़बड़ी का मैसेज मिलने पर, फिर से कोशिश करने से पहले इंतज़ार करें. साथ ही, हर बार कोशिश के नाकाम होने पर, इंतज़ार का समय बढ़ाएं. ज़्यादा जानकारी के लिए, एक्स्पोनेंशियल बैकऑफ़ लेख पढ़ें. - पेज का साइज़, काम के साइज़ के हिसाब से सबसे बड़ा रखें. खोजने और सूची बनाने के अनुरोधों का कोटा सबसे कम होता है. कई छोटे पेजों के बजाय, हर पेज पर ज़्यादा से ज़्यादा 300 मैसेज का अनुरोध करें.
- फ़िल्टर इस्तेमाल करें.
searchके अनुरोधों कोfilterयाqueryके साथ सीमित करें, ताकि आपको सिर्फ़ वे मैसेज मिलें जिनकी आपको ज़रूरत है. - एक साथ कई कार्रवाइयां करने के लिए, बैच मेथड का इस्तेमाल करें.
batchReleaseयाbatchDenyके एक अनुरोध से, 500 मैसेज रिलीज़ या अस्वीकार किए जा सकते हैं. वहीं,releaseयाdenyके एक कॉल से, सिर्फ़ एक मैसेज रिलीज़ या अस्वीकार किया जा सकता है. - ऑपरेशन को कम से कम पोल करें. बैच ऑपरेशन के लिए इंतज़ार करते समय,
customers.operationsरिसॉर्स केgetतरीके को लगातार कॉल करने के बजाय, कुछ सेकंड के अंतराल पर कॉल करें. - इंक्रीमेंटल सिंक करें. हर बार पूरी सूची को फिर से क्वॉरंटीन करने के बजाय,
status = PENDING_TRIAGEपर फ़िल्टर करें और सिर्फ़ नए मैसेज प्रोसेस करें.
डेवलपर के लिए झलक के दौरान, कोटा नहीं बढ़ाया जा सकता. अगर आपको ज़्यादा कोटा चाहिए, तो Google Workspace Developer Preview Program के ज़रिए अपना सुझाव/राय दें या शिकायत करें.