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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. Chat ऐप्लिकेशन, spaces.messages.create तरीके का इस्तेमाल करके, Chat API को कॉल करके मैसेज बनाता है. इसमें, एचटीटीपी अनुरोध में उपयोगकर्ता के क्रेडेंशियल भी शामिल होते हैं.
  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 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.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 में मैसेज और प्रतिक्रियाएं देखें.

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

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

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

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

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

उपयोगकर्ता के क्रेडेंशियल की अनुमति मिलने पर, Chat ऐप्लिकेशन उपयोगकर्ता का डेटा ऐक्सेस कर सकता है. साथ ही, उसकी तरफ़ से कार्रवाइयां भी कर सकता है. OAuth के स्कोप, अनुमति वाले डेटा और कार्रवाइयों के बारे में बताते हैं. हालांकि, इन चैट ऐप्लिकेशन को सार्वजनिक तौर पर पब्लिश नहीं किया जा सकता. ज़्यादा जानकारी के लिए, Google Chat ऐप्लिकेशन पब्लिश करना लेख पढ़ें.

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

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

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

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

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

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