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

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

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

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

Google Chat में पुष्टि करने और अनुमति देने के मुख्य चरण
पहली इमेज. Google Chat में पुष्टि करने और अनुमति देने के मुख्य चरण.

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

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

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

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

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

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

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

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

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

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

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

चैट ऐप्लिकेशन को तीसरे पक्ष की उपयोगकर्ता इंटरैक्शन, जब तक Chat ऐप्लिकेशन Chat API या कोई अन्य Google API, जबकि कोई जवाब प्रोसेस कर रहा है.

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

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

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

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

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

नीचे दिए गए डायग्राम में, चैट इस्तेमाल करने वाले व्यक्ति और चैट ऐप्लिकेशन:

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

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

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

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

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

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

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

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

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

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

Chat API के दायरे

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

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

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

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

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

चैट ऐप्लिकेशन को चैट देखने और मैसेज भेजने की अनुमति दें. गिव Chat ऐप्लिकेशन की सभी सुविधाओं का ऐक्सेस.

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

दायरा कोड ब्यौरा
https://www.googleapis.com/auth/chat.spaces बातचीत और स्पेस बनाना. साथ ही, मेटाडेटा देखना या उसमें बदलाव करना (इसमें ये शामिल हैं इतिहास की सेटिंग और ऐक्सेस सेटिंग).
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.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 में.

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

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

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

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

Chat ऐप्लिकेशन दो तरीकों से पुष्टि कर सकते हैं और अनुमति दे सकते हैं Chat API: उपयोगकर्ता के क्रेडेंशियल या सेवा खाते.

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

ऐप्लिकेशन की अनुमति से, Chat ऐप्लिकेशन ऐक्सेस करता है सेवा खाते के क्रेडेंशियल का इस्तेमाल करके, एपीआई को ऐप्लिकेशन के तौर पर इस्तेमाल करता है. ऐप्लिकेशन की अनुमति हमेशा chat.bot की अनुमति के दायरे का इस्तेमाल करता है.

यह तय करते समय कि किसी खास एपीआई अनुरोध के लिए, किस तरह के क्रेडेंशियल का इस्तेमाल करना है, ध्यान रखें कि कुछ API प्रक्रियाएं सिर्फ़ एक खास प्रकार के क्रेडेंशियल. अगर एपीआई वाला तरीका दोनों क्रेडेंशियल के साथ काम करता है, तो कॉल में इस्तेमाल करने से, नतीजों पर असर पड़ता है:

  • ऐप्लिकेशन की अनुमति देने पर, ये तरीके सिर्फ़ वही संसाधन दिखाते हैं जो ऐप्लिकेशन ऐक्सेस दें.
  • उपयोगकर्ता की अनुमति मिलने पर, ये तरीके सिर्फ़ ऐसे संसाधन दिखाते हैं जिन्हें उपयोगकर्ता वह Chat के यूज़र इंटरफ़ेस (यूआई) में ऐक्सेस कर सकता है.

उदाहरण के लिए, ऐप्लिकेशन की अनुमति के साथ ListSpaces तरीके को कॉल करने पर, ऐप्लिकेशन जिन स्पेस का सदस्य है उनकी सूची. उपयोगकर्ता को ListSpaces पर कॉल किया जा रहा है अनुमति देने से, उन स्पेस की सूची दिखती है जिनका उपयोगकर्ता सदस्य है. तय सीमा में तो आपका ऐप्लिकेशन आपकी पसंद के फ़ंक्शन के आधार पर Chat API.

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

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

तरीका उपयोगकर्ता की पुष्टि करने की सुविधा काम करती है ऐप्लिकेशन की पुष्टि करने की सुविधा काम करती है अनुमति देने के दायरे इस्तेमाल किए जा सकते हैं
स्पेस  
स्पेस बनाना उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.spaces.create
  • chat.spaces
  • chat.import
स्पेस सेट अप करना उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.spaces.create
  • chat.spaces
स्पेस पाएं उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.spaces.readonly
  • chat.spaces
ऐप्लिकेशन की पुष्टि करने की सुविधा के साथ:
  • chat.bot
एडमिन के खास अधिकारों का इस्तेमाल करके, उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.admin.spaces.readonly
स्पेस की सूची बनाना उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.spaces.readonly
  • chat.spaces
ऐप्लिकेशन की पुष्टि करने की सुविधा के साथ:
  • chat.bot
स्पेस खोजें एडमिन के खास अधिकारों का इस्तेमाल करके, उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.admin.spaces.readonly
स्पेस अपडेट करना उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.spaces
  • chat.import
एडमिन के खास अधिकारों का इस्तेमाल करके, उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.admin.spaces
किसी स्पेस को मिटाना उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.delete
  • chat.import
एडमिन के खास अधिकारों का इस्तेमाल करके, उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.admin.delete
किसी स्पेस के लिए इंपोर्ट की प्रोसेस पूरी करना उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.import
डायरेक्ट मैसेज ढूंढना उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.spaces.readonly
  • chat.spaces
ऐप्लिकेशन की पुष्टि करने की सुविधा के साथ:
  • chat.bot
सदस्य  
सदस्य बनाएं उपयोगकर्ता की पुष्टि करने की सुविधा के साथ:
  • chat.memberships
  • chat.memberships.app
  • chat.import
एडमिन के खास अधिकारों का इस्तेमाल करके, उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.admin.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.memberships
  • chat.import
एडमिन के खास अधिकारों का इस्तेमाल करके, उपयोगकर्ता की पुष्टि करने के लिए:
  • chat.admin.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.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.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 ऐप्लिकेशन के साथ इंटरैक्ट करने के सामान्य तरीकों की जानकारी दी गई है. साथ ही, यह भी बताया गया है कि पुष्टि करने की ज़रूरत है या नहीं:

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