इस्तेमाल करने की सीमा

Google Chat API एक शेयर की गई सेवा है. इसलिए, हम इस पर कोटा और सीमाएं लागू करते हैं. इससे यह पक्का किया जा सकता है कि सभी उपयोगकर्ता इसका सही तरीके से इस्तेमाल करें. साथ ही, इससे Google Workspace की परफ़ॉर्मेंस को सुरक्षित रखा जा सकता है.

अगर आपने कोटे से ज़्यादा अनुरोध किए हैं, तो आपको 429: Too many requests एचटीटीपी स्टेटस कोड वाला जवाब मिलेगा. चैट के बैकएंड पर, अनुरोधों की संख्या की सीमा की अतिरिक्त जांच करने पर भी, एक जैसा गड़बड़ी वाला जवाब मिल सकता है. अगर यह गड़बड़ी होती है, तो आपको एक्सपोनेंशियल बैकऑफ़ एल्गोरिदम का इस्तेमाल करना चाहिए और बाद में फिर से कोशिश करनी चाहिए. जब तक आप यहां दी गई टेबल में बताए गए, हर मिनट के कोटे के हिसाब से अनुरोध करते हैं, तब तक हर दिन किए जाने वाले अनुरोधों की संख्या पर कोई पाबंदी नहीं होती.

Chat API के तरीकों पर, कई तरह की तय सीमाएं लागू हो सकती हैं: हर प्रोजेक्ट के लिए, हर स्पेस के लिए, और हर उपयोगकर्ता के लिए तय सीमाएं.

हर प्रोजेक्ट के लिए कोटा

हर प्रोजेक्ट के लिए तय किए गए कोटे, Google Cloud प्रोजेक्ट के लिए क्वेरी की दर को सीमित करते हैं. इसलिए, ये कोटे किसी एक Chat ऐप्लिकेशन पर लागू होते हैं. यह ऐप्लिकेशन, हर कोटे के लिए Chat API के तय किए गए तरीकों को कॉल करता है.

इस टेबल में, हर प्रोजेक्ट के लिए क्वेरी की सीमाओं के बारे में जानकारी दी गई है. इन सीमाओं के बारे में जानने के लिए, कोटा पेज पर जाएं.

हर प्रोजेक्ट के लिए कोटा	Chat API के तरीके	सीमा (हर 60 सेकंड में)
हर मिनट में लिखे गए मैसेज	spaces.messages.create spaces.messages.patch spaces.messages.delete	3000
हर मिनट में पढ़े गए मैसेज	spaces.messages.get spaces.messages.list	3000
हर मिनट के हिसाब से सदस्यता लेने वाले लोगों की संख्या	spaces.members.create spaces.members.delete	300
हर मिनट में सदस्यता की जानकारी पढ़ने की संख्या	spaces.members.get spaces.members.list	3000
हर मिनट में स्पेस में लिखे गए डेटा की संख्या	spaces.setup spaces.create spaces.patch spaces.delete	60
हर मिनट में पढ़े गए स्पेस	spaces.get spaces.list spaces.findDirectMessage	3000
हर मिनट में अटैचमेंट लिखने की संख्या	media.upload	600
हर मिनट में पढ़े गए अटैचमेंट	spaces.messages.attachments.get media.download	3000
हर मिनट में की गई प्रतिक्रियाओं की संख्या	spaces.messages.reactions.create spaces.messages.reactions.delete	600
हर मिनट में पढ़ी गई प्रतिक्रियाएं	spaces.messages.reactions.list	3000
CustomEmoji writes per minute	customEmojis.create customEmojis.delete	600
CustomEmoji reads per minute	customEmojis.get customEmojis.list	3000
हर मिनट में सेक्शन में किए गए बदलाव	users.sections.create users.sections.delete users.sections.patch users.sections.position users.sections.items.move	600
हर मिनट में पढ़े गए सेक्शन	users.sections.list users.sections.items.list	3000
हर मिनट में उपलब्धता की जानकारी को कितनी बार पढ़ा गया	users.availability.get	3000
हर मिनट में उपलब्धता की जानकारी अपडेट करने की संख्या	users.availability.update users.availability.markAsActive users.availability.markAsAway users.availability.markAsDoNotDisturb	3000

हर स्पेस के लिए कोटा

हर स्पेस के लिए तय किए गए कोटे, किसी स्पेस में क्वेरी की दर को सीमित करते हैं. ये कोटे, उस स्पेस में काम करने वाले सभी Chat ऐप्लिकेशन के साथ शेयर किए जाते हैं. ये ऐप्लिकेशन, हर कोटे के लिए Chat API के तरीके इस्तेमाल करते हैं.

इस टेबल में, हर स्पेस के लिए क्वेरी की सीमाओं के बारे में बताया गया है:

हर स्पेस के लिए कोटा	Chat API के तरीके	सीमा (प्रति सेकंड)
हर सेकंड में पढ़ी गई संख्या	media.download spaces.get spaces.members.get spaces.members.list spaces.messages.get spaces.messages.list spaces.messages.attachments.get spaces.messages.reactions.list	15
प्रति सेकंड लिखने की संख्या	media.upload spaces.delete spaces.patch spaces.messages.create (आने वाले वेबहुक पर अतिरिक्त सीमाएं लागू होती हैं) spaces.messages.delete spaces.messages.patch spaces.messages.reactions.delete	1
हर सेकंड में प्रतिक्रियाएं लिखने की सुविधा	spaces.messages.reactions.create	5
Google Chat में डेटा इंपोर्ट करते समय, हर सेकंड में लिखे गए मैसेज	spaces.messages.create	10

हर उपयोगकर्ता के हिसाब से कोटा

हर उपयोगकर्ता के लिए तय किए गए कोटे से, Google Chat उपयोगकर्ता के लिए क्वेरी की दर सीमित हो जाती है. क्वेरी उन सभी Chat ऐप्लिकेशन से जुड़ी होती हैं जो किसी उपयोगकर्ता की ओर से Chat API के किसी तरीके को कॉल करते हैं. इसके लिए, उपयोगकर्ता की पुष्टि का इस्तेमाल किया जाता है.

इस टेबल में, हर उपयोगकर्ता के लिए क्वेरी की सीमाओं के बारे में बताया गया है:

हर उपयोगकर्ता के लिए कोटा	Chat API के तरीके	सीमा (प्रति सेकंड)
हर सेकंड में कस्टम इमोजी लिखने की संख्या	customEmojis.create customEmojis.delete	1
CustomEmoji के लिए, हर सेकंड में किए गए रीड ऑपरेशन	customEmojis.get customEmojis.list	15
प्रति सेकंड लिखने की संख्या	users.sections.create users.sections.delete users.sections.patch users.sections.position users.sections.items.move users.availability.update users.availability.markAsActive users.availability.markAsAway users.availability.markAsDoNotDisturb	1
हर सेकंड में पढ़ी गई संख्या	users.sections.list users.sections.items.list users.availability.get	15

इस्तेमाल करने की अन्य सीमाएं

एक ही स्पेस को टारगेट करने वाले ज़्यादा एपीआई ट्रैफ़िक की वजह से, अतिरिक्त इंटरनल सीमाएं ट्रिगर हो सकती हैं. ये सीमाएं, कोटा पेज पर नहीं दिखती हैं.

समय के हिसाब से तय किए गए कोटे से जुड़ी गड़बड़ियां ठीक करना

समय के हिसाब से होने वाली सभी गड़बड़ियों (हर X मिनट में ज़्यादा से ज़्यादा N अनुरोध) के लिए, हमारा सुझाव है कि आपका कोड अपवाद को पकड़ ले और ट्रंकेटेड एक्सपोनेंशियल बैकऑफ़ का इस्तेमाल करे. इससे यह पक्का किया जा सकेगा कि आपके डिवाइस ज़्यादा लोड न जनरेट करें.

एक्सपोनेंशियल बैकऑफ़, नेटवर्क ऐप्लिकेशन के लिए गड़बड़ी ठीक करने की एक स्टैंडर्ड रणनीति है. एक्सपोनेंशियल बैकऑफ़ एल्गोरिदम, अनुरोधों को फिर से भेजने की कोशिश करता है. इसके लिए, अनुरोधों के बीच इंतज़ार का समय तेज़ी से बढ़ता जाता है. यह इंतज़ार का ज़्यादा से ज़्यादा समय तक होता है. अगर अनुरोध अब भी पूरे नहीं हो रहे हैं, तो यह ज़रूरी है कि अनुरोधों के बीच का समय धीरे-धीरे बढ़ता जाए, ताकि अनुरोध पूरा हो सके.

एल्गोरिदम का उदाहरण

एक्सपोनेंशियल बैकऑफ़ एल्गोरिदम, अनुरोधों को बार-बार भेजता है. हर बार अनुरोध भेजने के बीच इंतज़ार का समय बढ़ता जाता है. यह इंतज़ार का समय, बैकऑफ़ के लिए तय किए गए ज़्यादा से ज़्यादा समय तक बढ़ सकता है. उदाहरण के लिए:

1. Google Chat API को अनुरोध भेजें.
2. अगर अनुरोध पूरा नहीं होता है, तो 1 + random_number_milliseconds सेकंड इंतज़ार करें और फिर से अनुरोध करें.
3. अगर अनुरोध पूरा नहीं होता है, तो 2 + random_number_milliseconds सेकंड इंतज़ार करें और फिर से अनुरोध करें.
4. अगर अनुरोध पूरा नहीं होता है, तो 4 + random_number_milliseconds सेकंड इंतज़ार करें और फिर से अनुरोध करें.
5. और इसी तरह, maximum_backoff बार तक.
6. कुछ समय तक इंतज़ार करें और फिर से कोशिश करें. हालांकि, कोशिश करने की संख्या को एक तय सीमा से ज़्यादा न बढ़ाएं. साथ ही, कोशिश करने के बीच के इंतज़ार के समय को न बढ़ाएं.

कहां:

• आपको min(((2^n)+random_number_milliseconds), maximum_backoff) तक इंतज़ार करना होगा. साथ ही, हर बार अनुरोध करने पर n में एक की बढ़ोतरी होगी.
• random_number_milliseconds, 1,000 से कम या इसके बराबर मिलीसेकंड की कोई रैंडम संख्या है. इससे ऐसे मामलों से बचने में मदद मिलती है जिनमें कई क्लाइंट किसी स्थिति के हिसाब से सिंक हो जाते हैं और सभी एक साथ फिर से कोशिश करते हैं. इससे सिंक की गई लहरों में अनुरोध भेजे जाते हैं. अनुरोध को फिर से भेजने के बाद, random_number_milliseconds की वैल्यू फिर से कैलकुलेट की जाती है.
• maximum_backoff की अवधि आम तौर पर 32 या 64 सेकंड होती है. सही वैल्यू, इस्तेमाल के उदाहरण पर निर्भर करती है.

क्लाइंट, maximum_backoff समय पूरा होने के बाद फिर से कोशिश कर सकता है. इसके बाद, फिर से कोशिश करने पर बैकऑफ़ टाइम को बढ़ाने की ज़रूरत नहीं होती. उदाहरण के लिए, अगर कोई क्लाइंट 64 सेकंड का maximum_backoff इस्तेमाल करता है, तो इस वैल्यू तक पहुंचने के बाद, क्लाइंट हर 64 सेकंड में फिर से कोशिश कर सकता है. किसी समय, क्लाइंट को हमेशा के लिए फिर से कोशिश करने से रोका जाना चाहिए.

फिर से कोशिश करने के बीच इंतज़ार करने का समय और फिर से कोशिश करने की संख्या, आपके इस्तेमाल के उदाहरण और नेटवर्क की स्थितियों पर निर्भर करती है.

हर प्रोजेक्ट के लिए कोटा बढ़ाने का अनुरोध करना

प्रोजेक्ट में संसाधनों के इस्तेमाल के आधार पर, कोटा में बदलाव करने का अनुरोध किया जा सकता है. सेवा खाते से किए गए एपीआई कॉल को एक ही खाते से किया गया कॉल माना जाता है. बढ़े हुए कोटा के लिए आवेदन करने का मतलब यह नहीं है कि आपको मंज़ूरी मिल ही जाएगी. कोटा में बदलाव करने के ऐसे अनुरोधों को मंज़ूरी मिलने में ज़्यादा समय लग सकता है जिनसे कोटा वैल्यू में काफ़ी बढ़ोतरी होती है.

सभी प्रोजेक्ट के लिए, एक जैसे कोटा उपलब्ध नहीं होते. समय के साथ-साथ Google Cloud का इस्तेमाल बढ़ने पर, आपको कोटा की वैल्यू बढ़ाने की ज़रूरत पड़ सकती है. अगर आपको लगता है कि आने वाले समय में इस्तेमाल में काफ़ी बढ़ोतरी हो सकती है, तो Google Cloud Console में कोटा और सिस्टम की सीमाएं पेज पर जाकर, कोटे में बदलाव करने का अनुरोध किया जा सकता है.

ज़्यादा जानने के लिए, यहां दिए गए संसाधन देखें:

• कोटा में बदलाव करने के बारे में जानकारी
• कोटा के इस्तेमाल और सीमाओं की जानकारी देखना
• कोटा की सीमा बढ़ाने का अनुरोध करना

चैट एमसीपी सर्वर के कोटे

चैट एमसीपी सर्वर, क्वेरी की लागत के हिसाब से बंटवारा करने वाली मेट्रिक का इस्तेमाल करता है. यहां दी गई टेबल में, हर Chat MCP सर्वर के लिए क्वेरी की लागत के बारे में बताया गया है. यह जानकारी, सेक्शन के हिसाब से दी गई है:

Chat MCP के कोटे

दो तरह के कोटे लागू किए जाते हैं:

• हर प्रोजेक्ट के लिए हर मिनट: यह आपके Google Cloud प्रोजेक्ट के लिए, एक मिनट की क्वेरी की लागत है.

• हर उपयोगकर्ता के लिए, हर प्रोजेक्ट के हिसाब से हर मिनट: यह आपके Google Cloud प्रोजेक्ट के लिए, एक मिनट की क्वेरी की लागत है. इसका इस्तेमाल कोई भी उपयोगकर्ता कर सकता है. इस सीमा का मकसद, यह पक्का करने में आपकी मदद करना है कि आपके उपयोगकर्ताओं के बीच, इस सुविधा का इस्तेमाल सही तरीके से हो.

यहां दी गई टेबल में, इन कोटा के बारे में बताया गया है:

इस्तेमाल करने की सीमा का टाइप	क्वेरी की लागत
हर प्रोजेक्ट के लिए हर मिनट	3,000
हर उपयोगकर्ता के लिए, हर प्रोजेक्ट के हिसाब से हर मिनट में किए जा सकने वाले अनुरोधों की संख्या	300

एमसीपी टूलसेट से चैट करना

यहां दी गई टेबल में, हर chatmcp.googleapis.com टूलसेट के लिए क्वेरी की लागत की जानकारी दी गई है:

एंडपॉइंट	टूल	क्वेरी की लागत
/mcp/v1	list_messages	1
	search_conversations	10
	search_messages	10
	send_message	10

ज़्यादा जानकारी के लिए, Chat MCP API का रेफ़रंस देखें.