पुष्टि और अनुमति देने की सुविधा, पहचान की पुष्टि करने और संसाधनों को ऐक्सेस करने के लिए इस्तेमाल की जाती है. इस दस्तावेज़ में बताया गया है कि पुष्टि करने और Chat ऐप्लिकेशन और Chat API के अनुरोधों के लिए अनुमति देने की प्रक्रिया.
प्रोसेस की खास जानकारी
नीचे दिए गए डायग्राम में, Google Chat के लिए पुष्टि करने और अनुमति देने के हाई-लेवल चरण दिखाए गए हैं:
Google Cloud प्रोजेक्ट को कॉन्फ़िगर करें, Chat API चालू करें, और अपने चैट ऐप्लिकेशन: डेवलपमेंट के दौरान, Google Cloud प्रोजेक्ट. Google Cloud प्रोजेक्ट में, Chat API चालू किया जाता है. अपना Chat ऐप्लिकेशन कॉन्फ़िगर करें और पुष्टि करने की सुविधा सेट अप करें. ज़्यादा जानकारी के लिए, Google Workspace पर डेवलप करना और Chat ऐप्लिकेशन बनाना लेख पढ़ें.
Chat API को कॉल करना: जब आपका ऐप्लिकेशन Chat API को कॉल करता है, तो वह पुष्टि करने के क्रेडेंशियल, Chat API को भेजता है. अगर आपका ऐप्लिकेशन किसी सेवा खाते की मदद से पुष्टि करता है, तो क्रेडेंशियल आपके ऐप्लिकेशन के कोड के हिस्से के तौर पर भेजे जाते हैं. अगर आपके ऐप्लिकेशन को उपयोगकर्ता की पुष्टि करने के लिए, Chat API को कॉल करने की ज़रूरत है और उपयोगकर्ता ने अब तक पुष्टि नहीं की है, तो ऐप्लिकेशन उपयोगकर्ता को साइन इन करने के लिए कहता है.
संसाधनों का अनुरोध करना: आपका ऐप्लिकेशन, पुष्टि करने की सुविधा सेट अप करते समय बताए गए स्कोप के साथ ऐक्सेस का अनुरोध करता है.
सहमति मांगना: अगर आपका ऐप्लिकेशन उपयोगकर्ता के तौर पर पुष्टि कर रहा है, तो Google एक OAuth सहमति स्क्रीन दिखाता है, ताकि उपयोगकर्ता यह तय कर सके कि आपके ऐप्लिकेशन को अनुरोध किए गए डेटा का ऐक्सेस दिया जाए या नहीं. सेवा खाते से पुष्टि करने के लिए, उपयोगकर्ता की सहमति की ज़रूरत नहीं होती.
संसाधनों के लिए स्वीकार किया गया अनुरोध भेजें: अगर उपयोगकर्ता, अनुमति देने के दायरे, आपके ऐप्लिकेशन में क्रेडेंशियल और उपयोगकर्ता की मंज़ूरी वाले बंडल शामिल होते हैं किसी अनुरोध में शामिल करता है. ऐक्सेस टोकन पाने के लिए, अनुरोध Google के ऑथराइज़ेशन सर्वर को भेजा जाता है.
Google, ऐक्सेस टोकन दिखाता है: ऐक्सेस टोकन में, ऐक्सेस के लिए दिए गए स्कोप की सूची होती है. यदि दायरों की दिखाई गई सूची अनुरोध किए गए दायरों पर टैप करने पर, आपका ऐप्लिकेशन उन सभी सुविधाओं को बंद कर देता है जो टोकन की वजह से सीमित होती हैं.
अनुरोध किए गए संसाधनों को ऐक्सेस करना: आपका ऐप्लिकेशन इन कामों के लिए Google से मिले ऐक्सेस टोकन का इस्तेमाल करता है Chat API शुरू करेंगे और Chat API के संसाधनों को ऐक्सेस करेंगे.
रिफ़्रेश टोकन पाना (ज़रूरी नहीं): अगर आपके ऐप्लिकेशन को किसी एक ऐक्सेस टोकन के लाइफ़टाइम के बाद भी Google Chat API को ऐक्सेस करना है, तो वह रिफ़्रेश टोकन पा सकता है. ज़्यादा जानकारी के लिए, Google API को ऐक्सेस करने के लिए OAuth 2.0 का इस्तेमाल करना लेख पढ़ें.
ज़्यादा संसाधनों का अनुरोध करना: अगर आपके ऐप्लिकेशन को और ज़्यादा ऐक्सेस की ज़रूरत है, तो वह उपयोगकर्ता से पूछता है नए स्कोप शामिल किए गए हैं, जिससे ऐक्सेस टोकन पाने के लिए नया अनुरोध मिलता है (चरण 3-6).
जब Chat ऐप्लिकेशन को पुष्टि करने की ज़रूरत होती है
चैट ऐप्लिकेशन, किसी उपयोगकर्ता इंटरैक्शन की प्रतिक्रिया में मैसेज भेज सकते हैं या एसिंक्रोनस रूप से. यह एआई, उपयोगकर्ता की ओर से टास्क भी पूरा कर सकता है. जैसे, चैट स्पेस बनाना या चैट स्पेस में मौजूद लोगों की सूची पाना.
Chat ऐप्लिकेशन को उपयोगकर्ता के इंटरैक्शन का जवाब देने के लिए पुष्टि करने की ज़रूरत नहीं होती. हालांकि, अगर Chat ऐप्लिकेशन जवाब प्रोसेस करते समय Chat API या किसी दूसरे Google API को कॉल करता है, तो उसे पुष्टि करनी होगी.
उपयोगकर्ता की ओर से टास्क करने या एसिंक्रोनस मैसेज भेजने के लिए, Chat ऐप्लिकेशन Chat API को RESTful अनुरोध करते हैं. इसके लिए, पुष्टि और अनुमति की ज़रूरत होती है.
उपयोगकर्ता के इंटरैक्शन के जवाबों की पुष्टि करने की ज़रूरत नहीं है
Google Chat ऐप्लिकेशन को उपयोगकर्ता के तौर पर पुष्टि करने की ज़रूरत नहीं है या वह चैट ऐप्लिकेशन जिसे एक ही समय पर सिंक करके जवाब दिया जा सकता है इंटरैक्शन इवेंट.
जब भी कोई उपयोगकर्ता किसी Chat ऐप्लिकेशन से इंटरैक्ट करता है या उसे इस्तेमाल करता है, तब Google Chat ऐप्लिकेशन को इंटरैक्शन इवेंट मिलते हैं. इनमें ये इवेंट शामिल हैं:
- कोई उपयोगकर्ता, Chat ऐप्लिकेशन पर मैसेज भेजता है.
- कोई उपयोगकर्ता, Chat ऐप्लिकेशन को @टैग करता है.
- जब कोई उपयोगकर्ता, Chat ऐप्लिकेशन के किसी एक चैट ऐप्लिकेशन को शुरू करता है स्लैश कमांड का इस्तेमाल किया जाता है.
नीचे दिए गए डायग्राम में, चैट इस्तेमाल करने वाले व्यक्ति और चैट ऐप्लिकेशन:
- उपयोगकर्ता, Google Chat में Chat ऐप्लिकेशन को मैसेज भेजता है.
- Google Chat, मैसेज को ऐप्लिकेशन पर फ़ॉरवर्ड करता है.
- ऐप्लिकेशन को मैसेज मिलता है, उसे प्रोसेस किया जाता है, और Google Chat को जवाब दिया जाता है.
- Google Chat, उपयोगकर्ता के लिए या स्पेस में जवाब रेंडर करता है.
Chat ऐप्लिकेशन से होने वाले हर इंटरैक्शन के लिए यह क्रम दोहराया जाता है इवेंट.
एसिंक्रोनस मैसेज की पुष्टि करना ज़रूरी है
एसिंक्रोनस मैसेज तब आते हैं, जब कोई Chat ऐप्लिकेशन को अनुरोध भेजें Chat API, इसके लिए, पुष्टि और अनुमति की ज़रूरत होती है.
Chat API को कॉल करके, Chat ऐप्लिकेशन, Google Chat में मैसेज पोस्ट कर सकते हैं. इसके अलावा, वे उपयोगकर्ता की ओर से टास्क पूरे कर सकते हैं और डेटा ऐक्सेस कर सकते हैं. उदाहरण के लिए, सर्वर के बंद होने का पता चलने के बाद, Chat ऐप्लिकेशन इन कामों के लिए Chat API को कॉल कर सकता है:
- चैट स्पेस बनाएं, ताकि हर समस्या की जांच की जा सके और उसे ठीक किया जा सके कुछ समय के लिए उपलब्ध नहीं है.
- चैट स्पेस में लोगों को जोड़ें.
- रुकावट के बारे में जानकारी देने के लिए, चैट स्पेस में कोई मैसेज पोस्ट करें.
नीचे दिए गए डायग्राम में, एसिंक्रोनस मैसेज का क्रम दिखाया गया है चैट ऐप्लिकेशन और चैट स्पेस:
- Chat ऐप्लिकेशन,
spaces.messages.createविधि का इस्तेमाल करके Chat API को कॉल करके मैसेज बनाता है. साथ ही, एचटीटीपी अनुरोध में उपयोगकर्ता के क्रेडेंशियल शामिल करता है. - Google Chat, सेवा खाते या उपयोगकर्ता के क्रेडेंशियल की मदद से, Chat ऐप्लिकेशन की पुष्टि करता है.
- Google Chat, ऐप्लिकेशन के मैसेज को किसी तय Chat स्पेस में रेंडर करता है.
Chat API के स्कोप
OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें और दायरे चुनें, ताकि यह तय किया जा सके कि उपयोगकर्ताओं और ऐप्लिकेशन की समीक्षा करने वाले लोगों को कौनसी जानकारी दिखे. साथ ही, अपने ऐप्लिकेशन को रजिस्टर करें, ताकि आप उसे बाद में पब्लिश कर सकें.
अपने ऐप्लिकेशन को दिए गए ऐक्सेस लेवल के बारे में बताने के लिए, आपको अनुमति के दायरे की पहचान करनी होगी और उनके बारे में बताना होगा. अनुमति देने का स्कोप, OAuth 2.0 यूआरआई है ऐसी स्ट्रिंग जिसमें Google Workspace ऐप्लिकेशन का नाम शामिल है. यह किस तरह का डेटा है ऐक्सेस, और ऐक्सेस का लेवल शामिल है.
गैर-संवेदनशील दायरे
| दायरा कोड | ब्यौरा |
|---|---|
https://www.googleapis.com/auth/chat.bot
|
चैट ऐप्लिकेशन को चैट देखने और मैसेज भेजने की अनुमति दें. यह स्कोप, सिर्फ़ सेवा खातों की मदद से ऐप्लिकेशन की पुष्टि करने की सुविधा देता है. आपने लोगों तक पहुंचाया मुफ़्त में उपयोगकर्ता क्रेडेंशियल के साथ या के साथ प्रमाणित नहीं कर सकता पूरे डोमेन के लोगों को डेटा का ऐक्सेस देना इस स्कोप का इस्तेमाल करके किया जा सकता है. |
संवेदनशील स्कोप
| स्कोप कोड | ब्यौरा |
|---|---|
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
|
बातचीत और स्पेस बनाना. साथ ही, मेटाडेटा देखना या अपडेट करना (इसमें ये शामिल हैं इतिहास की सेटिंग और ऐक्सेस सेटिंग). ज़रूरी है एडमिन की मंज़ूरी. यह दायरा सिर्फ़ सेवा खातों के साथ ऐप्लिकेशन की पुष्टि करने की सुविधा देता है. आपने लोगों तक पहुंचाया मुफ़्त में उपयोगकर्ता क्रेडेंशियल के साथ या के साथ प्रमाणित नहीं कर सकता पूरे डोमेन के लोगों को डेटा का ऐक्सेस देना इस स्कोप का इस्तेमाल करके किया जा सकता है. |
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.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 डेटा. इसके लिए ज़रूरी है आपको अतिरिक्त ऐप्लिकेशन की पुष्टि करनी होगी. इस बारे में जानकारी के लिए ज़रूरी है. संवेदनशील जानकारी का अनुरोध करने वाले ऐप्लिकेशन के लिए चरण देखें दायरे.
पाबंदी वाला—ये स्कोप, Google उपयोगकर्ता के डेटा का ज़्यादा ऐक्सेस देते हैं. साथ ही, आपको पाबंदी वाले स्कोप की पुष्टि करने की प्रोसेस से गुज़रना पड़ता है. इस ज़रूरी शर्त के बारे में जानकारी पाने के लिए, Google API सेवाएं: उपयोगकर्ता के डेटा से जुड़ी नीति और खास एपीआई दायरों के लिए अतिरिक्त ज़रूरी शर्तें देखें. पाबंदी वाले स्कोप का अनुरोध करने वाले ऐप्लिकेशन के लिए ज़रूरी कार्रवाई भी देखें.
अगर आपके ऐप्लिकेशन को किसी अन्य Google API का ऐक्सेस चाहिए, तो उन दायरों को जोड़ा जा सकता है है. Google API के दायरों के बारे में ज़्यादा जानने के लिए, Google API को ऐक्सेस करने के लिए OAuth 2.0 का इस्तेमाल करना लेख पढ़ें.
Google Workspace के एपीआई के स्कोप के बारे में ज़्यादा जानने के लिए, OAuth की सहमति वाली स्क्रीन कॉन्फ़िगर करना और स्कोप चुनना लेख पढ़ें.
पुष्टि करने के ज़रूरी तरीके
Chat ऐप्लिकेशन, Chat API की मदद से पुष्टि करने और अनुमति देने के लिए, इन दो तरीकों का इस्तेमाल कर सकते हैं:
- उपयोगकर्ता की पुष्टि करना
- उपयोगकर्ता की पुष्टि करना इससे Chat ऐप्लिकेशन, उपयोगकर्ता का डेटा ऐक्सेस कर सकता है और कार्रवाइयां कर सकता है पर डाउनलोड किया जाता है. OAuth के दायरे, अनुमति वाले डेटा और कार्रवाइयों के बारे में बताते हैं. अगर Chat ऐप्लिकेशन को एडमिन ने इंस्टॉल किया है या उसे डोमेन के लिए ऐक्सेस देने की अनुमति दी गई है, तो पहली बार जब 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 ऐप्लिकेशन के इंटरैक्शन इवेंट के लिए
इस टेबल में, चैट ऐप्लिकेशन के साथ उपयोगकर्ताओं के इंटरैक्ट करने के सामान्य तरीकों के बारे में बताया गया है. साथ ही, यह भी बताया गया है कि पुष्टि करना ज़रूरी है या नहीं:
| स्थिति | पुष्टि करने की ज़रूरत नहीं है | उपयोगकर्ता की पुष्टि करने की सुविधा काम करती है | ऐप्लिकेशन की पुष्टि करने की सुविधा काम करती है | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| इनसे मैसेज पाएं: |
|
|||||||||||||||
| मैसेज का जवाब देना: |
|
|||||||||||||||
| नए मैसेज भेजें: |
|
|||||||||||||||
मिलते-जुलते विषय
- Google Workspace में पुष्टि करने और अनुमति देने के बारे में खास जानकारी के लिए, देखें पुष्टि करने और अनुमति देना.
- Google Cloud में पुष्टि करने और अनुमति देने की खास जानकारी के लिए, पुष्टि करने की खास जानकारी देखें.
- सेवा खातों के बारे में ज़्यादा जानने के लिए, सेवा खाते लेख पढ़ें.
- Google API, OAuth 2.0 का इस्तेमाल कैसे करता है, इस बारे में ज़्यादा जानने के लिए यहां देखें Google API ऐक्सेस करने के लिए, OAuth 2.0 का इस्तेमाल करना.
- इसके साथ पुष्टि करने और अनुमति देने की सुविधा सेट अप करें उपयोगकर्ता के क्रेडेंशियल या एक सेवा खाता.