इस गाइड में, Google Chat API के Message
संसाधन पर create()
तरीका इस्तेमाल करने का तरीका बताया गया है. इससे, इनमें से कोई भी काम किया जा सकता है:
- ऐसे मैसेज भेजें जिनमें टेक्स्ट, कार्ड, और इंटरैक्टिव विजेट शामिल हों.
- Chat का इस्तेमाल करने वाले किसी व्यक्ति को निजी तौर पर मैसेज भेजना.
- मैसेज थ्रेड शुरू करना या उसका जवाब देना.
- मैसेज को कोई नाम दें, ताकि आप उसे Chat API के अन्य अनुरोधों में बता सकें.
मैसेज का साइज़ 32,000 बाइट से ज़्यादा नहीं होना चाहिए. इसमें टेक्स्ट या कार्ड भी शामिल हैं. इस साइज़ से ज़्यादा का मैसेज भेजने के लिए, आपके Chat ऐप्लिकेशन को एक से ज़्यादा मैसेज भेजने होंगे.
मैसेज बनाने के लिए Chat API को कॉल करने के अलावा, Chat ऐप्लिकेशन उपयोगकर्ता के इंटरैक्शन का जवाब देने के लिए मैसेज बना सकते हैं और भेज सकते हैं. जैसे, जब कोई उपयोगकर्ता Chat ऐप्लिकेशन को स्पेस में जोड़ता है, तो वेलकम मैसेज पोस्ट करना. इंटरैक्शन का जवाब देते समय, Chat ऐप्लिकेशन, मैसेजिंग की अन्य सुविधाओं का इस्तेमाल कर सकते हैं. इनमें इंटरैक्टिव डायलॉग और लिंक की झलक दिखाने वाले इंटरफ़ेस शामिल हैं. किसी उपयोगकर्ता को जवाब देने के लिए, Chat ऐप्लिकेशन, Chat API को कॉल किए बिना, मैसेज को सिंक करता है. इंटरैक्शन के जवाब में मैसेज भेजने के बारे में जानने के लिए, Google Chat ऐप्लिकेशन से इंटरैक्शन पाने और उनका जवाब देने का तरीका लेख पढ़ें.
Chat API की मदद से बनाए गए मैसेज को Chat कैसे दिखाता है और उनका एट्रिब्यूट कैसे जोड़ता है
create()
तरीके को कॉल करने के लिए, ऐप्लिकेशन की पुष्टि और उपयोगकर्ता की पुष्टि का इस्तेमाल किया जा सकता है.
पुष्टि करने के तरीके के आधार पर, Chat मैसेज भेजने वाले व्यक्ति को अलग-अलग एट्रिब्यूट देता है.
Chat ऐप्लिकेशन के तौर पर पुष्टि करने पर, Chat ऐप्लिकेशन मैसेज भेजता है.
उपयोगकर्ता के तौर पर पुष्टि करने पर, Chat ऐप्लिकेशन उपयोगकर्ता की ओर से मैसेज भेजता है. Chat, मैसेज में Chat ऐप्लिकेशन का नाम दिखाकर, उसे एट्रिब्यूट भी करता है.
पुष्टि करने के तरीके से यह भी तय होता है कि मैसेज में मैसेजिंग की कौनसी सुविधाएं और इंटरफ़ेस शामिल किए जा सकते हैं. ऐप्लिकेशन की पुष्टि करने की सुविधा की मदद से, Chat ऐप्लिकेशन ऐसे मैसेज भेज सकते हैं जिनमें रिच टेक्स्ट, कार्ड पर आधारित इंटरफ़ेस, और इंटरैक्टिव विजेट शामिल हों. Chat के उपयोगकर्ता अपने मैसेज में सिर्फ़ टेक्स्ट भेज सकते हैं. इसलिए, उपयोगकर्ता की पुष्टि करने की सुविधा का इस्तेमाल करके मैसेज बनाते समय, सिर्फ़ टेक्स्ट शामिल किया जा सकता है. Chat API के लिए उपलब्ध मैसेज सेवा की सुविधाओं के बारे में ज़्यादा जानने के लिए, Google Chat के मैसेज की खास जानकारी देखें.
इस गाइड में, Chat API की मदद से मैसेज भेजने के लिए, पुष्टि करने के किसी भी तरीके का इस्तेमाल करने का तरीका बताया गया है.
ज़रूरी शर्तें
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 ऐप्लिकेशन के तौर पर मैसेज भेजना
इस सेक्शन में, ऐप्लिकेशन की पुष्टि की सुविधा का इस्तेमाल करके, टेक्स्ट, कार्ड, और इंटरैक्टिव ऐक्सेसरी विजेट वाले मैसेज भेजने का तरीका बताया गया है.
ऐप्लिकेशन की पुष्टि करने की सुविधा का इस्तेमाल करके, CreateMessage()
तरीका कॉल करने के लिए, आपको अनुरोध में ये फ़ील्ड बताने होंगे:
chat.bot
अनुमति का दायरा.- वह
Space
संसाधन जिसमें आपको मैसेज पोस्ट करना है. Chat ऐप्लिकेशन का इस्तेमाल करने वाला व्यक्ति, स्पेस का सदस्य होना चाहिए. Message
का वह संसाधन जिसे बनाना है. मैसेज का कॉन्टेंट तय करने के लिए, रिच टेक्स्ट (text
), एक या उससे ज़्यादा कार्ड इंटरफ़ेस (cardsV2
) या दोनों शामिल किए जा सकते हैं.
इसके अलावा, इन चीज़ों को भी शामिल किया जा सकता है:
accessoryWidgets
फ़ील्ड, जिसमें मैसेज के सबसे नीचे इंटरैक्टिव बटन शामिल करने हैं.- किसी उपयोगकर्ता को निजी तौर पर मैसेज भेजने के लिए
privateMessageViewer
फ़ील्ड. messageId
फ़ील्ड, जिसकी मदद से मैसेज का नाम दिया जा सकता है, ताकि उसे दूसरे एपीआई अनुरोधों में इस्तेमाल किया जा सके.- थ्रेड शुरू करने या उस पर जवाब देने के लिए,
thread.threadKey
औरmessageReplyOption
फ़ील्ड. अगर स्पेस में थिरेड का इस्तेमाल नहीं किया जाता है, तो इस फ़ील्ड को अनदेखा कर दिया जाता है.
यहां दिए गए कोड में एक उदाहरण दिया गया है. इसमें बताया गया है कि Chat ऐप्लिकेशन, Chat ऐप्लिकेशन के तौर पर पोस्ट किया गया मैसेज कैसे भेज सकता है. इस मैसेज में टेक्स्ट, कार्ड, और मैसेज के सबसे नीचे क्लिक किया जा सकने वाला बटन होता है:
Node.js
Python
Java
Apps Script
इस सैंपल को चलाने के लिए, SPACE_NAME
को स्पेस के name
फ़ील्ड से मिले आईडी से बदलें. आईडी पाने के लिए, ListSpaces()
तरीका अपनाएं या स्पेस के यूआरएल का इस्तेमाल करें.
मैसेज के सबसे नीचे इंटरैक्टिव विजेट जोड़ना
इस गाइड के पहले कोड सैंपल में, Chat ऐप्लिकेशन के मैसेज में सबसे नीचे एक बटन दिखता है. इस बटन पर क्लिक किया जा सकता है. इसे ऐक्सेसरी विजेट कहा जाता है. ऐक्सेसरी विजेट, मैसेज में मौजूद किसी भी टेक्स्ट या कार्ड के बाद दिखते हैं. इन विजेट का इस्तेमाल करके, उपयोगकर्ताओं को कई तरीकों से अपने मैसेज के साथ इंटरैक्ट करने के लिए कहा जा सकता है. इनमें ये तरीके शामिल हैं:
- मैसेज की सटीकता या उससे संतुष्टि के लिए रेटिंग दें.
- मैसेज या Chat ऐप्लिकेशन से जुड़ी समस्या की शिकायत करना.
- मिलते-जुलते कॉन्टेंट का लिंक खोलें, जैसे कि दस्तावेज़.
- Chat ऐप्लिकेशन से मिलते-जुलते मैसेज को किसी तय समय के लिए खारिज या स्नूज़ किया जा सकता है.
ऐक्सेसरी विजेट जोड़ने के लिए, अपने अनुरोध के मुख्य हिस्से में accessoryWidgets[]
फ़ील्ड शामिल करें. साथ ही, एक या एक से ज़्यादा ऐसे विजेट बताएं जिन्हें आपको शामिल करना है.
इस इमेज में, Chat ऐप्लिकेशन दिखाया गया है. इसमें ऐक्सेसरी विजेट के साथ एक टेक्स्ट मैसेज जोड़ा गया है, ताकि उपयोगकर्ता Chat ऐप्लिकेशन के अनुभव को रेटिंग दे सकें.
यहां अनुरोध का मुख्य हिस्सा दिखाया गया है, जो दो ऐक्सेसरी बटन के साथ टेक्स्ट मैसेज बनाता है. जब कोई उपयोगकर्ता किसी बटन पर क्लिक करता है, तो उस बटन से जुड़ा फ़ंक्शन (जैसे, doUpvote
) इंटरैक्शन को प्रोसेस करता है:
{
text: "Rate your experience with this Chat app.",
accessoryWidgets: [{ buttonList: { buttons: [{
icon: { material_icon: {
name: "thumb_up"
}},
color: { red: 0, blue: 255, green: 0 },
onClick: { action: {
function: "doUpvote"
}}
}, {
icon: { material_icon: {
name: "thumb_down"
}},
color: { red: 0, blue: 255, green: 0 },
onClick: { action: {
function: "doDownvote"
}}
}]}}]
}
निजी तौर पर मैसेज भेजना
चैट ऐप्लिकेशन, निजी तौर पर मैसेज भेज सकते हैं, ताकि मैसेज सिर्फ़ स्पेस में मौजूद किसी खास उपयोगकर्ता को दिखे. जब कोई चैट ऐप्लिकेशन निजी मैसेज भेजता है, तो मैसेज में एक लेबल दिखता है. इससे उपयोगकर्ता को यह पता चलता है कि मैसेज सिर्फ़ उसे दिखेगा.
Chat API का इस्तेमाल करके निजी तौर पर मैसेज भेजने के लिए, अपने अनुरोध के मुख्य हिस्से में privateMessageViewer
फ़ील्ड की जानकारी दें. उपयोगकर्ता की जानकारी देने के लिए, वैल्यू को उस User
संसाधन पर सेट करें जो Chat उपयोगकर्ता की जानकारी देता है. User
संसाधन के name
फ़ील्ड का इस्तेमाल भी किया जा सकता है, जैसा कि इस उदाहरण में दिखाया गया है:
{
text: "Hello private world!",
privateMessageViewer: {
name: "users/USER_ID"
}
}
इस सैंपल का इस्तेमाल करने के लिए, USER_ID
को उपयोगकर्ता के यूनीक आईडी से बदलें. जैसे, 12345678987654321
या
hao@cymbalgroup.com
. उपयोगकर्ताओं की जानकारी देने के बारे में ज़्यादा जानने के लिए, Google Chat के उपयोगकर्ताओं की पहचान करना और उनकी जानकारी देना लेख पढ़ें.
निजी तौर पर मैसेज भेजने के लिए, आपको अपने अनुरोध में ये चीज़ें शामिल नहीं करनी चाहिए:
किसी उपयोगकर्ता की ओर से मैसेज भेजना
इस सेक्शन में, उपयोगकर्ता की पुष्टि की सुविधा का इस्तेमाल करके, किसी उपयोगकर्ता की ओर से मैसेज भेजने का तरीका बताया गया है. उपयोगकर्ता की पुष्टि करने के बाद, मैसेज में सिर्फ़ टेक्स्ट शामिल किया जा सकता है. साथ ही, मैसेज में ऐसी मैसेजिंग सुविधाएं शामिल नहीं होनी चाहिए जो सिर्फ़ चैट ऐप्लिकेशन के लिए उपलब्ध हैं. इनमें कार्ड इंटरफ़ेस और इंटरैक्टिव विजेट शामिल हैं.
उपयोगकर्ता की पुष्टि करने के तरीके का इस्तेमाल करके CreateMessage()
को कॉल करने के लिए, आपको अनुरोध में ये फ़ील्ड बताने होंगे:
- अनुमति का दायरा, जो इस तरीके के लिए उपयोगकर्ता की पुष्टि करने की सुविधा देता है. यहां दिए गए सैंपल में,
chat.messages.create
स्कोप का इस्तेमाल किया गया है. - वह
Space
संसाधन जिसमें आपको मैसेज पोस्ट करना है. पुष्टि करने वाला उपयोगकर्ता, स्पेस का सदस्य होना चाहिए. Message
का वह संसाधन जिसे बनाना है. मैसेज का कॉन्टेंट तय करने के लिए, आपकोtext
फ़ील्ड शामिल करना होगा.
इसके अलावा, इन चीज़ों को भी शामिल किया जा सकता है:
messageId
फ़ील्ड, जिसकी मदद से मैसेज को नाम दिया जा सकता है, ताकि उसे दूसरे एपीआई अनुरोधों में इस्तेमाल किया जा सके.thread.threadKey
औरmessageReplyOption
फ़ील्ड, जिनका इस्तेमाल करके थ्रेड शुरू की जा सकती है या उस पर जवाब दिया जा सकता है. अगर स्पेस में थ्रेड का इस्तेमाल नहीं किया जाता है, तो इस फ़ील्ड को अनदेखा कर दिया जाता है.
नीचे दिए गए कोड में, इस बात का उदाहरण दिया गया है कि Chat ऐप्लिकेशन, पुष्टि किए गए उपयोगकर्ता की ओर से किसी स्पेस में टेक्स्ट मैसेज कैसे भेज सकता है:
Node.js
Python
Java
Apps Script
इस सैंपल को चलाने के लिए, SPACE_NAME
को स्पेस के name
फ़ील्ड से मिले आईडी से बदलें. आईडी पाने के लिए, ListSpaces()
तरीका अपनाएं या स्पेस के यूआरएल का इस्तेमाल करें.
थ्रेड शुरू करना या उसमें जवाब देना
थ्रेड का इस्तेमाल करने वाले स्पेस के लिए, यह तय किया जा सकता है कि कोई नया मैसेज, थ्रेड शुरू करे या किसी मौजूदा थ्रेड का जवाब दे.
Chat API का इस्तेमाल करके भेजे गए मैसेज, डिफ़ॉल्ट रूप से एक नई थ्रेड शुरू करते हैं. थ्रेड की पहचान करने और बाद में उस पर जवाब देने के लिए, अपने अनुरोध में थ्रेड की कुंजी दें:
- अनुरोध के मुख्य हिस्से में,
thread.threadKey
फ़ील्ड की जानकारी दें. - क्वेरी पैरामीटर
messageReplyOption
डालें, ताकि यह तय किया जा सके कि अगर कुंजी पहले से मौजूद है, तो क्या होगा.
किसी मौजूदा थ्रेड का जवाब देने वाला मैसेज बनाने के लिए:
- अपने अनुरोध के मुख्य हिस्से में,
thread
फ़ील्ड शामिल करें. अगर यह सेट है, तो आपके पास अपने बनाए गएthreadKey
को तय करने का विकल्प होता है. ऐसा न होने पर, आपको थ्रेड केname
का इस्तेमाल करना होगा. - क्वेरी पैरामीटर
messageReplyOption
की वैल्यू डालें.
नीचे दिए गए कोड में एक उदाहरण दिया गया है. इसमें बताया गया है कि Chat ऐप्लिकेशन, पुष्टि किए गए उपयोगकर्ता की ओर से किसी थ्रेड को शुरू करने या उस पर जवाब देने के लिए, टेक्स्ट मैसेज कैसे भेज सकता है. थ्रेड की पहचान, किसी स्पेस की कुंजी से की जाती है:
Node.js
Python
Java
Apps Script
इस सैंपल को चलाने के लिए, इनकी जगह ये डालें:
THREAD_KEY
: स्पेस में मौजूद किसी थ्रेड की कुंजी या नई थ्रेड बनाने के लिए, थ्रेड का कोई यूनीक नाम.SPACE_NAME
: स्पेस केname
फ़ील्ड का आईडी. आईडी पाने के लिए,ListSpaces()
तरीका अपनाएं या स्पेस के यूआरएल का इस्तेमाल करें.
मैसेज का नाम देना
आने वाले समय में एपीआई कॉल में कोई मैसेज वापस पाने या बताने के लिए, अपने अनुरोध में messageId
फ़ील्ड सेट करके मैसेज का नाम दिया जा सकता है.
मैसेज को नाम देने से, मैसेज के रिसॉर्स के नाम (name
फ़ील्ड में दिखाया गया) से, सिस्टम से असाइन किया गया आईडी स्टोर किए बिना, मैसेज के बारे में बताया जा सकता है.
उदाहरण के लिए, get()
तरीके का इस्तेमाल करके कोई मैसेज पाने के लिए, रिसॉर्स के नाम का इस्तेमाल करके यह तय किया जाता है कि आपको कौनसा मैसेज चाहिए. संसाधन का नाम spaces/{space}/messages/{message}
के तौर पर फ़ॉर्मैट किया जाता है. यहां {message}
, सिस्टम से असाइन किए गए आईडी या मैसेज बनाते समय सेट किए गए कस्टम नाम को दिखाता है.
मैसेज का नाम देने के लिए, मैसेज बनाते समय messageId
फ़ील्ड में कोई कस्टम आईडी डालें. messageId
फ़ील्ड, Message
रिसॉर्स के clientAssignedMessageId
फ़ील्ड की वैल्यू सेट करता है.
मैसेज बनाते समय ही उसे नाम दिया जा सकता है. मौजूदा मैसेज के लिए, कस्टम आईडी का नाम नहीं दिया जा सकता या उसमें बदलाव नहीं किया जा सकता. कस्टम आईडी को ये ज़रूरी शर्तें पूरी करनी होंगी:
client-
से शुरू होता है. उदाहरण के लिए,client-custom-name
एक मान्य कस्टम आईडी है, लेकिनcustom-name
नहीं.- इसमें ज़्यादा से ज़्यादा 63 वर्ण हो सकते हैं. साथ ही, इसमें सिर्फ़ अंग्रेज़ी के छोटे अक्षर, संख्याएं, और हाइफ़न हो सकते हैं.
- स्पेस में यूनीक हो. चैट ऐप्लिकेशन, अलग-अलग मैसेज के लिए एक ही कस्टम आईडी का इस्तेमाल नहीं कर सकता.
नीचे दिए गए कोड में, इस बात का उदाहरण दिया गया है कि Chat ऐप्लिकेशन, पुष्टि किए गए उपयोगकर्ता की ओर से किसी स्पेस में आईडी के साथ टेक्स्ट मैसेज कैसे भेज सकता है:
Node.js
Python
Java
Apps Script
इस सैंपल को चलाने के लिए, इनकी जगह ये डालें:
SPACE_NAME
: स्पेस केname
फ़ील्ड का आईडी. आईडी पाने के लिए,ListSpaces()
तरीका अपनाएं या स्पेस के यूआरएल का इस्तेमाल करें.MESSAGE-ID
: मैसेज का नाम, जोcustom-
से शुरू होता है. यह नाम, उस स्पेस में Chat ऐप्लिकेशन से बनाए गए किसी भी मैसेज के नाम से अलग होना चाहिए.
समस्या हल करें
जब Google Chat ऐप्लिकेशन या कार्ड से कोई गड़बड़ी का मैसेज मिलता है, तो Chat इंटरफ़ेस पर "कोई गड़बड़ी हुई" मैसेज दिखता है. या "आपका अनुरोध प्रोसेस नहीं किया जा सका." कभी-कभी Chat के यूज़र इंटरफ़ेस (यूआई) पर, गड़बड़ी का कोई मैसेज नहीं दिखता. हालांकि, Chat ऐप्लिकेशन या कार्ड से अनचाहा नतीजा मिल सकता है. उदाहरण के लिए, हो सकता है कि कार्ड का मैसेज न दिखे.
ऐसा हो सकता है कि Chat के यूज़र इंटरफ़ेस (यूआई) में गड़बड़ी का मैसेज न दिखे. हालांकि, Chat ऐप्लिकेशन के लिए गड़बड़ी को लॉग करने की सुविधा चालू होने पर, गड़बड़ी के बारे में जानकारी देने वाले मैसेज और लॉग डेटा उपलब्ध होते हैं. इनकी मदद से, गड़बड़ियों को ठीक किया जा सकता है. गड़बड़ियों को देखने, डिबग करने, और ठीक करने में मदद पाने के लिए, Google Chat में गड़बड़ियों को हल करना और उन्हें ठीक करना लेख पढ़ें.
मिलते-जुलते विषय
- Chat ऐप्लिकेशन के लिए, JSON कार्ड मैसेज डिज़ाइन करने और उनकी झलक देखने के लिए, कार्ड बिल्डर का इस्तेमाल करें.
- मैसेज फ़ॉर्मैट करना.
- किसी मैसेज के बारे में जानकारी पाना.
- स्पेस में मौजूद मैसेज की सूची देखना.
- मैसेज अपडेट करना.
- कोई मैसेज मिटाना.
- Google Chat के मैसेज में उपयोगकर्ताओं की पहचान करना.
- इनकमिंग वेबहुक की मदद से, Google Chat में मैसेज भेजना.