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