मैसेज फ़ॉर्मैट करना

Google Chat की मदद से, मैसेज को फ़ॉर्मैट किया जा सकता है. इसमें ये शामिल हैं:

मैसेज को फ़ॉर्मैट करना

Chat की मदद से, Markdown सिंटैक्स के एक छोटे सबसेट का इस्तेमाल किया जा सकता है. इसकी मदद से, किसी टेक्स्ट मैसेज में बेसिक फ़ॉर्मैटिंग जोड़ी जा सकती है. जैसे, बोल्ड, इटैलिक, और स्ट्राइकथ्रू. टेक्स्ट मैसेज के फ़ॉर्मैट, कार्ड मैसेज के मुकाबले अलग होते हैं. इसकी वजह यह है कि मैसेज को उसी सिंटैक्स से फ़ॉर्मैट किया जाता है जिसका इस्तेमाल Chat के उपयोगकर्ता करते हैं. कार्ड में दिखने वाले टेक्स्ट को फ़ॉर्मैट करने के लिए, कार्ड मैसेज फ़ॉर्मैट करना देखें.

मैसेज को फ़ॉर्मैट करने के लिए, नीचे दिए गए सिंटैक्स का इस्तेमाल करें:

फ़ॉर्मैट चिह्न सिंटैक्स का उदाहरण Google Chat में दिखाया गया टेक्स्ट
बोल्ड * *नमस्ते* नमस्ते
इटैलिक _ (अंडरस्कोर) _नमस्ते_ नमस्ते
स्ट्राइकथ्रू ~ ~नमस्ते~ नमस्ते
मोनोस्पेस ` (बैककोट) `नमस्ते` hello
मोनोस्पेस ब्लॉक ` ` ` (तीन बैककोट) ```
नमस्ते
दुनिया
```		 Hello
World
बुलेट वाली सूची * या - (हाइफ़न) के बाद स्पेस

* यह सूची का पहला आइटम है

* यह सूची में दूसरा आइटम है
  • यह सूची का पहला आइटम है
  • यह सूची का दूसरा आइटम है

उदाहरण के लिए, नीचे दिया गया JSON फ़ॉर्मैट देखें:

    {
      "text": "Your pizza delivery *has arrived*!\nThank you for using _Cymbal Pizza!_"
    }

फ़ॉर्मैट किए गए इस मैसेज में यह जानकारी, चैट स्पेस में दिखती है:

सिंबल पिज़्ज़ा ऐप्लिकेशन यह मैसेज भेजता है कि डिलीवरी मिल गई है.

मैसेज में भेजे गए टेक्स्ट का फ़ॉर्मैट देखना

जब कोई उपयोगकर्ता मैसेज भेजता है, तो मैसेज का मुख्य हिस्सा text फ़ील्ड में दिखता है. Markdown सिंटैक्स का इस्तेमाल करके टेक्स्ट मैसेज पर लागू किया जाने वाला कुछ फ़ॉर्मैट, text फ़ील्ड में होता है. अन्य फ़ॉर्मैट, सिर्फ़ आउटपुट वाले formattedText फ़ील्ड में होता है. इसमें ये फ़ॉर्मैट शामिल हैं:

  • टेक्स्ट के लिए अतिरिक्त मार्कडाउन सिंटैक्स
  • उपयोगकर्ताओं की ओर से टैग किया गया
  • कस्टम हाइपरलिंक
  • पसंद के मुताबिक बनाया गया इमोजी

उदाहरण के लिए, किसी उपयोगकर्ता के भेजे गए इस टेक्स्ट को देखें:

Chat में इस शब्द के साथ मैसेज मिला

अगर मैसेज को 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>."
}

मैसेज इस तरह दिखता है:

Chat ऐप्लिकेशन, मैसेज में किसी व्यक्ति को टैग करता है.

users/{user} वैल्यू को इन तरीकों से बताया जा सकता है:

  • अगर Google Chat ऐप्लिकेशन, उपयोगकर्ता के भेजे गए मैसेज का जवाब दे रहा है, तो MESSAGE इंटरैक्शन इवेंट के message.sender.name फ़ील्ड का इस्तेमाल करें.

  • अगर आपका Google Chat ऐप्लिकेशन एसिंक्रोनस मैसेज बना रहा है, तो नीचे बताए गए तरीकों से users/{user} के लिए वैल्यू तय की जा सकती है:

    • Google Chat User संसाधन, जैसे कि users/123456789012345678901 के name फ़ील्ड का इस्तेमाल करें.
    • {user} वैल्यू के लिए, उपयोगकर्ता के ईमेल पते को उपनाम के तौर पर इस्तेमाल करें. उदाहरण के लिए, अगर ईमेल पता mahan@example.com है, तो उपयोगकर्ता के बारे में users/mahan@example.com बताया जा सकता है. ईमेल उपनाम का इस्तेमाल करने के लिए, आपके Google Chat ऐप्लिकेशन को उपयोगकर्ता के तौर पर पुष्टि करनी होगी.

  • अगर आपने People API का इस्तेमाल किया है, तो यूज़र आईडी की पहचान करने के लिए, people.get तरीके का भी इस्तेमाल किया जा सकता है.

सभी उपयोगकर्ताओं का @नाम टैग करें

स्पेस में सभी लोगों को @नाम से टैग करने वाला मैसेज बनाने के लिए, {user} को all से बदलें. नीचे दिए गए JSON के उदाहरण में, सभी उपयोगकर्ताओं के बारे में एक मैसेज में बताया गया है:

{
    "text": "Important message for <users/all>: Code freeze starts at midnight tonight!"
}

कार्ड मैसेज फ़ॉर्मैट करना

कार्ड के अंदर, ज़्यादातर टेक्स्ट फ़ील्ड में एचटीएमएल टैग के एक छोटे सबसेट का इस्तेमाल किया जाता है. इससे उन्हें बेसिक टेक्स्ट फ़ॉर्मैटिंग की सुविधा मिलती है. कार्ड मैसेज के टेक्स्ट का फ़ॉर्मैट, टेक्स्ट मैसेज के टेक्स्ट से अलग होता है. इसकी वजह यह है कि मैसेज को उसी सिंटैक्स से फ़ॉर्मैट किया जाता है जिसका इस्तेमाल Chat के उपयोगकर्ता करते हैं. मैसेज में दिखने वाले टेक्स्ट को फ़ॉर्मैट करने के लिए, टेक्स्ट मैसेज को फ़ॉर्मैट करना देखें.

Chat ऐप्लिकेशन के लिए JSON कार्ड मैसेज डिज़ाइन करने और उनकी झलक देखने के लिए, 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." यह पहली लाइन है.
यह एक नई लाइन है.

कार्ड में पहले से मौजूद आइकॉन जोड़ना

DecoratedText और ButtonList विजेट, icon एलिमेंट के साथ काम करते हैं. इसका इस्तेमाल, Chat में पहले से मौजूद आइकॉन में से किसी एक के बारे में बताने के लिए किया जाता है.

यहां दी गई टेबल में, कार्ड के मैसेज के लिए उपलब्ध बिल्ट-इन आइकॉन की सूची दी गई है:

फ़्लाइट BOOKMARK
BUS कार
घड़ी CONFIRMATION_NUMBER_ICON
ब्यौरा डॉलर
ईमेल EVENT_SEAT
FLIGHT_ARRIVAL FLIGHT_DEPARTURE
होटल HOTEL_ROOM_TYPE
न्योता दें MAP_PIN
पैसे चुकाकर ली जाने वाली सदस्यता MULTIPLE_PEOPLE
व्यक्ति फ़ोन
RESTAURANT_ICON SHOPPING_CART
स्टार स्टोर
टिकट TRAIN
VIDEO_CAMERA VIDEO_PLAY

यहां ईमेल आइकॉन वाले कार्ड का उदाहरण दिया गया है:

कार्ड में Google मटीरियल डिज़ाइन का आइकॉन जोड़ना

DecoratedText और ButtonList विजेट की मदद से, Google मटीरियल आइकॉन इस्तेमाल किए जा सकते हैं. इससे, 2,500 से ज़्यादा आइकॉन वाले विकल्पों में से चुना जा सकता है और आइकॉन का वज़न, फ़िल, और ग्रेड कस्टमाइज़ किया जा सकता है.

Google मटीरियल आइकॉन वाले कार्ड का एक उदाहरण यहां दिया गया है:

कार्ड में पसंद का आइकॉन जोड़ें

DecoratedText और ButtonList विजेट की मदद से, पहले से मौजूद आइकॉन इस्तेमाल किए जा सकते हैं या अपनी पसंद के मुताबिक आइकॉन तय किए जा सकते हैं. किसी कार्ड में पसंद के मुताबिक आइकॉन जोड़ने के लिए, iconUrl फ़ील्ड शामिल करें और आइकॉन से जुड़े यूआरएल की जानकारी दें.

कस्टम आइकॉन का एक उदाहरण यहां दिया गया है: