इस गाइड में, स्पेस में मौजूद टेक्स्ट या कार्ड मैसेज को अपडेट करने के लिए, Google Chat API के Message
संसाधन पर update()
तरीके का इस्तेमाल करने का तरीका बताया गया है. मैसेज के एट्रिब्यूट बदलने के लिए, मैसेज अपडेट करें. जैसे, मैसेज में क्या लिखा है या कार्ड का कॉन्टेंट. कार्ड मैसेज के पहले टेक्स्ट मैसेज को जोड़ा जा सकता है या टेक्स्ट मैसेज के बाद कार्ड जोड़ा जा सकता है.
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 ऐप्लिकेशन के तौर पर पुष्टि करनी है.
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 ऐप्लिकेशन के तौर पर पुष्टि करनी है.
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 ऐप्लिकेशन के तौर पर पुष्टि करनी है.
Apps Script
- आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो. साथ ही, आपके पास Google Chat का ऐक्सेस हो.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें.
- अपने Chat ऐप्लिकेशन के लिए नाम, आइकॉन, और जानकारी के साथ Google Chat API को चालू और कॉन्फ़िगर करें.
- स्टैंडअलोन Apps Script प्रोजेक्ट बनाएं और ऐडवांस चैट सेवा चालू करें.
- इस गाइड में, आपको उपयोगकर्ता या ऐप्लिकेशन की पुष्टि में से किसी एक का इस्तेमाल करना होगा. Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, सेवा खाते के क्रेडेंशियल बनाएं. यह तरीका जानने के लिए, Google Chat ऐप्लिकेशन के तौर पर पुष्टि करना और अनुमति देना लेख पढ़ें.
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर या Chat ऐप्लिकेशन के तौर पर पुष्टि करनी है.
किसी उपयोगकर्ता की ओर से मैसेज अपडेट करना
उपयोगकर्ता की पुष्टि करने पर, सिर्फ़ मैसेज का टेक्स्ट अपडेट किया जा सकता है.
उपयोगकर्ता की पुष्टि करके मैसेज अपडेट करने के लिए, अपने अनुरोध में ये चीज़ें शामिल करें:
chat.messages
की अनुमति का स्कोप बताएं.UpdateMessage()
वाला तरीका कॉल करें.message
कोMessage
के इंस्टेंस के तौर पर पास करें. इसके लिए, यह तरीका अपनाएं:name
फ़ील्ड, अपडेट किए जाने वाले मैसेज पर सेट होता है. इसमें स्पेस आईडी और मैसेज आईडी शामिल होता है.- नए टेक्स्ट के साथ सेट किया गया
text
फ़ील्ड.
updateMask
कोtext
वैल्यू के साथ पास करें.
अगर अपडेट किया गया मैसेज कार्ड मैसेज है, तो टेक्स्ट कार्ड के आगे जुड़ जाता है. कार्ड दिखते रहते हैं.
उपयोगकर्ता की पुष्टि के साथ, कार्ड मैसेज के आगे टेक्स्ट मैसेज जोड़ने या मैसेज को अपडेट करने का तरीका यहां बताया गया है:
Node.js
Python
Java
Apps Script
इस सैंपल को चलाने के लिए, इनकी जगह ये डालें:
SPACE_NAME
: स्पेस केname
का आईडी.ListSpaces()
वाला तरीका अपनाकर या स्पेस के यूआरएल से, आईडी पाया जा सकता है.MESSAGE_NAME
: मैसेज केname
से मिला आईडी. Chat API का इस्तेमाल करके, एसिंक्रोनस तरीके से मैसेज बनाने के बाद, रिस्पॉन्स बॉडी से आईडी हासिल किया जा सकता है. इसके अलावा, मैसेज बनाने के दौरान असाइन किए गए कस्टम नाम से भी आईडी हासिल किया जा सकता है.
Chat API, Message
का एक इंस्टेंस दिखाता है. इसमें, अपडेट किए गए मैसेज की जानकारी होती है.
Chat ऐप्लिकेशन के तौर पर मैसेज अपडेट करना
ऐप्लिकेशन की पुष्टि की सुविधा की मदद से, मैसेज के टेक्स्ट और कार्ड, दोनों को अपडेट किया जा सकता है.
ऐप्लिकेशन की पुष्टि करके मैसेज अपडेट करने के लिए, अपने अनुरोध में ये चीज़ें शामिल करें:
chat.bot
की अनुमति का स्कोप बताएं.UpdateMessage()
वाला तरीका कॉल करें.message
कोMessage
के इंस्टेंस के तौर पर पास करें. इसके लिए, यह तरीका अपनाएं:name
फ़ील्ड, अपडेट किए जाने वाले मैसेज पर सेट होता है. इसमें स्पेस आईडी और मैसेज आईडी शामिल होता है.- अगर
text
फ़ील्ड को अपडेट करना है, तो उसे नए टेक्स्ट के साथ सेट करें. - नए कार्ड के साथ सेट किया गया
cardsV2
फ़ील्ड, अगर उन्हें अपडेट करना ज़रूरी हो.
updateMask
को फ़ील्ड की सूची के साथtext
औरcardsV2
जैसे अपडेट में पास करें.
अगर अपडेट किया गया मैसेज कार्ड मैसेज है और टेक्स्ट अपडेट किया गया है, तो अपडेट किया गया टेक्स्ट कार्ड के आगे जुड़ जाता है. कार्ड दिखते रहते हैं. अगर अपडेट किया गया मैसेज टेक्स्ट मैसेज है और कार्ड अपडेट किए गए हैं, तो अपडेट किए गए कार्ड टेक्स्ट में जुड़ जाते हैं. यह टेक्स्ट दिखता रहता है.
ऐप्लिकेशन की पुष्टि की मदद से, मैसेज के टेक्स्ट और कार्ड को अपडेट करने का तरीका यहां बताया गया है:
Node.js
Python
Java
Apps Script
इस सैंपल को चलाने के लिए, इनकी जगह ये डालें:
SPACE_NAME
: स्पेस केname
का आईडी.ListSpaces()
वाला तरीका अपनाकर या स्पेस के यूआरएल से, आईडी पाया जा सकता है.MESSAGE_NAME
: मैसेज केname
से मिला आईडी. Chat API का इस्तेमाल करके, एसिंक्रोनस तरीके से मैसेज बनाने के बाद, रिस्पॉन्स बॉडी से आईडी हासिल किया जा सकता है. इसके अलावा, मैसेज बनाने के दौरान असाइन किए गए कस्टम नाम से भी आईडी हासिल किया जा सकता है.
Chat API, Message
का एक इंस्टेंस दिखाता है. इसमें, अपडेट किए गए मैसेज की जानकारी होती है.
मिलते-जुलते विषय
- मैसेज को फ़ॉर्मैट करें.
- मैसेज मिटाना.
- किसी मैसेज के बारे में जानकारी पाना.
- स्पेस में मौजूद मैसेज की सूची देखना.
- मैसेज भेजें.