Chat ऐप्लिकेशन और Google Chat API के अनुरोधों की पुष्टि करना और अनुमति देना

पुष्टि करना और अनुमति देना, ऐसे तरीके हैं जिनका इस्तेमाल संसाधनों की ऐक्सेस और पहचान की पुष्टि करने के लिए किया जाता है. इस दस्तावेज़ में बताया गया है कि Chat ऐप्लिकेशन और Chat API के अनुरोधों के लिए, पुष्टि और अनुमति देने की सुविधा कैसे काम करती है.

प्रोसेस के बारे में खास जानकारी

नीचे दिए गए डायग्राम में, Google Chat के लिए पुष्टि करने और अनुमति देने के हाई-लेवल चरण दिखाए गए हैं:

Google Chat की पुष्टि करने और अनुमति देने के लिए, ज़्यादा जानकारी वाला तरीका
पहला डायग्राम. Google Chat में पुष्टि करने और अनुमति देने के मुख्य चरण.

  1. Google Cloud प्रोजेक्ट कॉन्फ़िगर करना, Chat API चालू करना, और Chat ऐप्लिकेशन कॉन्फ़िगर करना: डेवलपमेंट के दौरान, आपको एक Google Cloud प्रोजेक्ट बनाना होता है. Google Cloud प्रोजेक्ट में, Chat API को चालू करें, अपने Chat ऐप्लिकेशन को कॉन्फ़िगर करें, और पुष्टि करने की सुविधा सेट अप करें. ज़्यादा जानकारी के लिए, Google Workspace पर डेवलप करना और चैट ऐप्लिकेशन बनाना देखें.

  2. Call Chat API: जब आपका ऐप्लिकेशन Chat API को कॉल करता है, तो वह Chat API को पुष्टि करने के क्रेडेंशियल भेजता है. अगर आपका ऐप्लिकेशन किसी सेवा खाते से पुष्टि करता है, तो क्रेडेंशियल आपके ऐप्लिकेशन के कोड के हिस्से के तौर पर भेजे जाते हैं. अगर आपके ऐप्लिकेशन को उपयोगकर्ता की पुष्टि करने के लिए, Chat API को कॉल करने की ज़रूरत है और उपयोगकर्ता ने अब तक पुष्टि नहीं की है, तो ऐप्लिकेशन उपयोगकर्ता को साइन इन करने के लिए कहता है.

  3. संसाधनों का अनुरोध करना: आपका ऐप्लिकेशन, पुष्टि करने की सुविधा सेट अप करते समय बताए गए स्कोप के साथ ऐक्सेस का अनुरोध करता है.

  4. सहमति मांगना: अगर आपका ऐप्लिकेशन उपयोगकर्ता के तौर पर पुष्टि कर रहा है, तो Google एक OAuth सहमति स्क्रीन दिखाता है, ताकि उपयोगकर्ता यह तय कर सके कि आपके ऐप्लिकेशन को अनुरोध किए गए डेटा का ऐक्सेस दिया जाए या नहीं. सेवा खाते से पुष्टि करने के लिए, उपयोगकर्ता की सहमति की ज़रूरत नहीं होती.

  5. रिसॉर्स के लिए मंज़ूरी वाला अनुरोध भेजना: अगर उपयोगकर्ता अनुमति के दायरों के लिए सहमति देता है, तो आपका ऐप्लिकेशन क्रेडेंशियल और उपयोगकर्ता की अनुमति वाले दायरों को एक अनुरोध में बंडल करता है. ऐक्सेस टोकन पाने के लिए, Google के ऑथराइज़ेशन सर्वर को अनुरोध भेजा जाता है.

  6. Google, ऐक्सेस टोकन दिखाता है: ऐक्सेस टोकन में, ऐक्सेस के लिए दिए गए स्कोप की सूची होती है. अगर ऐक्सेस के लिए मांगे गए स्कोप के मुकाबले, ऐक्सेस के लिए मिली सूची में ज़्यादा पाबंदियां हैं, तो आपका ऐप्लिकेशन टोकन से सीमित की गई सभी सुविधाओं को बंद कर देता है.

  7. अनुरोध किए गए संसाधनों को ऐक्सेस करना: आपका ऐप्लिकेशन, Chat API को शुरू करने और Chat API के संसाधनों को ऐक्सेस करने के लिए, Google के ऐक्सेस टोकन का इस्तेमाल करता है.

  8. रिफ़्रेश टोकन पाना (ज़रूरी नहीं): अगर आपके ऐप्लिकेशन को किसी एक ऐक्सेस टोकन के लाइफ़टाइम के बाद भी Google Chat API को ऐक्सेस करना है, तो वह रिफ़्रेश टोकन पा सकता है. ज़्यादा जानकारी के लिए, Google API को ऐक्सेस करने के लिए, OAuth 2.0 का इस्तेमाल करना लेख पढ़ें.

  9. ज़्यादा संसाधनों के लिए अनुरोध करें: अगर आपके ऐप्लिकेशन को ज़्यादा ऐक्सेस की ज़रूरत है, तो यह उपयोगकर्ता से नए दायरे देने के लिए कहता है. इस वजह से, ऐक्सेस टोकन पाने के लिए नया अनुरोध मिलता है (तीसरा से छठा चरण).

चैट ऐप्लिकेशन के लिए पुष्टि करने की ज़रूरत कब पड़ती है

चैट ऐप्लिकेशन, उपयोगकर्ता के इंटरैक्शन के जवाब में या एसिंक्रोनस तरीके से मैसेज भेज सकते हैं. यह एआई, उपयोगकर्ता की ओर से टास्क भी पूरा कर सकता है. जैसे, चैट स्पेस बनाना या चैट स्पेस में मौजूद लोगों की सूची पाना.

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

एसिंक्रोनस मैसेज भेजने या उपयोगकर्ता की ओर से टास्क पूरे करने के लिए, चैट ऐप्लिकेशन Chat API से RESTful अनुरोध करते हैं. इसके लिए, पुष्टि और अनुमति की ज़रूरत होती है.

उपयोगकर्ता के इंटरैक्शन से जुड़े जवाबों के लिए पुष्टि करने की ज़रूरत नहीं है

इंटरैक्शन इवेंट को सिंक करने और उनका जवाब देने के लिए, Google Chat ऐप्लिकेशन को उपयोगकर्ता के तौर पर या Chat ऐप्लिकेशन की पुष्टि करने की ज़रूरत नहीं है.

जब कोई उपयोगकर्ता, Chat ऐप्लिकेशन से इंटरैक्ट करता है या उसे शुरू करता है, तो Google Chat ऐप्लिकेशन को इंटरैक्शन इवेंट मिलते हैं. इनमें ये शामिल हैं:

  • कोई उपयोगकर्ता, Chat ऐप्लिकेशन पर मैसेज भेजता है.
  • कोई उपयोगकर्ता, Chat ऐप्लिकेशन को @टैग करता है.
  • कोई उपयोगकर्ता, Chat ऐप्लिकेशन के किसी स्लैश कमांड का इस्तेमाल करता है.

नीचे दिया गया डायग्राम, चैट इस्तेमाल करने वाले व्यक्ति और Chat ऐप्लिकेशन के बीच अनुरोध का जवाब देने का क्रम दिखाता है:

Chat ऐप्लिकेशन के इंटरैक्शन इवेंट के लिए, अनुमति की ज़रूरत नहीं है
दूसरी इमेज.चैट ऐप्लिकेशन इंटरैक्शन इवेंट के लिए पुष्टि करने की ज़रूरत नहीं होती.

  1. उपयोगकर्ता Google Chat में मौजूद Chat ऐप्लिकेशन पर कोई मैसेज भेजता है.
  2. Google Chat, मैसेज को ऐप्लिकेशन पर फ़ॉरवर्ड कर देता है.
  3. ऐप्लिकेशन को मैसेज मिलता है, वह इसे प्रोसेस करता है, और Google Chat को जवाब देता है.
  4. Google Chat, उपयोगकर्ता के लिए या स्पेस में जवाब रेंडर करता है.

चैट ऐप्लिकेशन के हर इंटरैक्शन इवेंट के लिए यह क्रम दोहराया जाता है.

एसिंक्रोनस मैसेज की पुष्टि करना ज़रूरी है

एसिंक्रोनस मैसेज तब भेजे जाते हैं, जब कोई Chat ऐप्लिकेशन Chat API से अनुरोध करता है. इसके लिए, पुष्टि और अनुमति की ज़रूरत होती है.

Chat API का इस्तेमाल करके, चैट ऐप्लिकेशन Google Chat पर मैसेज पोस्ट कर सकते हैं. इसके अलावा, वे उपयोगकर्ता की ओर से टास्क पूरे कर सकते हैं और उनके डेटा को ऐक्सेस कर सकते हैं. उदाहरण के लिए, सर्वर बंद होने का पता चलने पर Chat ऐप्लिकेशन, Chat API को इन कामों के लिए कॉल कर सकता है:

  • समस्या की जांच करने और उसे ठीक करने के लिए एक चैट स्पेस बनाएं.
  • Chat स्पेस में लोगों को जोड़ें.
  • रुकावट के बारे में जानकारी देने के लिए, चैट स्पेस में कोई मैसेज पोस्ट करें.

नीचे दिए गए डायग्राम में, Chat ऐप्लिकेशन और Chat स्पेस के बीच मैसेज के सिंक न होने का क्रम दिखाया गया है:

एसिंक्रोनस मैसेज के लिए पुष्टि करना ज़रूरी है
तीसरी इमेज. एसिंक्रोनस मैसेज के लिए पुष्टि करना ज़रूरी है.

  1. कोई Chat ऐप्लिकेशन, spaces.messages.create तरीके का इस्तेमाल करके Chat API को कॉल करके मैसेज बनाता है और एचटीटीपी अनुरोध में उपयोगकर्ता के क्रेडेंशियल को शामिल करता है.
  2. Google Chat, सेवा खाते या उपयोगकर्ता के क्रेडेंशियल की मदद से, Chat ऐप्लिकेशन की पुष्टि करता है.
  3. Google Chat, ऐप्लिकेशन के मैसेज को तय किए गए चैट स्पेस में रेंडर करता है.

Chat API के दायरे

OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें और दायरे चुनें, ताकि यह तय किया जा सके कि उपयोगकर्ताओं और ऐप्लिकेशन की समीक्षा करने वाले लोगों को कौनसी जानकारी दिखे. साथ ही, अपने ऐप्लिकेशन को रजिस्टर करें, ताकि आप उसे बाद में पब्लिश कर सकें.

अपने ऐप्लिकेशन को दिए गए ऐक्सेस लेवल के बारे में बताने के लिए, आपको अनुमति के दायरे की पहचान करनी होगी और उनके बारे में बताना होगा. अनुमति देने का स्कोप एक OAuth 2.0 यूआरआई स्ट्रिंग होती है. इसमें Google Workspace ऐप्लिकेशन का नाम, यह किस तरह का डेटा ऐक्सेस करता है, और ऐक्सेस का लेवल शामिल होता है.

गैर-संवेदनशील स्कोप

दायरा कोड ब्यौरा
https://www.googleapis.com/auth/chat.bot

इससे Chat ऐप्लिकेशन, चैट देख सकते हैं और मैसेज भेज सकते हैं.

यह स्कोप, सिर्फ़ सेवा खातों की मदद से ऐप्लिकेशन की पुष्टि करने की सुविधा देता है. इस दायरे का इस्तेमाल करके, उपयोगकर्ता के क्रेडेंशियल या डोमेन के लिए एजेंट की मदद से पुष्टि नहीं की जा सकती.

संवेदनशील दायरे

दायरा कोड ब्यौरा
https://www.googleapis.com/auth/chat.spaces Chat में बातचीत शुरू करना और स्पेस बनाना. साथ ही, Chat में मेटाडेटा देखना या उसमें बदलाव करना. इसमें इतिहास सेव करने और ऐक्सेस करने की सेटिंग शामिल हैं.
https://www.googleapis.com/auth/chat.spaces.create Chat में नई बातचीत शुरू करें.
https://www.googleapis.com/auth/chat.spaces.readonly Chat में चैट और स्पेस देखना.
https://www.googleapis.com/auth/chat.memberships Chat में होने वाली बातचीत में सदस्यों को देखना, जोड़ना, और हटाना.
https://www.googleapis.com/auth/chat.memberships.app Google Chat में होने वाली बातचीत में खुद को जोड़ना और हटाना.
https://www.googleapis.com/auth/chat.memberships.readonly Chat पर होने वाली बातचीत में, सदस्यों को देखना.
https://www.googleapis.com/auth/chat.messages.create Chat में मैसेज लिखना और भेजना.
https://www.googleapis.com/auth/chat.messages.reactions Chat में मैसेज पर प्रतिक्रियाएं जोड़ना, देखना, और मिटाना.
https://www.googleapis.com/auth/chat.messages.reactions.create Chat में किसी मैसेज में प्रतिक्रियाएं जोड़ना.
https://www.googleapis.com/auth/chat.messages.reactions.readonly Chat में किसी मैसेज पर मिली प्रतिक्रियाएं देखना.
https://www.googleapis.com/auth/chat.users.readstate Chat में की गई किसी भी बातचीत को पिछली बार पढ़े जाने का समय देखना और उसमें बदलाव करना.
https://www.googleapis.com/auth/chat.users.readstate.readonly Chat में की गई बातचीत को पिछली बार पढ़े जाने का समय देखना.
https://www.googleapis.com/auth/chat.admin.spaces.readonly Chat में, एडमिन के डोमेन के मालिकाना हक वाली चैट और स्पेस देखना.
https://www.googleapis.com/auth/chat.admin.spaces Chat में एडमिन के डोमेन के मालिकाना हक वाली चैट और स्पेस देखें या उनमें बदलाव करें.
https://www.googleapis.com/auth/chat.admin.memberships.readonly Chat में एडमिन के डोमेन के मालिकाना हक वाली बातचीत में सदस्यों और मैनेजर को देखें.
https://www.googleapis.com/auth/chat.admin.memberships Chat में, एडमिन के डोमेन की बातचीत में सदस्यों और मैनेजर की जानकारी देखना, उन्हें जोड़ना, हटाना, और भूमिकाएं अपडेट करना.
https://www.googleapis.com/auth/chat.app.spaces

बातचीत और स्पेसेज़ बनाएं. साथ ही, Chat में मेटाडेटा (इसमें इतिहास की सेटिंग और ऐक्सेस सेटिंग शामिल हैं) देखें या अपडेट करें. इसके लिए, एडमिन की अनुमति ज़रूरी है.

यह दायरा सिर्फ़ सेवा खातों के साथ ऐप्लिकेशन की पुष्टि करने की सुविधा देता है. आप इस दायरे का इस्तेमाल करके, उपयोगकर्ता क्रेडेंशियल या पूरे डोमेन के लोगों को डेटा का ऐक्सेस दें से पुष्टि नहीं कर सकते.
https://www.googleapis.com/auth/chat.app.spaces.create

Chat में नई बातचीत शुरू करना और स्पेस बनाना. इसके लिए, एडमिन की अनुमति लेनी होगी.

यह दायरा सिर्फ़ सेवा खातों के साथ ऐप्लिकेशन की पुष्टि करने की सुविधा देता है. आप इस दायरे का इस्तेमाल करके, उपयोगकर्ता क्रेडेंशियल या पूरे डोमेन के लोगों को डेटा का ऐक्सेस दें से पुष्टि नहीं कर सकते.
https://www.googleapis.com/auth/chat.app.memberships

Chat में मौजूद बातचीत और स्पेस में मौजूद सदस्यों की जानकारी देखना, उन्हें जोड़ना, हटाना, और उनकी भूमिकाएं अपडेट करना. इसके लिए, एडमिन की अनुमति लेनी होगी.

यह दायरा सिर्फ़ सेवा खातों के साथ ऐप्लिकेशन की पुष्टि करने की सुविधा देता है. आप इस दायरे का इस्तेमाल करके, उपयोगकर्ता क्रेडेंशियल या पूरे डोमेन के लोगों को डेटा का ऐक्सेस दें से पुष्टि नहीं कर सकते.
https://www.googleapis.com/auth/chat.customemojis Chat में पसंद के मुताबिक इमोजी बनाना, देखना, और मिटाना.
https://www.googleapis.com/auth/chat.customemojis.readonly Chat में पसंद के मुताबिक बनाया गया इमोजी देखें.
https://www.googleapis.com/auth/chat.users.spacesettings Chat में उपयोगकर्ता के स्पेस की सेटिंग देखें और उन्हें अपडेट करें.

स्पेस के उपयोगकर्ता की सेटिंग के एपीआई देखें: getSpaceNotificationSetting, updateSpaceNotificationSetting

सीमित दायरे

दायरा कोड ब्यौरा
https://www.googleapis.com/auth/chat.delete Chat में हुई बातचीत और स्पेस मिटाना. साथ ही, उनसे जुड़ी फ़ाइलों का ऐक्सेस हटाना.
https://www.googleapis.com/auth/chat.import स्पेसेज़, मैसेज, और पैसे चुकाकर ली जाने वाली सदस्यताओं को Chat में इंपोर्ट करना. ज़्यादा जानकारी के लिए, Chat ऐप्लिकेशन को डेटा इंपोर्ट करने की अनुमति देना देखें
https://www.googleapis.com/auth/chat.messages मैसेज देखना, लिखना, भेजना, अपडेट करना, और मिटाना. इसके अलावा, मैसेज में प्रतिक्रियाएं जोड़ना, देखना, और मिटाना.
https://www.googleapis.com/auth/chat.messages.readonly Chat में मैसेज और प्रतिक्रियाएं देखें.
https://www.googleapis.com/auth/chat.admin.delete एडमिन के डोमेन के स्पेस और बातचीत को मिटाएं. साथ ही, Chat में, उन स्पेस और बातचीत से जुड़ी फ़ाइलों का ऐक्सेस हटाएं.
https://www.googleapis.com/auth/chat.app.delete

Chat में, बातचीत और स्पेस मिटाने के साथ-साथ, उनसे जुड़ी फ़ाइलों का ऐक्सेस हटाएं. इसके लिए, एडमिन की अनुमति लेनी होगी.

यह दायरा सिर्फ़ सेवा खातों के साथ ऐप्लिकेशन की पुष्टि करने की सुविधा देता है. आप इस दायरे का इस्तेमाल करके, उपयोगकर्ता क्रेडेंशियल या पूरे डोमेन के लोगों को डेटा का ऐक्सेस दें से पुष्टि नहीं कर सकते.

यहां दी गई परिभाषाओं के मुताबिक, पिछली टेबल में दिए गए स्कोप उनकी संवेदनशीलता के बारे में बताते हैं:

अगर आपके ऐप्लिकेशन को किसी अन्य Google API का ऐक्सेस चाहिए, तो उन स्कोप को भी जोड़ा जा सकता है. Google API के दायरों के बारे में ज़्यादा जानकारी पाने के लिए, Google API को ऐक्सेस करने के लिए, OAuth 2.0 का इस्तेमाल करना लेख पढ़ें.

Google Workspace के एपीआई के स्कोप के बारे में ज़्यादा जानने के लिए, OAuth की सहमति वाली स्क्रीन कॉन्फ़िगर करना और स्कोप चुनना लेख पढ़ें.

पुष्टि करने के ज़रूरी तरीके

Chat ऐप्लिकेशन, Chat API की मदद से पुष्टि करने और अनुमति देने के लिए, इन दो तरीकों का इस्तेमाल कर सकते हैं:

उपयोगकर्ता की पुष्टि करना
उपयोगकर्ता की पुष्टि की मदद से, Chat ऐप्लिकेशन उपयोगकर्ता का डेटा ऐक्सेस कर सकता है और उसकी ओर से कार्रवाइयां कर सकता है. OAuth के दायरे, अनुमति वाले डेटा और कार्रवाइयों के बारे में बताते हैं. अगर Chat ऐप्लिकेशन को एडमिन इंस्टॉल नहीं किया गया या पूरे डोमेन के लोगों को डेटा का ऐक्सेस नहीं दिया गया है, तो उपयोगकर्ता को OAuth की सहमति वाली स्क्रीन का इस्तेमाल करके, पहली बार Chat ऐप्लिकेशन को अनुमति देनी होगी.
ऐप्लिकेशन की पुष्टि करना

ऐप्लिकेशन की पुष्टि करने की सुविधा से, Chat ऐप्लिकेशन को सेवा खाते के क्रेडेंशियल का इस्तेमाल करने के साथ-साथ, डेटा को ऐक्सेस करने और कार्रवाइयां करने की सुविधा मिलती है. Chat ऐप्लिकेशन, संसाधनों को ऐक्सेस करने और उनके साथ काम करने के लिए, अपने क्रेडेंशियल का इस्तेमाल करता है. इसलिए, असली उपयोगकर्ताओं को Chat ऐप्लिकेशन के एपीआई कॉल स्वीकार करने की ज़रूरत नहीं है. साथ ही, OAuth के लिए सहमति वाली स्क्रीन पर, OAuth के इस्तेमाल की अनुमति देने के दायरे नहीं जोड़े जा सकते.

ऐप्लिकेशन की पुष्टि करने के लिए, OAuth अनुमति के दो टाइप के स्कोप काम करते हैं:

  • https://www.googleapis.com/auth/chat.bot: आपका Chat ऐप्लिकेशन, अनुमति देने के इस दायरे के साथ काम करने वाले Google Chat API को कॉल कर सकता है. इन तरीकों से, संसाधन बनाए जा सकते हैं, उन्हें अपडेट किया जा सकता है, और उनकी सूची बनाई जा सकती है. इसके अलावा, उन संसाधनों को मिटाया जा सकता है जिनका ऐक्सेस उसके पास है. जैसे, उन स्पेस में मौजूद मैसेज जिनमें असली उपयोगकर्ता आपका Chat ऐप्लिकेशन जोड़ते हैं. आपका Chat ऐप्लिकेशन खुद ही यह अनुमति दे सकता है. इसके लिए, एडमिन या असली उपयोगकर्ता की अनुमति की ज़रूरत नहीं है.
  • https://www.googleapis.com/auth/chat.app.* (डेवलपर की झलक): इन स्कोप का इस्तेमाल करने के लिए, एक बार एडमिन से अनुमति लेनी होगी. एडमिन की अनुमति पाने के लिए, आपको Chat ऐप्लिकेशन के सेवा खाते को एडमिन की अनुमति पाने के लिए तैयार करना होगा. इसके लिए, आपको Google Workspace Marketplace के साथ काम करने वाला OAuth क्लाइंट बनाना होगा और Google Workspace Marketplace SDK में ऐप्लिकेशन को कॉन्फ़िगर करना होगा. इन दायरों की मदद से, आपके Chat ऐप्लिकेशन को Google Chat API के कुछ खास तरीकों से कॉल करने की अनुमति मिलती है. उदाहरण के लिए, chat.app.spaces.create ऐप्लिकेशन को Chat में स्पेसेज़ बनाने की अनुमति देता है.

अगर किसी तरीके में उपयोगकर्ता या ऐप्लिकेशन, दोनों की पुष्टि करने की सुविधा काम करती है, तो Chat API, पुष्टि करने के उस तरीके के आधार पर अलग-अलग नतीजे दिखाता है जिसका आपने इस्तेमाल किया है:

  • ऐप्लिकेशन की पुष्टि करने पर, ये तरीके सिर्फ़ ऐसे संसाधन दिखाते हैं जिन्हें Chat ऐप्लिकेशन ऐक्सेस कर सकता हो.
  • उपयोगकर्ता की पुष्टि करने पर, ये तरीके सिर्फ़ ऐसे संसाधन दिखाते हैं जिन्हें उपयोगकर्ता ऐक्सेस कर सकता है.

उदाहरण के लिए, ऐप्लिकेशन को अनुमति देने के साथ spaces.list() तरीके को कॉल करने पर, उन स्पेस की सूची दिखती है जिनका Chat ऐप्लिकेशन सदस्य है. उपयोगकर्ता की अनुमति के साथ spaces.list() को कॉल करने पर, उन स्पेस की सूची दिखती है जिनमें उपयोगकर्ता सदस्य है. Chat API को कॉल करते समय, आपके पास दो तरह की पुष्टि करने की सुविधा इस्तेमाल करने का विकल्प होता है. यह इस बात पर निर्भर करता है कि आपके Chat ऐप्लिकेशन का डिज़ाइन और सुविधाएं क्या हैं.

एसिंक्रोनस Chat API कॉल के लिए

नीचे दी गई टेबल में Chat API के तरीके और उनके साथ काम करने वाले अनुमति के दायरे की सूची दी गई है:

तरीका उपयोगकर्ता की पुष्टि की सुविधा काम करती है ऐप्लिकेशन की पुष्टि करने की सुविधा काम करती हो अनुमति के दायरे
स्पेस  
स्पेस बनाना उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.spaces.create
  • chat.spaces
  • chat.import
ऐप्लिकेशन की पुष्टि करने और एडमिन की अनुमति के साथ (डेवलपर झलक में उपलब्ध):
  • chat.app.spaces.create
  • chat.app.spaces
स्पेस सेट अप करना — उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.spaces.create
  • chat.spaces
स्पेस बनाना उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.spaces.readonly
  • chat.spaces
एडमिन के खास अधिकारों का इस्तेमाल करके, उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.admin.spaces.readonly
ऐप्लिकेशन की पुष्टि करने की सुविधा के साथ:
  • chat.bot
ऐप्लिकेशन की पुष्टि करने और एडमिन की अनुमति के साथ (डेवलपर झलक में उपलब्ध):
  • chat.app.spaces
स्पेस की सूची बनाना उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.spaces.readonly
  • chat.spaces
ऐप्लिकेशन की पुष्टि करने के लिए:
  • chat.bot
स्पेस खोजना — एडमिन के अधिकारों का इस्तेमाल करके, उपयोगकर्ता की पुष्टि करने की सुविधा:
  • chat.admin.spaces.readonly
स्पेस अपडेट करना उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.spaces
  • chat.import
एडमिन के विशेषाधिकारों का इस्तेमाल करके, उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.admin.spaces
ऐप्लिकेशन की पुष्टि करने और एडमिन की अनुमति के साथ (डेवलपर झलक में उपलब्ध):
  • chat.app.spaces
किसी स्पेस को मिटाना उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.delete
  • chat.import
एडमिन के खास अधिकारों का इस्तेमाल करके, उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.admin.delete
ऐप्लिकेशन की पुष्टि और एडमिन की अनुमति (डेवलपर की झलक में उपलब्ध है) के साथ:
  • chat.app.delete
किसी स्पेस के लिए इंपोर्ट की प्रोसेस पूरी करना — उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.import
डायरेक्ट मैसेज ढूंढना उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.spaces.readonly
  • chat.spaces
ऐप्लिकेशन की पुष्टि करने के लिए:
  • chat.bot
सदस्य  
सदस्य बनाएं उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.memberships
  • chat.memberships.app
  • chat.import
एडमिन के अधिकारों का इस्तेमाल करके, उपयोगकर्ता की पहचान की पुष्टि करने की सुविधा के साथ:
  • chat.admin.memberships
ऐप्लिकेशन की पुष्टि और एडमिन की अनुमति (डेवलपर की झलक में उपलब्ध है) के साथ:
  • chat.app.memberships
सदस्य बनाएं उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.memberships.readonly
  • chat.memberships
ऐप्लिकेशन की पुष्टि करने की सुविधा के साथ:
  • chat.bot
एडमिन के अधिकारों का इस्तेमाल करके, उपयोगकर्ता की पहचान की पुष्टि करने की सुविधा के साथ:
  • chat.admin.memberships.readonly
सदस्यों की सूची उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.memberships.readonly
  • chat.memberships
  • chat.import
ऐप्लिकेशन की पुष्टि करने की सुविधा के साथ:
  • chat.bot
एडमिन के खास अधिकारों का इस्तेमाल करके, उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.admin.memberships.readonly
किसी सदस्य को मिटाना उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.memberships
  • chat.memberships.app
  • chat.import
एडमिन के अधिकारों का इस्तेमाल करके, उपयोगकर्ता की पहचान की पुष्टि करने के लिए:
  • chat.admin.memberships
ऐप्लिकेशन की पुष्टि और एडमिन की अनुमति (डेवलपर की झलक में उपलब्ध है) के साथ:
  • chat.app.memberships
किसी सदस्य की जानकारी अपडेट करना उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.memberships
  • chat.import
एडमिन के खास अधिकारों का इस्तेमाल करके, उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.admin.memberships
ऐप्लिकेशन की पुष्टि और एडमिन की अनुमति (डेवलपर की झलक में उपलब्ध है) के साथ:
  • chat.app.memberships
मैसेज  
मैसेज बनाना उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.messages.create
  • chat.messages
  • chat.import
ऐप्लिकेशन की पुष्टि करने के लिए:
  • chat.bot
मैसेज पाना उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.messages.readonly
  • chat.messages
ऐप्लिकेशन की पुष्टि करने के लिए:
  • chat.bot
मैसेज की सूची बनाना — उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.messages.readonly
  • chat.messages
  • chat.import
मैसेज अपडेट करना उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.messages
  • chat.import
ऐप्लिकेशन की पुष्टि करने की सुविधा के साथ:
  • chat.bot
मैसेज मिटाना उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.messages
  • chat.import
ऐप्लिकेशन की पुष्टि करने के लिए:
  • chat.bot
प्रतिक्रियाएं  
कोई प्रतिक्रिया देना — उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.messages.reactions.create
  • chat.messages.reactions
  • chat.messages
  • chat.import
टिप्पणियों की सूची बनाना — उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.messages.reactions.readonly
  • chat.messages.reactions
  • chat.messages.readonly
  • chat.messages
प्रतिक्रिया मिटाना — उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.messages.reactions
  • chat.messages
  • chat.import
पसंद के मुताबिक इमोजी  
पसंद के मुताबिक इमोजी बनाना — उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.customemojis
पसंद के मुताबिक बनाए गए इमोजी को मिटाना — उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.customemojis
पसंद के मुताबिक इमोजी पाएं — उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.customemojis
  • chat.customemojis.readonly
पसंद के मुताबिक बनाए गए इमोजी की सूची बनाना — उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.customemojis
  • chat.customemojis.readonly
मीडिया और अटैचमेंट  
मीडिया को फ़ाइल अटैचमेंट के तौर पर अपलोड करना — उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.messages.create
  • chat.messages
  • chat.import
मीडिया डाउनलोड करें उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.messages.readonly
  • chat.messages
ऐप्लिकेशन की पुष्टि करने की सुविधा के साथ:
  • chat.bot
मैसेज अटैचमेंट पाएं — ऐप्लिकेशन की पुष्टि करने की सुविधा के साथ:
  • chat.bot
उपयोगकर्ता के पढ़ने की स्थितियां
किसी उपयोगकर्ता के स्पेस में मौजूद फ़ाइलों को पढ़े जाने की स्थिति देखना — उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.users.readstate
  • chat.users.readstate.readonly
स्पेस में मौजूद किसी फ़ाइल को पढ़ने की स्थिति अपडेट करना — उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.users.readstate
किसी उपयोगकर्ता के थ्रेड को पढ़ने की स्थिति जानना — उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.users.readstate
  • chat.users.readstate.readonly
स्पेस में उपयोगकर्ता की सेटिंग
किसी उपयोगकर्ता के स्पेस की सूचना सेटिंग की जानकारी पाना — उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.users.spacesettings
किसी उपयोगकर्ता के स्पेस की सूचना सेटिंग अपडेट करना — उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.users.spacesettings
अंतरिक्ष इवेंट
स्पेस में होने वाले इवेंट की जानकारी पाना — उपयोगकर्ता की पुष्टि करने की सुविधा के साथ, आपको इवेंट टाइप के आधार पर स्कोप का इस्तेमाल करना होगा:
  • मैसेज से जुड़े इवेंट के लिए:
    • chat.messages
    • chat.messages.readonly
  • प्रतिक्रियाओं से जुड़े इवेंट के लिए:
    • chat.messages.reactions
    • chat.messages.reactions.readonly
    • chat.messages
    • chat.messages.readonly
  • पैसे चुकाकर ली जाने वाली सदस्यताओं के बारे में इवेंट के लिए:
    • chat.memberships
    • chat.memberships.readonly
  • स्पेस के बारे में इवेंट के लिए:
    • chat.spaces
    • chat.spaces.readonly
स्पेस में होने वाले इवेंट की सूची देखना — उपयोगकर्ता की पुष्टि करने की सुविधा के साथ, आपको अनुरोध में शामिल हर इवेंट टाइप के लिए एक स्कोप का इस्तेमाल करना होगा:
  • मैसेज से जुड़े इवेंट के लिए:
    • chat.messages
    • chat.messages.readonly
  • प्रतिक्रियाओं से जुड़े इवेंट के लिए:
    • chat.messages.reactions
    • chat.messages.reactions.readonly
    • chat.messages
    • chat.messages.readonly
  • पैसे चुकाकर ली जाने वाली सदस्यताओं के बारे में इवेंट के लिए:
    • chat.memberships
    • chat.memberships.readonly
  • स्पेस से जुड़े इवेंट के लिए:
    • chat.spaces
    • chat.spaces.readonly

Chat ऐप्लिकेशन के इंटरैक्शन इवेंट के लिए

नीचे दी गई टेबल में, उपयोगकर्ताओं के चैट ऐप्लिकेशन इस्तेमाल करने के सामान्य तरीक़ों की जानकारी दी गई है. साथ ही, यह भी बताया गया है कि पुष्टि करने की ज़रूरत है या नहीं:

स्थिति पुष्टि करने की ज़रूरत नहीं है उपयोगकर्ता की पुष्टि करने की सुविधा काम करती है ऐप्लिकेशन की पुष्टि करने की सुविधा काम करती हो
इनसे मैसेज पाएं:
Chat ऐप्लिकेशन के इंटरैक्शन इवेंट — —
Apps Script कॉलबैक — —
Google Cloud Pub/Sub — —
मैसेज का जवाब देना:
साथ ही, Chat ऐप्लिकेशन के साथ हुए इंटरैक्शन का इवेंट इस्तेमाल करके — —
Apps Script के कॉलबैक की रिटर्न वैल्यू का इस्तेमाल करके, सिंक्रोनस तरीके से — —
नए मैसेज भेजें:
इनकमिंग वेबहुक की मदद से — —