इस गाइड में, स्पेस में टेक्स्ट या कार्ड मैसेज अपडेट करने के लिए, 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 Cloud Client Library इंस्टॉल करें.
- 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
का एक इंस्टेंस दिखाता है. इसमें, अपडेट किए गए मैसेज की जानकारी होती है.
मिलते-जुलते विषय
- मैसेज को फ़ॉर्मैट करें.
- कोई मैसेज मिटाना.
- किसी मैसेज के बारे में जानकारी पाना.
- स्पेस में मौजूद मैसेज की सूची देखना.
- मैसेज भेजें.