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

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

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

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

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

Chat API का इस्तेमाल करके भेजे गए या वापस लाए गए मैसेज के लिए, स्टैंडर्ड मार्कडाउन सिंटैक्स (MARKUP_SYNTAX_MARKDOWN) या Chat मार्कअप सिंटैक्स (MARKUP_SYNTAX_CHAT) का इस्तेमाल किया जा सकता है. Google Cloud Console में, ऐप्लिकेशन-लेवल पर डिफ़ॉल्ट मार्कअप सिंटैक्स कॉन्फ़िगर किया जा सकता है. इसके लिए, Google Chat API को कॉन्फ़िगर करना लेख पढ़ें:

• मार्कडाउन: स्टैंडर्ड मार्कडाउन सिंटैक्स (MARKUP_SYNTAX_MARKDOWN). यह CommonMark की खास बातों पर आधारित है. इसमें कुछ और एक्सटेंशन भी शामिल हैं. नए चैट ऐप्लिकेशन के लिए, डिफ़ॉल्ट रूप से Markdown का इस्तेमाल किया जाता है.
• Chat: Chat मार्कअप सिंटैक्स (MARKUP_SYNTAX_CHAT). मौजूदा Chat ऐप्लिकेशन, डिफ़ॉल्ट रूप से Chat पर सेट होते हैं, ताकि पुराने सिस्टम के साथ काम करने की सुविधा बनी रहे.

ऐप्लिकेशन-लेवल पर डिफ़ॉल्ट सेटिंग को बदलने के लिए, Chat API के अलग-अलग अनुरोधों पर markup_syntax भी तय किया जा सकता है. जब एपीआई अनुरोध में markup_syntax की वैल्यू नहीं दी जाती है, तो मार्कअप इस आधार पर सेट होता है कि Chat API को कैसे कॉल किया जाता है:

• कॉन्फ़िगर किए गए Chat ऐप्लिकेशन: Chat API के कॉन्फ़िगरेशन पेज पर सेव किए गए मार्कअप सिंटैक्स का इस्तेमाल करता है.
• कॉन्फ़िगर नहीं किए गए Cloud प्रोजेक्ट (बिना कॉन्फ़िगरेशन वाले): अगर आपका Cloud प्रोजेक्ट, Chat ऐप्लिकेशन के सेव किए गए कॉन्फ़िगरेशन के बिना Chat API को कॉल करता है, तो अनुरोध डिफ़ॉल्ट रूप से MARKUP_SYNTAX_MARKDOWN पर सेट हो जाते हैं.
• इनकमिंग वेबहुक: डिफ़ॉल्ट रूप से, यह MARKUP_SYNTAX_CHAT पर सेट होता है. इनकमिंग वेबहुक का इस्तेमाल करके मैसेज भेजना देखें.

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

उदाहरण के लिए, यह 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 में दिखने वाला टेक्स्ट
  [Example website](https://example.com)	Example website

• स्टैंडर्ड सादे टेक्स्ट वाले मैसेज के लिए, पाइप सिंटैक्स का इस्तेमाल करें:

  सिंटैक्स का उदाहरण	Google Chat में दिखने वाला टेक्स्ट
  <https://example.com|Example website>	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 फ़ील्ड में देखा जा सकता है.

अगर आपका ऐप्लिकेशन, Markdown सिंटैक्स का इस्तेमाल करके मैसेज भेजता है, तो कस्टम इमोजी आईडी का इस्तेमाल करके, एचटीएमएल टैग फ़ॉर्मैट में कस्टम इमोजी तय किए जा सकते हैं:

{
  "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 को कस्टम इमोजी के शॉर्टकोड नाम से बदलें.

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

चैट ऐप्लिकेशन, चैट स्पेस में मौजूद एक या सभी उपयोगकर्ताओं को @टैग करके, टेक्स्ट मैसेज भेज सकते हैं. चैट ऐप्लिकेशन, उन उपयोगकर्ताओं को भी टैग कर सकते हैं जो स्पेस में शामिल नहीं हैं या इंपोर्ट मोड में मौजूद स्पेस के सदस्य हैं.

साइलेंट मैसेज में उपयोगकर्ताओं को टैग नहीं किया जा सकता. साइलेंट मैसेज में किसी व्यक्ति को टैग करने पर, गड़बड़ी का मैसेज दिखता है.

चुनिंदा उपयोगकर्ताओं को टैग करना

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

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

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

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

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

अगर आपका ऐप्लिकेशन Markdown सिंटैक्स का इस्तेमाल करके मैसेज भेजता है, तो chat-user एचटीएमएल टैग फ़ॉर्मैट का इस्तेमाल करके, टैग करने की जानकारी दें:

{
  "text": "Important message for <chat-user data-user=\"users/all\">: Code freeze starts at midnight tonight!"
}

मैसेज में उद्धरण जोड़ना

चैट ऐप्लिकेशन, टेक्स्ट मैसेज में उद्धरण शामिल कर सकते हैं. इससे उपयोगकर्ताओं को सोर्स की पूरी जानकारी मिलती है. सोर्स दो तरीकों से उपलब्ध कराए जा सकते हैं:

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

उद्धरण सिर्फ़ तब काम करते हैं, जब मैसेज का markupSyntax, MARKUP_SYNTAX_MARKDOWN पर सेट हो. यह सुविधा, Chat API का इस्तेमाल करके एसिंक्रोनस मैसेज बनाने पर ही काम करती है.

किसी मैसेज में इनलाइन उद्धरण जोड़ने के लिए:

1. मैसेज elements की citations सूची में सोर्स उपलब्ध कराएं. साथ ही, हर Citation ऑब्जेक्ट को एक यूनीक id असाइन करें.
2. मैसेज के टेक्स्ट में, उस टेक्स्ट को रैप करें जिसे आपको 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 ऐप्लिकेशन के लिए मैसेज और यूज़र इंटरफ़ेस डिज़ाइन करें और उनकी झलक देखें:

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

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

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

This is a code block.

Markdown

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

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

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

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

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

Chat में पहले से मौजूद आइकॉन का इस्तेमाल करने के लिए, इनमें से कोई एक विकल्प चुनें:

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

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

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

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

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

मनमुताबिक आइकॉन इस्तेमाल करना

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

यहां पसंद के आइकॉन का एक उदाहरण दिया गया है: