इस गाइड में, टेक्स्ट या कार्ड मैसेज की जानकारी दिखाने के लिए, Google Chat API के Message
संसाधन पर get()
तरीके का इस्तेमाल करने का तरीका बताया गया है.
Chat API में, Chat मैसेज को Message
संसाधन से दिखाया जाता है.
Chat के उपयोगकर्ता सिर्फ़ टेक्स्ट वाले मैसेज भेज सकते हैं. हालांकि, Chat ऐप्लिकेशन में मैसेजिंग की कई अन्य सुविधाएं इस्तेमाल की जा सकती हैं. जैसे, स्टैटिक या इंटरैक्टिव यूज़र इंटरफ़ेस दिखाना, उपयोगकर्ताओं से जानकारी इकट्ठा करना, और मैसेज निजी तौर पर डिलीवर करना. Chat API के लिए उपलब्ध मैसेज सेवा की सुविधाओं के बारे में ज़्यादा जानने के लिए, Google Chat के मैसेज की खास जानकारी देखें.
ज़रूरी शर्तें
Node.js
- आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो. साथ ही, आपके पास Google Chat का ऐक्सेस हो.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें.
- अपने Chat ऐप्लिकेशन के लिए नाम, आइकॉन, और जानकारी के साथ Google Chat API को चालू और कॉन्फ़िगर करें.
- Node.js क्लाउड क्लाइंट लाइब्रेरी इंस्टॉल करें.
- Google Chat API के अनुरोध में पुष्टि करने के तरीके के आधार पर, ऐक्सेस क्रेडेंशियल बनाएं:
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
client_secrets.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें. - Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए,
सेवा खाते के क्रेडेंशियल बनाएं और क्रेडेंशियल को
credentials.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें.
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर या Chat ऐप्लिकेशन के तौर पर पुष्टि करनी है.
- Google Chat का कोई स्पेस, जिसमें पुष्टि किए गए उपयोगकर्ता या कॉल करने वाले Chat ऐप्लिकेशन का सदस्यता लेना ज़रूरी है. Chat ऐप्लिकेशन के तौर पर पुष्टि कराने के लिए, Chat ऐप्लिकेशन को स्पेस में जोड़ें.
Python
- आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो. साथ ही, आपके पास Google Chat का ऐक्सेस हो.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें.
- अपने Chat ऐप्लिकेशन के लिए नाम, आइकॉन, और जानकारी के साथ Google Chat API को चालू और कॉन्फ़िगर करें.
- Python क्लाउड क्लाइंट लाइब्रेरी इंस्टॉल करें.
- Google Chat API के अनुरोध में पुष्टि करने के तरीके के आधार पर, ऐक्सेस क्रेडेंशियल बनाएं:
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
client_secrets.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें. - Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए,
सेवा खाते के क्रेडेंशियल बनाएं और क्रेडेंशियल को
credentials.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें.
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर या Chat ऐप्लिकेशन के तौर पर पुष्टि करनी है.
- Google Chat का कोई स्पेस, जिसमें पुष्टि किए गए उपयोगकर्ता या कॉल करने वाले Chat ऐप्लिकेशन का सदस्यता लेना ज़रूरी है. Chat ऐप्लिकेशन के तौर पर पुष्टि कराने के लिए, Chat ऐप्लिकेशन को स्पेस में जोड़ें.
Java
- आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो. साथ ही, आपके पास Google Chat का ऐक्सेस हो.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें.
- अपने Chat ऐप्लिकेशन के लिए नाम, आइकॉन, और जानकारी के साथ Google Chat API को चालू और कॉन्फ़िगर करें.
- Java क्लाउड क्लाइंट लाइब्रेरी इंस्टॉल करें.
- Google Chat API के अनुरोध में पुष्टि करने के तरीके के आधार पर, ऐक्सेस क्रेडेंशियल बनाएं:
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
client_secrets.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें. - Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए,
सेवा खाते के क्रेडेंशियल बनाएं और क्रेडेंशियल को
credentials.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें.
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर या Chat ऐप्लिकेशन के तौर पर पुष्टि करनी है.
- Google Chat का कोई स्पेस, जिसमें पुष्टि किए गए उपयोगकर्ता या कॉल करने वाले Chat ऐप्लिकेशन का सदस्यता लेना ज़रूरी है. Chat ऐप्लिकेशन के तौर पर पुष्टि कराने के लिए, Chat ऐप्लिकेशन को स्पेस में जोड़ें.
Apps Script
- आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो. साथ ही, आपके पास Google Chat का ऐक्सेस हो.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें.
- अपने Chat ऐप्लिकेशन के लिए नाम, आइकॉन, और जानकारी के साथ Google Chat API को चालू और कॉन्फ़िगर करें.
- स्टैंडअलोन Apps Script प्रोजेक्ट बनाएं और ऐडवांस चैट सेवा चालू करें.
- इस गाइड में, आपको उपयोगकर्ता या ऐप्लिकेशन की पुष्टि में से किसी एक का इस्तेमाल करना होगा. Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, सेवा खाते के क्रेडेंशियल बनाएं. यह तरीका जानने के लिए, Google Chat ऐप्लिकेशन के तौर पर पुष्टि करना और अनुमति देना लेख पढ़ें.
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर या Chat ऐप्लिकेशन के तौर पर पुष्टि करनी है.
- Google Chat का कोई स्पेस, जिसमें पुष्टि किए गए उपयोगकर्ता या कॉल करने वाले Chat ऐप्लिकेशन का सदस्यता लेना ज़रूरी है. Chat ऐप्लिकेशन के तौर पर पुष्टि कराने के लिए, Chat ऐप्लिकेशन को स्पेस में जोड़ें.
उपयोगकर्ता की पुष्टि करने वाला मैसेज पाना
उपयोगकर्ता की पुष्टि वाले मैसेज के बारे में जानकारी पाने के लिए, अपने अनुरोध में यह जानकारी दें:
chat.messages.readonly
याchat.messages
ऑथराइज़ेशन स्कोप की जानकारी दें.GetMessage()
वाला तरीका कॉल करें.name
को उस मैसेज के संसाधन के नाम पर सेट करें जिसे आपको चाहिए.
नीचे दिए गए उदाहरण में, उपयोगकर्ता की पुष्टि करने वाला मैसेज मिलता है:
Node.js
Python
Java
Apps Script
इस सैंपल को चलाने के लिए, इनकी जगह ये डालें:
SPACE_NAME
: स्पेस केname
का आईडी.ListSpaces()
वाला तरीका अपनाकर या स्पेस के यूआरएल से, आईडी पाया जा सकता है.MESSAGE_NAME
: मैसेज केname
में मौजूद आईडी. Chat API की मदद से, मैसेज बनाने के बाद मिलने वाले रिस्पॉन्स बॉडी से आईडी पाया जा सकता है. इसके अलावा, मैसेज बनाने के दौरान असाइन किए गए कस्टम नाम से भी आईडी पाया जा सकता है.
Chat API, Message
का एक इंस्टेंस दिखाता है. इसमें, बताए गए मैसेज की जानकारी होती है.
ऐप्लिकेशन की पुष्टि करने वाला मैसेज पाना
ऐप्लिकेशन की पुष्टि वाले मैसेज के बारे में जानकारी पाने के लिए, अपने अनुरोध में यह जानकारी दें:
chat.bot
की अनुमति का स्कोप बताएं.GetMessage()
वाला तरीका कॉल करें.name
को उस मैसेज के संसाधन के नाम पर सेट करें जिसे आपको चाहिए.
नीचे दिए गए उदाहरण में, ऐप्लिकेशन की पुष्टि करने वाला मैसेज मिलता है:
Node.js
Python
Java
Apps Script
इस सैंपल को चलाने के लिए, इनकी जगह ये डालें:
SPACE_NAME
: स्पेस केname
का आईडी.ListSpaces()
वाला तरीका अपनाकर या स्पेस के यूआरएल से, आईडी पाया जा सकता है.MESSAGE_NAME
: मैसेज केname
में मौजूद आईडी. Chat API का इस्तेमाल करके, एसिंक्रोनस तरीके से मैसेज बनाने के बाद, रिस्पॉन्स बॉडी से आईडी हासिल किया जा सकता है. इसके अलावा, मैसेज बनाने के दौरान असाइन किए गए कस्टम नाम से भी आईडी हासिल किया जा सकता है.
Chat API, Message
का एक इंस्टेंस दिखाता है. इसमें, बताए गए मैसेज की जानकारी होती है.
मिलते-जुलते विषय
- मैसेज को फ़ॉर्मैट करें.
- मैसेज मिटाना.
- स्पेस में मौजूद मैसेज की सूची देखना.
- मैसेज अपडेट करना.
- मैसेज भेजें.