इस पेज पर बताया गया है कि Google Chat ऐप्लिकेशन, मैसेज भेजने के लिए टेक्स्ट को कैसे फ़ॉर्मैट कर सकते हैं. इन मैसेज में इनमें से कोई भी जानकारी शामिल हो सकती है:
- रिच टेक्स्ट, जिसमें हाइपरलिंक शामिल हों या किसी चैट स्पेस में एक या सभी उपयोगकर्ताओं को @mention किया गया हो.
- कार्ड इंटरफ़ेस में दिखने वाला टेक्स्ट. इसमें पैराग्राफ़ टेक्स्ट या आइकॉन के साथ दिखने वाला यूज़र इंटरफ़ेस (यूआई) टेक्स्ट शामिल है. जैसे, बटन.
मैसेज को फ़ॉर्मैट करना
Chat में, टेक्स्ट मैसेज को बोल्ड, इटैलिक, और स्ट्राइकथ्रू करने जैसी बुनियादी फ़ॉर्मैटिंग की जा सकती है. टेक्स्ट मैसेज और कार्ड मैसेज में टेक्स्ट को अलग-अलग तरीके से फ़ॉर्मैट किया जाता है. ऐसा इसलिए, क्योंकि टेक्स्ट मैसेज को उसी सिंटैक्स के साथ फ़ॉर्मैट किया जाता है जिसका इस्तेमाल Chat उपयोगकर्ता करते हैं.
Chat API का इस्तेमाल करके भेजे गए मैसेज के लिए, Chat के ओरिजनल सिंटैक्स का इस्तेमाल जारी रखा जा सकता है. इसके अलावा, स्टैंडर्ड मार्कडाउन सिंटैक्स का इस्तेमाल किया जा सकता है. इसके लिए, अनुरोध के मुख्य हिस्से में markup_syntax को शामिल करना होगा.
टेक्स्ट मैसेज को फ़ॉर्मैट करने के लिए, इस सिंटैक्स का इस्तेमाल करें:
| फ़ॉर्मैट | MARKUP_SYNTAX_CHAT | MARKUP_SYNTAX_MARKDOWN | सिंटैक्स का उदाहरण | Google Chat में दिखने वाला टेक्स्ट |
|---|---|---|---|---|
| बोल्ड | * |
** |
या:
|
नमस्ते |
| इटैलिक | _ (अंडरस्कोर) |
* |
या:
|
नमस्ते |
| स्ट्राइकथ्रू | ~ |
~~ |
या:
|
|
| मोनोस्पेस | ` (बैककोट) | ` (बैककोट) | `hello` | hello |
| मोनोस्पेस ब्लॉक | ` ` ` (तीन बैककोट) | ` ` ` (तीन बैककोट) | ``` Hello World ``` |
Hello |
| बुलेट वाली सूची | * या - (हाइफ़न) के बाद स्पेस | * या - (हाइफ़न) के बाद स्पेस | * यह सूची का पहला आइटम है. * यह सूची का दूसरा आइटम है. |
|
| नेस्ट की गई सूची | * या - (हाइफ़न) के बाद स्पेस, जो हर नेस्ट लेवल के हिसाब से चार स्पेस से पहले आता है | * या - (हाइफ़न) के बाद स्पेस, जो हर नेस्ट लेवल के हिसाब से चार स्पेस से पहले आता है | * यह सूची में नेस्ट किए गए पहले लेवल का आइटम है. * यह सूची में नेस्ट किए गए दूसरे लेवल का आइटम है. * यह सूची में नेस्ट किए गए तीसरे लेवल का आइटम है. |
|
| नंबर वाली सूची | ये काम नहीं करते हैं | 1. (संख्या के बाद पूर्ण विराम और स्पेस) | 1. यह सूची का पहला आइटम है. 2. यह सूची में मौजूद दूसरा आइटम है. |
|
| ब्लॉक कोट | > (इससे ज़्यादा का चिह्न) | > (इससे ज़्यादा का चिह्न) | >नमस्ते |
|
| हाइपरलिंक | <hyperlink|display text> |
[display text](hyperlink) |
या:
|
हाइपरलिंक के बारे में ज़्यादा जानने के लिए, लिंक फ़ॉर्मैट करना लेख पढ़ें. |
| उपयोगकर्ता को टैग करना | <users/{user}>, जहां {user} यूज़र आईडी है. |
या:
|
या:
|
@Mahan S उपयोगकर्ताओं को टैग करने के बारे में ज़्यादा जानने के लिए, टेक्स्ट मैसेज में उपयोगकर्ताओं को टैग करना लेख पढ़ें. |
| कस्टम इमोजी |
या:
|
या:
|
या:
या:
या:
|
🐱 (स्माइली कैट कस्टम इमोजी) |
| उद्धरण | ये काम नहीं करते हैं | <chat-citation data-id="{id}">{text}</chat-citation> जहां {id}, मैसेज elements में तय किया गया उद्धरण आईडी है. |
<chat-citation data-id="cite_1">cited text</chat-citation> |
दूसरी जगह से लिया गया टेक्स्ट उद्धरणों के बारे में ज़्यादा जानने के लिए, टेक्स्ट मैसेज में उद्धरण जोड़ना लेख पढ़ें. |
उदाहरण के लिए, यहां दिया गया JSON देखें:
{
"text": "Your pizza delivery *has arrived*!\nThank you for using _Cymbal Pizza!_"
}
फ़ॉर्मैट किए गए इस टेक्स्ट मैसेज में, Chat स्पेस में ये चीज़ें दिखती हैं:
मैसेज में भेजे गए टेक्स्ट फ़ॉर्मैटिंग को देखना
जब कोई उपयोगकर्ता मैसेज भेजता है, तो मैसेज का सामान्य टेक्स्ट वाला मुख्य हिस्सा, text फ़ील्ड में होता है. मार्कडाउन सिंटैक्स का इस्तेमाल करके, टेक्स्ट मैसेज पर लागू की गई कुछ फ़ॉर्मैटिंग, text फ़ील्ड में होती है. अतिरिक्त फ़ॉर्मैटिंग, सिर्फ़ आउटपुट के लिए उपलब्ध formattedText फ़ील्ड में होती है. इसमें यह जानकारी शामिल होती है:
- टेक्स्ट के लिए अतिरिक्त मार्कडाउन सिंटैक्स
- उपयोगकर्ताओं की समीक्षाओं में इस्तेमाल हुए शब्द
- कस्टम हाइपरलिंक
- कस्टम इमोजी
उदाहरण के लिए, उपयोगकर्ता ने यह टेक्स्ट भेजा है:
अगर मैसेज को चैट यूज़र इंटरफ़ेस (यूआई) में मौजूद फ़ॉर्मैट मेन्यू का इस्तेमाल करके फ़ॉर्मैट किया गया था, तो text फ़ील्ड में सिर्फ़ टेक्स्ट होता है. वहीं, formattedText फ़ील्ड में मार्कअप, टेक्स्ट, और हाइपरलिंक होता है. यहां दिए गए उदाहरण में, टेक्स्ट मैसेज का ड्राफ़्ट दिखाया गया है. इसमें एक शब्द को हाइपरलिंक किया गया है, सूची में आइटम दिए गए हैं, और एक शब्द को बोल्ड किया गया है:
यह मैसेज इस फ़ॉर्मैट में मिलता है:
{
"text": "I can meet there at:\nNoon\n3 pm\n5 pm\nWhat time works for you?",
"formattedText": "I can meet <http://example.com|there> at:\n* Noon\n* 3 pm\n* 5 pm\nWhat time works for *you*?",
}
लिंक फ़ॉर्मैट करना
अगर आपने अपने मैसेज के टेक्स्ट में कोई सामान्य लिंक यूआरएल शामिल किया है, जैसे कि
http://www.example.com/, तो Google Chat इसे लिंक टेक्स्ट के तौर पर इस्तेमाल करता है. साथ ही, उस टेक्स्ट को दिए गए यूआरएल से अपने-आप हाइपरलिंक कर देता है.
अपने लिंक के लिए कोई दूसरा लिंक टेक्स्ट देने के लिए, इस सिंटैक्स का इस्तेमाल करें:
मार्कडाउन के साथ कॉन्फ़िगर किए गए एपीआई मैसेज के लिए, मार्कडाउन लिंक के स्टैंडर्ड सिंटैक्स का इस्तेमाल करें:
सिंटैक्स का उदाहरण Google Chat में दिखने वाला टेक्स्ट [Example website](https://example.com)सामान्य टेक्स्ट मैसेज के लिए, पाइप सिंटैक्स का इस्तेमाल करें:
सिंटैक्स का उदाहरण Google Chat में दिखने वाला टेक्स्ट <https://example.com|Example website>पाइप और लिंक टेक्स्ट ज़रूरी नहीं है, ताकि
<https://example.com>औरhttps://example.comएक जैसे हों.
टेक्स्ट मैसेज में पसंद के मुताबिक बनाए गए इमोजी का इस्तेमाल करना
चैट ऐप्लिकेशन, मैसेज को ज़्यादा दिलचस्प बनाने के लिए, पसंद के मुताबिक बनाए गए इमोजी के साथ टेक्स्ट मैसेज भेज सकते हैं. पसंद के मुताबिक बनाए गए इमोजी, सिर्फ़ Google Workspace संगठनों के लिए उपलब्ध हैं. साथ ही, एडमिन को संगठन के लिए, पसंद के मुताबिक बनाए गए इमोजी की सुविधा चालू करनी होगी. ज़्यादा जानकारी के लिए, Google Chat में पसंद के मुताबिक बनाए गए इमोजी के बारे में जानकारी और पसंद के मुताबिक बनाए गए इमोजी इस्तेमाल करने की अनुमतियां मैनेज करना लेख पढ़ें.
पसंद के मुताबिक बनाए गए इमोजी वाले मैसेज बनाने के लिए, आपके ऐप्लिकेशन को उपयोगकर्ता की पुष्टि करने की सुविधा का इस्तेमाल करना होगा. कस्टम इमोजी का इस्तेमाल, वेबहुक के तौर पर बनाए गए मैसेज या ऐप्लिकेशन की पुष्टि करके बनाए गए मैसेज में नहीं किया जा सकता.
मैसेज के टेक्स्ट में कस्टम इमोजी जोड़ने के लिए, customEmoji रिसॉर्स के name या emoji_name को सेट करें:
{
"text": "Hello <customEmojis/CUSTOM_EMOJI_ID>."
}
इस सैंपल का इस्तेमाल करने के लिए, CUSTOM_EMOJI_ID को कस्टम इमोजी के आईडी से बदलें. यह आईडी, customEmoji संसाधन के name या emoji_name फ़ील्ड में देखा जा सकता है.
अगर आपका ऐप्लिकेशन, मार्कडाउन सिंटैक्स का इस्तेमाल करके मैसेज भेजता है, तो कस्टम इमोजी आईडी का इस्तेमाल करके, एचटीएमएल टैग फ़ॉर्मैट में कस्टम इमोजी तय किए जा सकते हैं:
{
"text": "Hello <chat-emoji data-custom-emoji=\"customEmojis/CUSTOM_EMOJI_ID\">."
}
इसके अलावा, पसंद के मुताबिक बनाए गए इमोजी का नाम भी दिया जा सकता है:
{
"text": "Hello <chat-emoji data-emoji-name=\"CUSTOM_EMOJI_NAME\">."
}
इन सैंपल का इस्तेमाल करने के लिए, CUSTOM_EMOJI_ID को कस्टम इमोजी आईडी से बदलें. साथ ही, CUSTOM_EMOJI_NAME को कस्टम इमोजी के शॉर्टकोड के नाम से बदलें.
टेक्स्ट मैसेज में लोगों के नाम टैग करना
Chat ऐप्लिकेशन, Chat स्पेस में मौजूद किसी एक या सभी उपयोगकर्ताओं को टैग करके टेक्स्ट मैसेज भेज सकते हैं. चैट ऐप्लिकेशन, उन उपयोगकर्ताओं को भी मेंशन कर सकते हैं जो स्पेस में शामिल नहीं हैं या इंपोर्ट मोड में मौजूद स्पेस के सदस्य हैं.
साइलेंट मैसेज में, लोगों को टैग करने की सुविधा काम नहीं करती. साइलेंट मैसेज में किसी को टैग करने पर, गड़बड़ी का मैसेज दिखता है.
चुनिंदा लोगों के नाम टैग करना
किसी उपयोगकर्ता को @mention करने के लिए, टेक्स्ट मैसेज में <users/{user}> जोड़ें. यहां
{user}, उपयोगकर्ता का आईडी है. उदाहरण के लिए, यहां दिया गया टेक्स्ट मैसेज देखें. इसमें 123456789012345678901 का मतलब, उपयोगकर्ता महान एस. का आईडी है:
{
"text": "A customer has reported an issue. Assigning ticket #942 to <users/123456789012345678901>."
}
अगर आपका ऐप्लिकेशन, मार्कडाउन सिंटैक्स का इस्तेमाल करके मैसेज भेजता है, तो उपयोगकर्ता आईडी तय करने के लिए, chat-user एचटीएमएल टैग फ़ॉर्मैट का इस्तेमाल करें:
{
"text": "Assigning ticket #942 to <chat-user data-user=\"users/123456789012345678901\">."
}
इसके अलावा, ईमेल से भी जानकारी दी जा सकती है:
{
"text": "Assigning ticket #942 to <chat-user data-email=\"mahan@example.com\">."
}
टेक्स्ट मैसेज इस तरह दिखता है:
users/{user} की वैल्यू इन तरीकों से दी जा सकती है:
- अगर आपका Google Chat ऐप्लिकेशन, उपयोगकर्ता के भेजे गए मैसेज का जवाब दे रहा है, तो
MESSAGEइंटरैक्शन इवेंट केmessage.sender.nameफ़ील्ड का इस्तेमाल किया जा सकता है. अगर आपका Google Chat ऐप्लिकेशन, एसिंक्रोनस टेक्स्ट मैसेज बना रहा है, तो
users/{user}के लिए वैल्यू इन तरीकों से तय की जा सकती है:- Google Chat
Userसंसाधन केnameफ़ील्ड का इस्तेमाल करें. जैसे,users/123456789012345678901. - उपयोगकर्ता के ईमेल पते का इस्तेमाल,
{user}वैल्यू के लिए एलियास के तौर पर करें. उदाहरण के लिए, अगर ईमेल पताmahan@example.comहै, तो उपयोगकर्ता कोusers/mahan@example.comके तौर पर सेट किया जा सकता है. दूसरा ईमेल पता इस्तेमाल करने के लिए, आपके Google Chat ऐप्लिकेशन को उपयोगकर्ता के तौर पर पुष्टि करनी होगी.
- Google Chat
People API का इस्तेमाल करने पर, उपयोगकर्ता आईडी की पहचान करने के लिए
people.getतरीके का भी इस्तेमाल किया जा सकता है.
सभी उपयोगकर्ताओं के नाम टैग करना
किसी स्पेस में मौजूद सभी लोगों को टैग करने वाला मैसेज बनाने के लिए, {user}
को all से बदलें. यहां दिए गए JSON उदाहरण में, मैसेज में सभी उपयोगकर्ताओं का ज़िक्र किया गया है:
{
"text": "Important message for <users/all>: Code freeze starts at midnight tonight!"
}
अगर आपका ऐप्लिकेशन, मार्कडाउन सिंटैक्स का इस्तेमाल करके मैसेज भेजता है, तो chat-user एचटीएमएल टैग फ़ॉर्मैट का इस्तेमाल करके, मेंशन करने की जानकारी दें:
{
"text": "Important message for <chat-user data-user=\"users/all\">: Code freeze starts at midnight tonight!"
}
टेक्स्ट मैसेज में उद्धरण जोड़ना
चैट ऐप्लिकेशन, टेक्स्ट मैसेज में उद्धरण शामिल कर सकते हैं, ताकि लोगों को सोर्स के बारे में पूरी जानकारी दी जा सके. सोर्स दो तरीकों से दिए जा सकते हैं:
- इनलाइन उद्धरण: इंटरैक्टिव कार्ड जोड़ें. ये कार्ड तब दिखते हैं, जब लोग आपके मैसेज टेक्स्ट के किसी हिस्से पर पॉइंटर को रोकते हैं.
- फ़ुटर के सोर्स: मैसेज के सबसे नीचे, फ़ुटर लिंक के तौर पर सोर्स की सूची दिखाएं.
सिर्फ़ तब उद्धरण जोड़े जा सकते हैं, जब मैसेज के markupSyntax को MARKUP_SYNTAX_MARKDOWN पर सेट किया गया हो. यह सुविधा, Chat API का इस्तेमाल करके सिर्फ़ एसिंक्रोनस मैसेज बनाने के लिए उपलब्ध है.
किसी मैसेज में इनलाइन उद्धरण जोड़ने के लिए:
- मैसेज
elementsकीcitationsसूची में सोर्स दें. साथ ही, हरCitationऑब्जेक्ट को एक यूनीकidअसाइन करें. - मैसेज के टेक्स्ट में, उस टेक्स्ट को रैप करें जिसे आपको
chat-citationएचटीएमएल टैग फ़ॉर्मैट का इस्तेमाल करके उद्धृत करना है:<chat-citation data-id="{id}">{text}</chat-citation>. पक्का करें कि{id}, उस आईडी से मेल खाता हो जिसे आपनेelementsमें तय किया है. बिना रेफ़रंस वाले उद्धरणों (ऐसे उद्धरण जिनमें मेल खाने वाला टैग नहीं है) को अनदेखा कर दिया जाता है.
{
"text": "This is a <chat-citation data-id=\"cite_1\">cited</chat-citation> text.",
"markupSyntax": "MARKUP_SYNTAX_MARKDOWN",
"elements": {
"citations": [
{
"id": "cite_1",
"citedSources": [
{
"title": "Example Source",
"uri": "https://example.com"
}
]
}
]
}
}
किसी मैसेज में फ़ुटर सोर्स जोड़ने के लिए, मैसेज elements की citedSources सूची में सोर्स जोड़ें. यहां दिए गए सभी सोर्स, फ़ुटर लिंक के तौर पर मैसेज के नीचे अपने-आप दिखते हैं. इसके लिए, मैसेज टेक्स्ट में किसी भी इनलाइन टैग की ज़रूरत नहीं होती.
{
"text": "This is a message with a footer source.",
"markupSyntax": "MARKUP_SYNTAX_MARKDOWN",
"elements": {
"citedSources": [
{
"title": "Example Source",
"uri": "https://example.com"
}
]
}
}
कार्ड में दिखने वाले टेक्स्ट को फ़ॉर्मैट करना
कार्ड में मौजूद ज़्यादातर टेक्स्ट फ़ील्ड में, एचटीएमएल टैग के छोटे सबसेट का इस्तेमाल करके, टेक्स्ट को बुनियादी तौर पर फ़ॉर्मैट किया जा सकता है. कार्ड मैसेज में टेक्स्ट को फ़ॉर्मैट करने का तरीका, टेक्स्ट मैसेज में टेक्स्ट को फ़ॉर्मैट करने के तरीके से अलग होता है. ऐसा इसलिए, क्योंकि टेक्स्ट मैसेज को उसी सिंटैक्स का इस्तेमाल करके फ़ॉर्मैट किया जाता है जिसका इस्तेमाल Chat उपयोगकर्ता करते हैं.
Chat ऐप्लिकेशन के लिए मैसेजिंग और यूज़र इंटरफ़ेस को डिज़ाइन करने और उनकी झलक देखने के लिए, Card Builder का इस्तेमाल करें:
कार्ड बिल्डर खोलेंपैराग्राफ़ के टेक्स्ट को फ़ॉर्मैट करना
नीचे दी गई टेबल में, इस्तेमाल किए जा सकने वाले टैग और उनके मकसद के बारे में बताया गया है:
| फ़ॉर्मैट | उदाहरण | रेंडर किया गया नतीजा |
|---|---|---|
| बोल्ड | "This is <b>bold</b>." |
यह बोल्ड है. |
| इटैलिक | "This is <i>italics</i>." |
यह इटैलिक है. |
| अंडरलाइन करें | "This is <u>underline</u>." |
यह अंडरलाइन है. |
| स्ट्राइकथ्रू | "This is <s>strikethrough</s>." |
यह |
| फ़ॉन्ट का रंग | "This is <font color=\"#FF0000\">red font</font>." |
यह लाल रंग का फ़ॉन्ट है. |
| हाइपरलिंक | "This is a <a href=\"https://www.google.com\">hyperlink</a>." |
यह एक हाइपरलिंक है. |
| समय | "This is a time format: <time>2023-02-16 15:00</time>." |
यह समय का फ़ॉर्मैट है: . |
| न्यूलाइन | "This is the first line. <br> This is a new line." |
यह पहली लाइन है. यह एक नई लाइन है. |
सूचियां और कोड ब्लॉक तय करने के लिए, इन टैग का इस्तेमाल करें:
| फ़ॉर्मैट | उदाहरण | रेंडर किया गया नतीजा |
|---|---|---|
| नई लाइन | "Line 1<br>Line 2" |
Line 1 Line 2 |
| मोनोस्पेस | "This is an <code>inline code</code>." |
यह inline code है. |
| मोनोस्पेस ब्लॉक | "<pre><code>This a code block.</code></pre>" |
|
| बुलेट वाली सूची | "<ul><li>List item 1</li><li>List item 2</li></ul>" |
|
| क्रम वाली सूची | "<ol><li>List item 1</li><li>List item 2</li></ol>" |
|
Markdown
मार्कडाउन सिंटैक्स चालू होने पर, इस सिंटैक्स का इस्तेमाल किया जा सकता है:
| फ़ॉर्मैट | उदाहरण | रेंडर किया गया नतीजा |
|---|---|---|
| बोल्ड | **नमस्ते** या __नमस्ते__ | नमस्ते |
| इटैलिक | *नमस्ते* या _नमस्ते_ | नमस्ते |
| स्ट्राइकथ्रू | ~नमस्ते~ | |
| मोनोस्पेस | `hello` | hello |
| मोनोस्पेस ब्लॉक | ``` Hello World ``` |
Hello |
| बुलेट वाली सूची | - यह सूची का पहला आइटम है - यह सूची का दूसरा आइटम है |
|
|
* यह सूची का पहला आइटम है * यह सूची का दूसरा आइटम है |
|
|
| क्रम वाली सूची | 1. यह सूची का पहला आइटम है 2. यह सूची का दूसरा आइटम है |
|
| हाइपरलिंक | [Example website](https://example.com) | उदाहरण के लिए वेबसाइट |
टेक्स्ट में आइकॉन जोड़ना
किसी कार्ड में टेक्स्ट के साथ आइकॉन दिखाने के लिए, DecoratedText और ButtonList विजेट का इस्तेमाल किया जा सकता है.
यहां दिए गए सेक्शन में, डेकोरेट किए गए टेक्स्ट या बटन में पहले से मौजूद आइकॉन, Google मटीरियल आइकॉन या कस्टम आइकॉन इस्तेमाल करने का तरीका बताया गया है.
Chat के आइकॉन इस्तेमाल करना
Chat में उपलब्ध बिल्ट-इन आइकॉन का इस्तेमाल करने के लिए, इनमें से कोई एक विकल्प चुनें:
यहां दी गई टेबल में, कार्ड मैसेज के लिए उपलब्ध बिल्ट-इन आइकॉन की सूची दी गई है:
| AIRPLANE | BOOKMARK | ||
| BUS | CAR | ||
| CLOCK | CONFIRMATION_NUMBER_ICON | ||
| ब्यौरा | DOLLAR | ||
| EVENT_SEAT | |||
| FLIGHT_ARRIVAL | FLIGHT_DEPARTURE | ||
| HOTEL | HOTEL_ROOM_TYPE | ||
| न्योता दें | MAP_PIN | ||
| MEMBERSHIP | MULTIPLE_PEOPLE | ||
| PERSON | PHONE | ||
| RESTAURANT_ICON | SHOPPING_CART | ||
| STAR | स्टोर | ||
| TICKET | TRAIN | ||
| VIDEO_CAMERA | VIDEO_PLAY |
ईमेल आइकॉन वाले कार्ड का उदाहरण यहां दिया गया है:
Google के मटीरियल आइकॉन का इस्तेमाल करना
Google Material आइकॉन का इस्तेमाल करके, 2,500 से ज़्यादा आइकॉन के विकल्पों में से कोई आइकॉन चुना जा सकता है. साथ ही, आइकॉन के वेट, फ़िल, और ग्रेड को पसंद के मुताबिक बनाया जा सकता है.
Google Material सामग्री आइकॉन वाले कार्ड का उदाहरण यहां दिया गया है:
कस्टम आइकॉन इस्तेमाल करना
कस्टम आइकॉन जोड़ने के लिए, iconUrl फ़ील्ड शामिल करें और आइकॉन का यूआरएल डालें.
कस्टम आइकॉन का एक उदाहरण यहां दिया गया है: