Google Chat इस्तेमाल करने वालों को निजी मैसेज भेजना

यह पेज बताता है कि किस तरह निजी मैसेज बनाए और भेजे जा सकते हैं Google Chat ऐप्लिकेशन.

निजी मैसेज, Chat ऐप्लिकेशन का ऐसा मैसेज होता है जो सिर्फ़ चुनिंदा Chat उपयोगकर्ता को दिखे. निजी मैसेज का इस्तेमाल यहां किया जा सकता है: एक से ज़्यादा लोगों के साथ स्पेस बनाना, ताकि वे निजी तौर पर बातचीत कर सकें चैट ऐप्लिकेशन. उदाहरण के लिए, आपके Chat ऐप्लिकेशन, इनमें से कोई भी काम करने के लिए निजी तौर पर मैसेज भेज सकता है फ़ॉलो किया जा रहा है:

  • स्लैश कमांड का जवाब दें. उदाहरण के लिए, अगर जब कोई उपयोगकर्ता आपके Chat ऐप्लिकेशन का /about स्लैश शुरू करता है कमांड का इस्तेमाल करते हैं, तो आपका Chat ऐप्लिकेशन निजी मैसेज, जो आपके Chat ऐप्लिकेशन के बारे में जानकारी देता है इस्तेमाल करता है और कैसे करता है.
  • ऐसी जानकारी सूचित करें या भेजें जो केवल एक उपयोगकर्ता के लिए प्रासंगिक हो. इसके लिए उदाहरण के लिए, उपयोगकर्ता को सूचित करें कि उन्हें कोई टास्क असाइन किया गया है या उन्हें याद दिलाएं कि टास्क पूरा करने के लिए.
  • गड़बड़ी का मैसेज भेजें. उदाहरण के लिए, अगर कोई उपयोगकर्ता ज़रूरी आर्ग्युमेंट टेक्स्ट को छोड़ देता है स्लैश कमांड के लिए, Chat ऐप्लिकेशन किसी निजी मैसेज भेजने की कोशिश करें.
  • जब किसी उपयोगकर्ता को स्पेस में जोड़ा जाए, तो उसे निजी तौर पर वेलकम मैसेज भेजें दिशा-निर्देशों के बारे में बताती है या Chat ऐप्लिकेशन को इस्तेमाल करने का तरीका बताती है.

जब कोई Chat ऐप्लिकेशन निजी मैसेज भेजता है, तो एक लेबल दिखाता है, जिससे उपयोगकर्ता को यह सूचना मिलती है कि मैसेज सिर्फ़ उन्हें दिखेगा:

इसके लिए निजी मैसेज
  Cymbal Labs का चैट ऐप्लिकेशन. मैसेज में लिखा है कि
  Chat ऐप्लिकेशन को Cymbal Labs ने बनाया है और इसमें एक लिंक शेयर किया गया है
  दस्तावेज़ के साथ-साथ सहायता टीम से संपर्क करने के लिए एक लिंक भी पाएं.
पहली इमेज: जब कोई चैट ऐप्लिकेशन निजी मैसेज है, तो उपयोगकर्ता को लेबल वाला मैसेज दिखता है जिसमें Only visible to you लिखा है.

ज़रूरी शर्तें

Node.js

  • Google Chat ऐप्लिकेशन, जिसमें इंटरैक्टिव सुविधाएं चालू हैं. बनाने के लिए इंटरैक्टिव चैट ऐप्लिकेशन के लिए एचटीटीपी सेवा का इस्तेमाल करें. इस क्विकस्टार्ट को पूरा करें.
  • किसी स्लैश निर्देश का निजी तौर पर जवाब देने के लिए, Chat ऐप्लिकेशन. इसे बनाने के लिए, देखें स्लैश कमांड का जवाब दें.

  • मैसेज भेजने के लिए messages.create() तरीका है, तो आपको ऐप्लिकेशन की पुष्टि करने की सुविधा का इस्तेमाल करना होगा.

Python

  • Google Chat ऐप्लिकेशन, जिसमें इंटरैक्टिव सुविधाएं चालू हैं. बनाने के लिए इंटरैक्टिव चैट ऐप्लिकेशन के लिए एचटीटीपी सेवा का इस्तेमाल करें. इस क्विकस्टार्ट को पूरा करें.
  • किसी स्लैश निर्देश का निजी तौर पर जवाब देने के लिए, Chat ऐप्लिकेशन. इसे बनाने के लिए, देखें स्लैश कमांड का जवाब दें.

  • मैसेज भेजने के लिए messages.create() तरीका है, तो आपको ऐप्लिकेशन की पुष्टि करने की सुविधा का इस्तेमाल करना होगा.

Apps Script

  • Google Chat ऐप्लिकेशन, जिसमें इंटरैक्टिव सुविधाएं चालू हैं. बनाने के लिए Apps Script में इंटरैक्टिव चैट ऐप्लिकेशन के साथ, इस क्विकस्टार्ट की प्रोसेस को पूरा करें.
  • किसी स्लैश निर्देश का निजी तौर पर जवाब देने के लिए, Chat ऐप्लिकेशन. इसे बनाने के लिए, देखें स्लैश कमांड का जवाब दें.

  • मैसेज भेजने के लिए messages.create() तरीका है, तो आपको ऐप्लिकेशन की पुष्टि करने की सुविधा का इस्तेमाल करना होगा.

निजी मैसेज भेजें

Chat ऐप्लिकेशन के तौर पर निजी तौर पर मैसेज भेजने के लिए, यह privateMessageViewer फ़ील्ड में भी डाली जा सकती है. आप बिलकुल वैसे ही निजी मैसेज बनाते हैं कोई भी मैसेज बनाते हैं: उपयोगकर्ता इंटरैक्शन का जवाब देकर या Google Chat API को एसिंक्रोनस तरीके से create() तरीका Message संसाधन. मैसेज या कार्ड मैसेज भेजने का तरीका जानने के लिए, देखें मैसेज भेजें.

इस उदाहरण में, एक निजी मैसेज के लिए JSON दिखाया गया है. इस मैसेज में लिखा है Hello private world!:

{
    "text": "Hello private world!",
    "privateMessageViewer": "USER"
}

इस उदाहरण में, USER, Chat इस्तेमाल करने वाले मैसेज को कौन देख सकता है. इस फ़ॉर्मैट में यह User संसाधन. अगर किसी उपयोगकर्ता इंटरैक्शन के दौरान, आपके पास इंटरैक्शन इवेंट से User ऑब्जेक्ट तय करने का विकल्प होता है. उदाहरण के लिए, यह सेक्शन देखें स्लैश कमांड का निजी तौर पर जवाब दें.

या फिर, निजी मैसेज के लिए दर्शक तय करने के लिए आप User का name फ़ील्ड संसाधन:

{
    "text": "Hello private world!",
    "privateMessageViewer": {
      "name": "users/USER_ID"
    }
}

इस उदाहरण में, व्यूअर के User की जानकारी देने के लिए, name फ़ील्ड का इस्तेमाल किया गया है Google Chat में संसाधन का नाम डालें. USER_ID बदलें से अलग है, जैसे कि 12345678987654321 या hao@cymbalgroup.com.

उपयोगकर्ताओं की जानकारी देने के बारे में ज़्यादा जानने के लिए, देखें Google Chat इस्तेमाल करने वाले लोगों की पहचान करें और उनके बारे में बताएं.

स्लैश निर्देश का निजी तौर पर जवाब दें

नीचे दिया गया कोड, चैट ऐप्लिकेशन का एक उदाहरण दिखाता है जो एक निजी मैसेज के साथ स्लैश कमांड का जवाब देता है.

Chat ऐप्लिकेशन, MESSAGE इंटरैक्शन इवेंट और /help स्लैश कमांड का जवाब एक निजी मैसेज के साथ देता है इस्तेमाल करने का तरीका बताता है:

Node.js

/**
* Responds to a MESSAGE event in Google Chat.
*
* @param {!Object} req Request sent from Google Chat app
* @param {!Object} res Response to send back
*
* @return {!Object} respond to slash command
*/
exports.onMessage = function onMessage(req, res) {
  if (req.method === 'GET' || !req.body.message) {
    return res.send('Hello! This function is meant to be used in Google Chat app.');
  }

  const event = req.body;

  // Checks for the presence of event.message.slashCommand.
  // If the slash command is "/help", responds with a private text message.
  if (event.message.slashCommand) {
    switch (event.message.slashCommand.commandId) {
      case '1':  // /help
        return res.json({
          privateMessageViewer: event.user,
          text: 'This Chat app was created by Cymbal Labs. To get help with this app, <https://cymbalgroup.com/docs|see our documentation> or <https://cymbalgroup.com/support|contact our support team>.'
        });
    }
  }

  // If the Chat app doesn't detect a slash command, it responds
  // with a private text message
  return res.json({
    privateMessageViewer: event.user,
    text: 'Try a slash command.'
  });
};

Apps Script

/**
* Responds to a MESSAGE event in Google Chat.
*
* @param {Object} event the event object from Google Chat
*/
function onMessage(event) {
  if (event.message.slashCommand) {
    switch (event.message.slashCommand.commandId) {
      case 1: // Responds to /help
        return {
          "privateMessageViewer": event.user,
          "text": "This Chat app was created by Cymbal Labs. To get help with this app, <https://cymbalgroup.com/docs|see our documentation> or <https://cymbalgroup.com/support|contact our support team>."
        };
    }
  }
  else {
    return { "text": "Try a slash command.", "privateMessageViewer": event.user };
  }
}

Python

from typing import Any, Mapping

import flask
import functions_framework

@functions_framework.http
def main(req: flask.Request) -> Mapping[str, Any]:
  """Responds to a MESSAGE event in Google Chat.

  Args:
      req (flask.Request): the event object from Chat API.

  Returns:
      Mapping[str, Any]: open a Dialog in response to a card's button click.
  """
  if req.method == 'GET':
    return 'Hello! This function must be called from Google Chat.'

  request = req.get_json(silent=True)

  # Checks for the presence of event.message.slashCommand.
  # If the slash command is "/help", responds with a private text message.
  if request.get('message', {}).get('slashCommand'):
    command_id = request.get('message', {}).get('slashCommand').get('commandId')
    if command_id == '1':  # /help
      return {
          'privateMessageViewer': request.get('user'),
          'text': (
              'This Chat app was created by Cymbal Labs. To get help with this'
              ' app, <https://cymbalgroup.com/docs|see our documentation> or'
              ' <https://cymbalgroup.com/support|contact our support team>.'
          ),
      }

  return {
      'privateMessageViewer': request.get('user'),
      'text': 'Try a slash command.',
  }

सीमाएं

निजी मैसेज भेजने के लिए, मैसेज में फ़ॉलो किया जा रहा है:

  • अटैचमेंट.
  • ऐक्सेसरी ऐक्शन.
  • कुछ-कुछ निजी मैसेज. उदाहरण के लिए, कोई Chat ऐप्लिकेशन ऐसे मैसेज नहीं भेज सकते जिसमें टेक्स्ट और कार्ड सिर्फ़ उन्हें दिखता हो एक उपयोगकर्ता के तौर पर शामिल हों, लेकिन स्पेस के सभी सदस्य इसे देख सकें.
  • उपयोगकर्ता की पुष्टि करना. सिर्फ़ चैट ऐप्लिकेशन निजी मैसेज भेज सकते हैं. इसलिए, Chat ऐप्लिकेशन, उपयोगकर्ता के तौर पर पुष्टि नहीं कर सकता कि निजी तौर पर मैसेज भेजते हैं.

निजी मैसेज अपडेट करना या मिटाना

Google Chat के मैसेज अपडेट करने या मिटाने के लिए, आपको Chat API. आप निजी मैसेज का व्यूअर नहीं बदल सकते या तो मैसेज को सार्वजनिक किया जा सकता है. इसलिए, जब आप निजी मैसेज को अपडेट करते हैं, तो आपको एपीआई कॉल में privateMessageViewer फ़ील्ड (यह फ़ील्ड सिर्फ़ आउटपुट के लिए है).

कोई निजी मैसेज अपडेट करने के लिए, देखें कोई मैसेज अपडेट करें. कोई निजी मैसेज मिटाने के लिए, देखें किसी मैसेज को मिटाना.