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

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

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

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

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

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

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

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

Chat API के तरीके

सीमा (हर 60 सेकंड में)

हर मिनट लिखे जाने वाले मैसेज

spaces.messages.create

spaces.messages.patch

spaces.messages.delete

3000

हर मिनट पढ़े गए मैसेज

spaces.messages.get

spaces.messages.list

3000

हर मिनट मैसेज खोजने की सीमा

spaces.messages.search

300

पैसे चुकाकर ली जाने वाली सदस्यता के लिए, हर मिनट में की जाने वाली राइट रिक्वेस्ट

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

spaces.search

3000

स्पेस खोजने के लिए, हर मिनट की जाने वाली रीड रिक्वेस्ट (एडमिन के अधिकारों के बिना)

spaces.search

300

हर मिनट अटैचमेंट लिखने की संख्या

media.upload

600

हर मिनट अटैचमेंट पढ़ने की संख्या

spaces.messages.attachments.get

media.download

3000

हर मिनट प्रतिक्रियाएं लिखने की संख्या

spaces.messages.reactions.create

spaces.messages.reactions.delete

600

हर मिनट में पढ़ी गई प्रतिक्रियाएं

spaces.messages.reactions.list

3000

हर मिनट कस्टम इमोजी लिखने की सीमा

customEmojis.create

customEmojis.delete

600

हर मिनट में कस्टम इमोजी पढ़ने की संख्या

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

हर मिनट में रीड स्टेट के लिए किए गए राइट ऑपरेशन

users.spaces.updateSpaceReadState

users.spaces.threads.updateThreadReadState

3000

हर मिनट में पढ़े गए शब्दों की संख्या

users.spaces.getSpaceReadState

users.spaces.threads.getThreadReadState

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

हर सेकंड कस्टम इमोजी पढ़ने की संख्या

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 में 1 की बढ़ोतरी की जाती है.
  • random_number_milliseconds, मिलीसेकंड की कोई भी संख्या है. यह संख्या 1,000 से कम या इसके बराबर होती है. इससे उन मामलों से बचने में मदद मिलती है जिनमें कई क्लाइंट किसी स्थिति की वजह से सिंक हो जाते हैं और सभी एक साथ फिर से कोशिश करते हैं. इससे सिंक की गई वेव में अनुरोध भेजे जाते हैं. फिर से कोशिश करने के हर अनुरोध के बाद, random_number_milliseconds की वैल्यू का फिर से हिसाब लगाया जाता है.
  • maximum_backoff आम तौर पर 32 या 64 सेकंड का होता है. सही वैल्यू, इस्तेमाल के उदाहरण पर निर्भर करती है.

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

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

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

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

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

ज़्यादा जानने के लिए, ये लेख पढ़ें:

Chat के एमसीपी सर्वर के कोटा

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

चैट एमसीपी कोटा

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

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

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

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

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

Chat के एमसीपी टूलसेट के कोटा

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

एंडपॉइंट

टूल

क्वेरी की लागत

/mcp/v1

list_messages

1

search_conversations

10

search_messages

10

send_message

10

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