इस पेज पर बताया गया है कि Google Chat ऐप्लिकेशन, मैसेज भेजने के लिए टेक्स्ट को कैसे फ़ॉर्मैट कर सकते हैं. इनमें से किसी भी चीज़ को मैसेज में शामिल किया जा सकता है:
- रिच टेक्स्ट, जिसमें हाइपरलिंक हों या चैट स्पेस में एक या सभी उपयोगकर्ताओं को @टैग किया गया हो.
- कार्ड इंटरफ़ेस में दिखने वाला टेक्स्ट. इसमें पैराग्राफ़ टेक्स्ट या बटन जैसे आइकॉन के साथ दिखने वाला यूज़र इंटरफ़ेस (यूआई) टेक्स्ट शामिल है.
टेक्स्ट मैसेज को फ़ॉर्मैट करना
Chat में, टेक्स्ट मैसेज में बुनियादी फ़ॉर्मैटिंग की सुविधा मिलती है. इसमें Markdown सिंटैक्स के छोटे सबसेट का इस्तेमाल करके, टेक्स्ट को बोल्ड, इटैलिक, और स्ट्राइकथ्रू फ़ॉर्मैट में बदला जा सकता है. टेक्स्ट मैसेज और कार्ड मैसेज में टेक्स्ट को अलग-अलग तरीके से फ़ॉर्मैट किया जाता है. ऐसा इसलिए, क्योंकि टेक्स्ट मैसेज को उसी सिंटैक्स के साथ फ़ॉर्मैट किया जाता है जिसका इस्तेमाल Chat के उपयोगकर्ता करते हैं.
टेक्स्ट मैसेज को फ़ॉर्मैट करने के लिए, इस सिंटैक्स का इस्तेमाल करें:
| फ़ॉर्मैट | चिह्न | सिंटैक्स का उदाहरण | Google Chat में दिखने वाला टेक्स्ट |
|---|---|---|---|
| बोल्ड | * | *नमस्ते* | नमस्ते |
| इटैलिक | _ (अंडरस्कोर) | _hello_ | नमस्ते |
| स्ट्राइकथ्रू | ~ | ~hello~ | |
| मोनोस्पेस | ` (बैककोट) | `नमस्ते` | hello |
| मोनोस्पेस ब्लॉक | ` ` ` (तीन बैककोट) | ``` Hello World ``` |
Hello |
| बुलेट वाली सूची बनाएँ | * या - (हाइफ़न) के बाद स्पेस | * यह सूची का पहला आइटम है * यह सूची का दूसरा आइटम है |
|
उदाहरण के लिए, यह JSON देखें:
{
"text": "Your pizza delivery *has arrived*!\nThank you for using _Cymbal Pizza!_"
}
फ़ॉर्मैट किए गए इस टेक्स्ट मैसेज में, Chat के स्पेस में ये चीज़ें दिखती हैं:
मैसेज में भेजा गया टेक्स्ट की फ़ॉर्मैटिंग देखना
जब कोई उपयोगकर्ता मैसेज भेजता है, तो मैसेज का सादा लेख वाला मुख्य हिस्सा
text फ़ील्ड में होता है. Markdown सिंटैक्स का इस्तेमाल करके, टेक्स्ट मैसेज में लागू की गई कुछ फ़ॉर्मैटिंग, text फ़ील्ड में होती है. अन्य फ़ॉर्मैटिंग, सिर्फ़ आउटपुट वाले formattedText फ़ील्ड में होती है. इसमें ये शामिल हैं:
- टेक्स्ट के लिए अतिरिक्त मार्कडाउन सिंटैक्स
- उपयोगकर्ताओं के टैग
- कस्टम हाइपरलिंक
- पसंद के मुताबिक बनाया गया इमोजी
उदाहरण के लिए, उपयोगकर्ता के भेजे गए इस टेक्स्ट को देखें:
अगर मैसेज को Chat के यूज़र इंटरफ़ेस (यूआई) में फ़ॉर्मैट करें मेन्यू का इस्तेमाल करके फ़ॉर्मैट किया गया था, तो 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 में दिखने वाला टेक्स्ट |
|---|---|
<https://example.com|Example website> |
पाइप और लिंक टेक्स्ट का इस्तेमाल करना ज़रूरी नहीं है. इसलिए, <https://www.example.com/> और
https://www.example.com/ एक जैसे हैं.
टेक्स्ट मैसेज में उपयोगकर्ताओं का नाम टैग करना
चैट ऐप्लिकेशन, टेक्स्ट मैसेज भेज सकते हैं. इन मैसेज में, चैट स्पेस में मौजूद एक या सभी उपयोगकर्ताओं को @टैग किया जा सकता है. चैट ऐप्लिकेशन, इंपोर्ट मोड में मौजूद स्पेस में उपयोगकर्ताओं का नाम नहीं टैग कर सकते. साथ ही, वे ऐसे उपयोगकर्ताओं का नाम भी टैग नहीं कर सकते जो स्पेस में शामिल नहीं हैं.
किसी खास उपयोगकर्ता का नाम टैग करने की सुविधा
किसी उपयोगकर्ता को @टैग करने के लिए, टेक्स्ट मैसेज में <users/{user}> जोड़ें. यहां {user}, उपयोगकर्ता का आईडी है. उदाहरण के लिए, इस टेक्स्ट मैसेज को देखें. इसमें 123456789012345678901, उपयोगकर्ता महान एस. का आईडी दिखाता है:
{
"text": "A customer has reported an issue. Assigning ticket #942 to <users/123456789012345678901>."
}
टेक्स्ट मैसेज इस तरह दिखता है:
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 के उपयोगकर्ता करते हैं.
कार्ड बिल्डर का इस्तेमाल करके, चैट ऐप्लिकेशन के लिए मैसेज सेवा और यूज़र इंटरफ़ेस को डिज़ाइन करें और उसकी झलक देखें:
कार्ड बिल्डर खोलनापैराग्राफ़ के टेक्स्ट को फ़ॉर्मैट करना
इस्तेमाल किए जा सकने वाले टैग और उनका मकसद, नीचे दी गई टेबल में दिखाया गया है:
| फ़ॉर्मैट | उदाहरण | रेंडर किया गया नतीजा |
|---|---|---|
| बोल्ड | "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." |
यह पहली लाइन है. यह एक नई लाइन है. |
टेक्स्ट में आइकॉन जोड़ें
कार्ड में टेक्स्ट के साथ आइकॉन दिखाने के लिए, DecoratedText और ButtonList विजेट का इस्तेमाल किया जा सकता है.
यहां दिए गए सेक्शन में, सजाए गए टेक्स्ट या बटन में पहले से मौजूद आइकॉन, Google Material आइकॉन या कस्टम आइकॉन इस्तेमाल करने का तरीका बताया गया है.
Chat में मौजूद आइकॉन का इस्तेमाल करना
Chat में पहले से मौजूद आइकॉन का इस्तेमाल करने के लिए, इनमें से कोई एक विकल्प चुनें:
यहां दी गई टेबल में, कार्ड मैसेज के लिए पहले से मौजूद आइकॉन की सूची दी गई है:
| AIRPLANE | बुकमार्क | ||
| BUS | CAR | ||
| CLOCK | CONFIRMATION_NUMBER_ICON | ||
| ब्यौरा | DOLLAR | ||
| ईमेल | EVENT_SEAT | ||
| FLIGHT_ARRIVAL | FLIGHT_DEPARTURE | ||
| HOTEL | HOTEL_ROOM_TYPE | ||
| न्योता भेजना | MAP_PIN | ||
| पैसे चुकाकर ली जाने वाली सदस्यता | MULTIPLE_PEOPLE | ||
| PERSON | PHONE | ||
| RESTAURANT_ICON | SHOPPING_CART | ||
| स्टार | स्टोर | ||
| टिकट | TRAIN | ||
| VIDEO_CAMERA | VIDEO_PLAY |
ईमेल आइकॉन वाले कार्ड का उदाहरण यहां दिया गया है:
Google के मटीरियल आइकॉन का इस्तेमाल करें
Google के मटीरियल आइकॉन का इस्तेमाल करके, 2,500 से ज़्यादा आइकॉन में से कोई आइकॉन चुना जा सकता है. साथ ही, आइकॉन के वज़न, भरने, और ग्रेड को पसंद के मुताबिक बनाया जा सकता है.
Google Material आइकॉन वाले कार्ड का उदाहरण यहां दिया गया है:
कस्टम आइकॉन का इस्तेमाल करें
कस्टम आइकॉन जोड़ने के लिए, iconUrl फ़ील्ड शामिल करें और आइकॉन का यूआरएल डालें.
कस्टम आइकॉन का उदाहरण यहां दिया गया है: