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

इस पेज पर बताया गया है कि Google Chat ऐप्लिकेशन, मैसेज भेजने के लिए टेक्स्ट को कैसे फ़ॉर्मैट कर सकते हैं. इन मैसेज में इनमें से कोई भी जानकारी शामिल हो सकती है:

• रिच टेक्स्ट, जिसमें हाइपरलिंक शामिल हों या किसी चैट स्पेस में एक या सभी उपयोगकर्ताओं को @mention किया गया हो.
• कार्ड इंटरफ़ेस में दिखने वाला टेक्स्ट. इसमें पैराग्राफ़ टेक्स्ट या आइकॉन के साथ दिखने वाला यूज़र इंटरफ़ेस (यूआई) टेक्स्ट शामिल है. जैसे, बटन.

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

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

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

उदाहरण के लिए, यहां दिया गया 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 इसे लिंक टेक्स्ट के तौर पर इस्तेमाल करता है. साथ ही, उस टेक्स्ट को दिए गए यूआरएल से अपने-आप हाइपरलिंक कर देता है.

अपने लिंक के लिए कोई दूसरा लिंक टेक्स्ट देने के लिए, इस सिंटैक्स का इस्तेमाल करें:

पाइप और लिंक टेक्स्ट ज़रूरी नहीं है, इसलिए <https://www.example.com/> और https://www.example.com/ एक जैसे हैं.

टेक्स्ट मैसेज में पसंद के मुताबिक बनाए गए इमोजी का इस्तेमाल करना

चैट ऐप्लिकेशन, मैसेज को ज़्यादा दिलचस्प बनाने के लिए, पसंद के मुताबिक बनाए गए इमोजी के साथ टेक्स्ट मैसेज भेज सकते हैं. पसंद के मुताबिक बनाए गए इमोजी सिर्फ़ Google Workspace संगठनों के लिए उपलब्ध हैं. साथ ही, एडमिन को संगठन के लिए, पसंद के मुताबिक बनाए गए इमोजी की सुविधा चालू करनी होगी. ज़्यादा जानकारी के लिए, Google Chat में पसंद के मुताबिक बनाए गए इमोजी के बारे में जानकारी और पसंद के मुताबिक बनाए गए इमोजी इस्तेमाल करने की अनुमतियां मैनेज करना लेख पढ़ें.

पसंद के मुताबिक बनाए गए इमोजी वाले मैसेज बनाने के लिए, आपके ऐप्लिकेशन को उपयोगकर्ता की पुष्टि करने की सुविधा का इस्तेमाल करना होगा. कस्टम इमोजी का इस्तेमाल, वेबबुक के तौर पर बनाए गए मैसेज या ऐप्लिकेशन की पुष्टि करके बनाए गए मैसेज में नहीं किया जा सकता.

मैसेज के टेक्स्ट में कस्टम इमोजी जोड़ने के लिए, customEmoji संसाधन का name या emoji_name तय करें:

{
    "text": "Hello <customEmojis/CUSTOM_EMOJI_ID>."
}

इस सैंपल का इस्तेमाल करने के लिए, CUSTOM_EMOJI_ID को कस्टम इमोजी के आईडी से बदलें. यह आईडी, customEmoji संसाधन के name या emoji_name फ़ील्ड में देखा जा सकता है.

टेक्स्ट मैसेज में लोगों का नाम टैग करना

Chat ऐप्लिकेशन, Chat स्पेस में मौजूद किसी एक या सभी उपयोगकर्ताओं को @mention करके टेक्स्ट मैसेज भेज सकते हैं. अगर आपको उन उपयोगकर्ताओं को टैग करना है जिन्होंने स्पेस जॉइन नहीं किया है या इंपोर्ट मोड में मौजूद स्पेस को टैग करना है, तो Chat ऐप्लिकेशन को उपयोगकर्ता की पुष्टि के साथ मैसेज भेजना होगा.

किसी खास उपयोगकर्ता का नाम टैग करना

किसी उपयोगकर्ता को @mention करने के लिए, उस टेक्स्ट मैसेज में <users/{user}> जोड़ें जहां <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 ऐप्लिकेशन को उपयोगकर्ता के तौर पर पुष्टि करनी होगी.

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

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

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

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

कार्ड में दिखने वाले टेक्स्ट को फ़ॉर्मैट करना

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

Card Builder का इस्तेमाल करके, Chat ऐप्लिकेशन के लिए मैसेजिंग और यूज़र इंटरफ़ेस डिज़ाइन करें और उनकी झलक देखें:

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

यहां दी गई टेबल में, इस्तेमाल किए जा सकने वाले टैग और उनके मकसद के बारे में बताया गया है:

सूचियां और कोड ब्लॉक तय करने के लिए, इन टैग का इस्तेमाल करें:

This is a code block.

मार्कडाउन सिंटैक्स चालू होने पर, इस सिंटैक्स का इस्तेमाल किया जा सकता है:

टेक्स्ट में आइकॉन जोड़ना

कार्ड में टेक्स्ट के साथ आइकॉन दिखाने के लिए, DecoratedText और ButtonList विजेट का इस्तेमाल किया जा सकता है.

इन सेक्शन में, डेकोरेट किए गए टेक्स्ट या बटन में पहले से मौजूद आइकॉन, Google मटीरियल आइकॉन या कस्टम आइकॉन इस्तेमाल करने का तरीका बताया गया है.

Chat के आइकॉन इस्तेमाल करना

Chat में उपलब्ध बिल्ट-इन आइकॉन का इस्तेमाल करने के लिए, इनमें से कोई एक विकल्प चुनें:

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

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

Google के मटीरियल आइकॉन का इस्तेमाल करना

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

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

कस्टम आइकॉन इस्तेमाल करना

कस्टम आइकॉन जोड़ने के लिए, iconUrl फ़ील्ड शामिल करें और आइकॉन का यूआरएल डालें.

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