मैसेज भेजना

इस गाइड में उन अलग-अलग तरीकों के बारे में बताया गया है जिनका इस्तेमाल करके, Google Chat ऐप्लिकेशन भेज सकते हैं संदेश:

  • उपयोगकर्ता की टिप्पणियों का जवाब देकर, रीयल टाइम में मैसेज और कार्ड मैसेज भेजें इंटरैक्शन.
  • create तरीके को चालू करके, एसिंक्रोनस तरीके से मैसेज और कार्ड मैसेज भेजें Message संसाधन.
  • मैसेज थ्रेड शुरू करें या उसका जवाब दें.
  • मैसेज भेजें और उसे नाम दें.

कॉन्टेंट बनाने Message संसाधन का प्रतिनिधित्व करता है टेक्स्ट या कार्ड Google Chat में मैसेज भेजने की सुविधा मिलती है. आप Google Chat API में कॉल करके, create, get, update या delete को किसी मैसेज की मदद से संबंधित तरीकों का इस्तेमाल करना होगा. टेक्स्ट और कार्ड मैसेज के बारे में ज़्यादा जानने के लिए, देखें Google Chat मैसेज की खास जानकारी.

मैसेज का साइज़ ज़्यादा से ज़्यादा 32,000 बाइट होना चाहिए. इसमें कोई भी टेक्स्ट या कार्ड शामिल है. अगर कोई मैसेज इस साइज़ से बड़ा है, तो आपका Chat ऐप्लिकेशन के बजाय कई मैसेज भेज सकते हैं.

इसके लिए, Message संसाधन पर create तरीके को कॉल करने के बजाय Google Chat API का इस्तेमाल करके, एसिंक्रोनस तरीके से टेक्स्ट या कार्ड मैसेज भेजा जा सकता है. Google Chat ऐप्लिकेशन भी उपयोगकर्ता के इंटरैक्शन का जवाब देने के लिए मैसेज बना सकते हैं रीयल टाइम में होता है. उपयोगकर्ता के इंटरैक्शन से जुड़े जवाबों के लिए, पुष्टि करने की ज़रूरत नहीं होती और अन्य तरह के मैसेज को सपोर्ट किया जा सकता है. इनमें इंटरैक्टिव डायलॉग और लिंक शामिल हैं झलक. जानकारी के लिए, यह देखें Google Chat ऐप्लिकेशन से होने वाली बातचीत की जानकारी पाना और उनका जवाब देना.

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

Node.js

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

Python

  • Google Workspace खाता, जिसके पास इसका ऐक्सेस है Google Chat.
  • Python 3.6 या इससे नया वर्शन
  • पीआईपी पैकेज मैनेजमेंट टूल
  • Python के लिए, Google की नई क्लाइंट लाइब्रेरी. उन्हें इंस्टॉल या अपडेट करने के लिए, अपने कमांड-लाइन इंटरफ़ेस में यह कमांड चलाएं:

    pip3 install --upgrade google-api-python-client google-auth
    
  • ऐसा Google Cloud प्रोजेक्ट जिसमें Google Chat API चालू हो और उसे कॉन्फ़िगर किया गया हो. इसका तरीका जानने के लिए, यह देखें कोई Google Chat ऐप्लिकेशन बनाएं.
  • Chat ऐप्लिकेशन, मैसेज भेजने की अनुमति देने वाली सेटिंग को कॉन्फ़िगर कर दिया गया है एसिंक्रोनस मैसेज नहीं दिखेंगे. भेजने के लिए, अनुमति देने के किसी कॉन्फ़िगरेशन की ज़रूरत नहीं है रीयल टाइम में मैसेज भेजने की सुविधा मिलती है.

Apps Script

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

मैसेज भेजना

इस सेक्शन में बताया गया है कि मैसेज भेजने के लिए नीचे दिए दो तरीके कैसे इस्तेमाल करें:

  • उपयोगकर्ता के इंटरैक्शन का जवाब देकर, रीयल टाइम में मैसेज भेजें.
  • Google Chat API को एसिंक्रोनस तरीके से कॉल करके मैसेज भेजें.

रीयल टाइम में मैसेज भेजना

इस उदाहरण में, आपका Chat ऐप्लिकेशन, टेक्स्ट बनाकर उसे भेजता है मैसेज दिखता है. सबसे सही तरीकों के बारे में जानने के लिए, उपयोगकर्ताओं को शामिल करते हुए, लोगों और स्पेस में शामिल होने की प्रक्रिया को शुरू करने में मदद करें.

जब कोई उपयोगकर्ता आपका Chat ऐप्लिकेशन जोड़ता है, तो आपको मैसेज भेजने के लिए को स्पेस में, आपके Chat ऐप्लिकेशन को ADDED_TO_SPACE का जवाब देता है इंटरैक्शन इवेंट. जवाब देने के लिए मैसेज वाले ADDED_TO_SPACE इंटरैक्शन इवेंट के लिए, इस कोड का इस्तेमाल करें:

Node.js

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} event The event object from Chat API.
 * @return {Object} Response from the Chat app. An onboarding message that
 * introduces the app and helps people get started with it.
 */
exports.onMessage = function onMessage(req, res) {
  if (req.method === 'GET' || !req.body.message) {
    res.send(
      'Hello! This function is meant to be used in a Google Chat space.');
  }

  // Send an onboarding message when added to a Chat space
  if (req.body.type === 'ADDED_TO_SPACE') {
    res.json({
      'text': 'Hi, Cymbal at your service. I help you manage your calendar
      from Google Chat. Take a look at your schedule today by typing
      `/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To
      learn what else I can do, type `/help`.'
    });
  }
};

Apps Script

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} event The event object from Chat API.
 * @return {Object} Response from the Chat app. An onboarding message that
 * introduces the app and helps people get started with it.
 */
function onAddToSpace(event) {

  return {
    'text': 'Hi, Cymbal at your service. I help you manage your calendar
    from Google Chat. Take a look at your schedule today by typing
    `/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To learn
    what else I can do, type `/help`.'
  }
}

कोड सैंपल, नीचे दिया गया टेक्स्ट मैसेज दिखाता है:

शामिल होने के मैसेज का उदाहरण.

एसिंक्रोनस रूप से लेख संदेश भेजें

निम्न अनुभाग के साथ एक लेख संदेश को असिंक रूप से भेजने का तरीका ऐप्लिकेशन की पुष्टि करने और उपयोगकर्ता की पुष्टि करने की प्रक्रिया.

मैसेज भेजने के लिए, अपने अनुरोध में यह जानकारी दें:

  • ऐप्लिकेशन की पुष्टि करने की सुविधा के साथ, chat.bot की अनुमति का दायरा तय करें. के साथ उपयोगकर्ता की पुष्टि करने के लिए, chat.messages.create की अनुमति का दायरा बताएं.
  • कॉल करें create तरीका पूरी तरह कैसे Message संसाधन.

ऐप्लिकेशन की पुष्टि करने के लिए मैसेज भेजें

यहां बताया गया है कि इनसे मैसेज कैसे भेजें ऐप्लिकेशन की पुष्टि करना:

Python

  1. अपनी वर्किंग डायरेक्ट्री में, chat_create_text_message_app.py.
  2. chat_create_text_message_app.py में यह कोड शामिल करें:

    from apiclient.discovery import build
    from google.oauth2 import service_account
    
    # Specify required scopes.
    SCOPES = ['https://www.googleapis.com/auth/chat.bot']
    
    # Specify service account details.
    CREDENTIALS = service_account.Credentials.from_service_account_file(
        'credentials.json', scopes=SCOPES)
    
    # Build the URI and authenticate with the service account.
    chat = build('chat', 'v1', credentials=CREDENTIALS)
    
    # Create a Chat message.
    result = chat.spaces().messages().create(
    
        # The space to create the message in.
        #
        # Replace SPACE with a space name.
        # Obtain the space name from the spaces resource of Chat API,
        # or from a space's URL.
        parent='spaces/SPACE',
    
        # The message to create.
        body={'text': 'Hello, world!'}
    
    ).execute()
    
    print(result)
    
  3. कोड में, SPACE को एक स्पेस नाम से बदलें, जो तो आपको यहां से spaces.list() तरीका या स्पेस के यूआरएल से मिलेगी.

  4. अपनी वर्किंग डायरेक्ट्री में, सैंपल बनाएं और चलाएं:

    python3 chat_create_text_message_app.py
    

Chat API, Message भेजे गए मैसेज की पूरी जानकारी मिलेगी.

उपयोगकर्ता की पुष्टि करने के साथ मैसेज भेजें

यहां बताया गया है कि इनसे मैसेज कैसे भेजें उपयोगकर्ता की पुष्टि करना:

Python

  1. अपनी वर्किंग डायरेक्ट्री में, chat_create_text_message_user.py.
  2. chat_create_text_message_user.py में यह कोड शामिल करें:

    import os.path
    
    from google.auth.transport.requests import Request
    from google.oauth2.credentials import Credentials
    from google_auth_oauthlib.flow import InstalledAppFlow
    from googleapiclient.discovery import build
    from googleapiclient.errors import HttpError
    
    # Define your app's authorization scopes.
    # When modifying these scopes, delete the file token.json, if it exists.
    SCOPES = ["https://www.googleapis.com/auth/chat.messages.create"]
    
    def main():
        '''
        Authenticates with Chat API via user credentials,
        then creates a text message in a Chat space.
        '''
    
        # Start with no credentials.
        creds = None
    
        # Authenticate with Google Workspace
        # and get user authorization.
        flow = InstalledAppFlow.from_client_secrets_file(
                        'client_secrets.json', SCOPES)
        creds = flow.run_local_server()
    
        # Build a service endpoint for Chat API.
        chat = build('chat', 'v1', credentials=creds)
    
        # Use the service endpoint to call Chat API.
        result = chat.spaces().messages().create(
    
            # The space to create the message in.
            #
            # Replace SPACE with a space name.
            # Obtain the space name from the spaces resource of Chat API,
            # or from a space's URL.
            parent='spaces/SPACE',
    
            # The message to create.
            body={'text': 'Hello, world!'}
    
        ).execute()
    
        # Prints details about the created message.
        print(result)
    
    if __name__ == '__main__':
        main()
    
  3. कोड में, SPACE को एक स्पेस नाम से बदलें, जो तो आपको यहां से spaces.list() तरीका Chat API या स्पेस के यूआरएल से.

  4. अपनी वर्किंग डायरेक्ट्री में, सैंपल बनाएं और चलाएं:

    python3 chat_create_text_message_user.py
    

Chat API, Message भेजे गए मैसेज की पूरी जानकारी मिलेगी.

कार्ड मैसेज भेजें

इस सेक्शन में, कार्ड मैसेज भेजने के इन दो तरीकों के बारे में बताया गया है:

  • उपयोगकर्ता के इंटरैक्शन का जवाब देकर, रीयल टाइम में कार्ड मैसेज भेजें.
  • Google Chat API को एसिंक्रोनस तरीके से कॉल करके कार्ड मैसेज भेजें.

रीयल टाइम में कार्ड मैसेज भेजें

किसी उपयोगकर्ता को जवाब देने के लिए, चैट ऐप्लिकेशन कार्ड मैसेज बना सकते हैं इंटरैक्शन, जैसे कि जब कोई उपयोगकर्ता किसी चैट ऐप्लिकेशन को भेजता है या स्पेस में Chat ऐप्लिकेशन को जोड़ता है. ज़्यादा जानकारी के लिए तो उपयोगकर्ता के इंटरैक्शन पर प्रतिक्रिया देने के बारे में जानने के लिए, यह जानकारी पाना और जवाब देना Chat ऐप्लिकेशन इंटरैक्शन इवेंट में बदल सकते हैं.

इस उदाहरण में, कोई उपयोगकर्ता किसी चैट ऐप्लिकेशन पर मैसेज भेजता है और Chat ऐप्लिकेशन, कार्ड मैसेज भेजकर जवाब देता है जो उपयोगकर्ता का नाम और अवतार इमेज दिखाता है:

Chat ऐप्लिकेशन, भेजने वाले का डिसप्ले नेम और अवतार दिखाने वाले कार्ड के साथ जवाब देता है
इमेज.

Node.js

node/avatar-app/index.js
/**
 * Google Cloud Function that responds to messages sent from a
 * Google Chat room.
 *
 * @param {Object} req Request sent from Google Chat room
 * @param {Object} res Response to send back
 */
exports.helloChat = function helloChat(req, res) {
  if (req.method === 'GET' || !req.body.message) {
    res.send('Hello! This function is meant to be used in a Google Chat ' +
      'Room.');
  }

  const sender = req.body.message.sender.displayName;
  const image = req.body.message.sender.avatarUrl;

  const data = createMessage(sender, image);

  res.send(data);
};

/**
 * Creates a card with two widgets.
 * @param {string} displayName the sender's display name
 * @param {string} imageUrl the URL for the sender's avatar
 * @return {Object} a card with the user's avatar.
 */
function createMessage(displayName, imageUrl) {
  const cardHeader = {
    title: `Hello ${displayName}!`,
  };

  const avatarWidget = {
    textParagraph: {text: 'Your avatar picture: '},
  };

  const avatarImageWidget = {
    image: {imageUrl},
  };

  const avatarSection = {
    widgets: [
      avatarWidget,
      avatarImageWidget,
    ],
  };

  return {
    text: 'Here\'s your avatar',
    cardsV2: [{
      cardId: 'avatarCard',
      card: {
        name: 'Avatar Card',
        header: cardHeader,
        sections: [avatarSection],
      }
    }],
  };
}

Python

python/avatar-app/main.py
from typing import Any, Mapping

import flask
import functions_framework


# Google Cloud Function that responds to messages sent in
# Google Chat.
#
# @param {Object} req Request sent from Google Chat.
# @param {Object} res Response to send back.
@functions_framework.http
def hello_chat(req: flask.Request) -> Mapping[str, Any]:
  if req.method == "GET":
    return "Hello! This function must be called from Google Chat."

  request_json = req.get_json(silent=True)

  display_name = request_json["message"]["sender"]["displayName"]
  avatar = request_json["message"]["sender"]["avatarUrl"]

  response = create_message(name=display_name, image_url=avatar)

  return response


# Creates a card with two widgets.
# @param {string} name the sender's display name.
# @param {string} image_url the URL for the sender's avatar.
# @return {Object} a card with the user's avatar.
def create_message(name: str, image_url: str) -> Mapping[str, Any]:
  avatar_image_widget = {"image": {"imageUrl": image_url}}
  avatar_text_widget = {"textParagraph": {"text": "Your avatar picture:"}}
  avatar_section = {"widgets": [avatar_text_widget, avatar_image_widget]}

  header = {"title": f"Hello {name}!"}

  cards = {
      "text": "Here's your avatar",
      "cardsV2": [
          {
              "cardId": "avatarCard",
              "card": {
                  "name": "Avatar Card",
                  "header": header,
                  "sections": [avatar_section],
              },
          }
      ]
  }

  return cards

Apps Script

यह उदाहरण वापस लौटकर एक कार्ड संदेश भेजता है card JSON. Google आपके यूआरएल पैरामीटर को कैसे इस्तेमाल करेगा, यह तय करने के लिए Apps Script कार्ड सेवा.

apps-script/avatar-app/hello-chat.gs
/**
 * Responds to a MESSAGE event in Google Chat.
 *
 * @param {Object} event the event object from Google Chat
 */
function onMessage(event) {
  const displayName = event.message.sender.displayName;
  const avatarUrl = event.message.sender.avatarUrl;

  return createMessage(displayName, avatarUrl);
}

/**
 * Creates a card with two widgets.
 * @param {string} displayName the sender's display name
 * @param {string} avatarUrl the URL for the sender's avatar
 * @return {Object} a card with the sender's avatar.
 */
function createMessage(displayName, avatarUrl) {
  const cardHeader = {
    title: `Hello ${displayName}!`
  };

  const avatarWidget = {
    textParagraph: {text: 'Your avatar picture: '}
  };

  const avatarImageWidget = {
    image: {imageUrl: avatarUrl}
  };

  const avatarSection = {
    widgets: [
      avatarWidget,
      avatarImageWidget
    ],
  };

  return {
    text: 'Here\'s your avatar',
    cardsV2: [{
      cardId: 'avatarCard',
      card: {
        name: 'Avatar Card',
        header: cardHeader,
        sections: [avatarSection],
      }
    }],
  };
}

एसिंक्रोनस रूप से कार्ड मैसेज भेजें

किसी को कार्ड मैसेज, अपने अनुरोध में यह जानकारी दें:

  • ऐप्लिकेशन की पुष्टि करने की सुविधा के साथ, chat.bot की अनुमति का दायरा तय करें. आप ये काम नहीं कर सकते उपयोगकर्ता की पुष्टि करने वाला कार्ड मैसेज भेजें.
  • कॉल करें create तरीका पूरी तरह कैसे Message संसाधन.

कार्ड मैसेज का एक उदाहरण यहां दिया गया है:

Chat API से भेजा गया कार्ड मैसेज.

ऐप्लिकेशन की पुष्टि करने के साथ कार्ड मैसेज भेजने का तरीका यहां बताया गया है:

Python

  1. अपनी वर्किंग डायरेक्ट्री में, chat_create_card_message.py.
  2. chat_create_card_message.py में यह कोड शामिल करें:

    from apiclient.discovery import build
    from google.oauth2 import service_account
    
    # Specify required scopes.
    SCOPES = ['https://www.googleapis.com/auth/chat.bot']
    
    # Specify service account details.
    CREDENTIALS = service_account.Credentials.from_service_account_file(
        'credentials.json', scopes=SCOPES)
    
    # Build the URI and authenticate with the service account.
    chat = build('chat', 'v1', credentials=CREDENTIALS)
    
    # Create a Chat message.
    result = chat.spaces().messages().create(
    
        # The space to create the message in.
        #
        # Replace SPACE with a space name.
        # Obtain the space name from the spaces resource of Chat API,
        # or from a space's URL.
        parent='spaces/SPACE',
    
        # The message to create.
        body=
        {
          'cardsV2': [{
            'cardId': 'createCardMessage',
            'card': {
              'header': {
                'title': 'A card message!',
                'subtitle': 'Created with the Chat API',
                'imageUrl': 'https://developers.google.com/chat/images/chat-product-icon.png',
                'imageType': 'CIRCLE'
              },
              'sections': [
                {
                  'widgets': [
                    {
                      'buttonList': {
                        'buttons': [
                          {
                            'text': 'Read the docs!',
                            'onClick': {
                              'openLink': {
                                'url': 'https://developers.google.com/chat'
                              }
                            }
                          }
                        ]
                      }
                    }
                  ]
                }
              ]
            }
          }]
        }
    
    ).execute()
    
    print(result)
    
  3. कोड में, SPACE को एक स्पेस नाम से बदलें, जो तो आपको यहां से spaces.list तरीका या स्पेस के यूआरएल से मिलेगी.

  4. अपनी वर्किंग डायरेक्ट्री में, सैंपल बनाएं और चलाएं:

    python3 chat_create_card_message.py
    

मैसेज थ्रेड शुरू करें या उसका जवाब दें

मैसेज थ्रेड शुरू करने के लिए, मैसेज भेजें और छोड़ें thread.name खाली; थ्रेड बनाते समय, Google Chat में यह जानकारी अपने-आप भर जाती है. अगर आप चाहें, तो थ्रेड का नाम कस्टमाइज़ करें, और thread.threadKey फ़ील्ड में डालें.

किसी मैसेज थ्रेड का जवाब देने के लिए, वह मैसेज भेजें जो थ्रेड की threadKey या name फ़ील्ड. अगर थ्रेड को किसी व्यक्ति या दूसरे व्यक्ति ने बनाया है चैट ऐप्लिकेशन, आपको thread.name फ़ील्ड का इस्तेमाल करना होगा.

अगर कोई मिलता-जुलता थ्रेड नहीं मिलता है, तो अपने हिसाब से थ्रेड तय किया जा सकता है क्या कोई नया थ्रेड शुरू होना चाहिए या सेटिंग messageReplyOption फ़ील्ड में डालें.

अगर messageReplyOption सेट है, तो आपको thread.name या thread.threadKey को भी सेट करना होगा.

threadKey फ़ील्ड के साथ थ्रेड शुरू करने या उसका जवाब देने का तरीका यहां बताया गया है: nameOfThread:

Python

  1. अपनी वर्किंग डायरेक्ट्री में, chat_create_message_thread.py.
  2. chat_create_message_thread.py में यह कोड शामिल करें:

    from apiclient.discovery import build
    from google.oauth2 import service_account
    
    # Specify required scopes.
    SCOPES = ['https://www.googleapis.com/auth/chat.bot']
    
    # Specify service account details.
    CREDENTIALS = service_account.Credentials.from_service_account_file(
        'credentials.json', scopes=SCOPES)
    
    # Build the URI and authenticate with the service account.
    chat = build('chat', 'v1', credentials=CREDENTIALS)
    
    # Create a Chat message.
    result = chat.spaces().messages().create(
    
        # The space to create the message in.
        #
        # Replace SPACE with a space name.
        # Obtain the space name from the spaces resource of Chat API,
        # or from a space's URL.
        parent='spaces/SPACE',
    
        # Whether to start a thread or reply to an existing one.
        #
        # Required when threading is enabled in a space unless starting a
        # thread.  Ignored in other space types. Threading is enabled when
        # space.spaceThreadingState is THREADED_MESSAGES.
        #
        # REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD replies to an existing thread
        # if one exists, otherwise it starts a new one.
        messageReplyOption='REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD',
    
        # The message body.
        body={
    
            # The message to create.
            'text': 'Start or reply to another message in a thread!',
    
            # The thread to start or reply to.
            'thread': {
                'threadKey': 'nameOfThread'
            }
        }
    
    ).execute()
    
    print(result)
    
  3. कोड में, SPACE को एक स्पेस नाम से बदलें, जो तो आपको यहां से spaces.list तरीका या स्पेस के यूआरएल से मिलेगी.

  4. अपनी वर्किंग डायरेक्ट्री में, सैंपल बनाएं और चलाएं:

    python3 chat_create_message_thread.py
    

Chat API, Message भेजे गए मैसेज की पूरी जानकारी मिलेगी.

मैसेज को नाम देना

यह अनुभाग बताता है कि दिखाई देगा. मैसेज पाने, अपडेट करने या मिटाने के लिए, कस्टम आईडी का इस्तेमाल किया जा सकता है. कस्टम आईडी आपको सिस्टम से असाइन किए गए आईडी को संग्रहित किए बिना मैसेज तय करने देता है मैसेज के संसाधन का नाम (name फ़ील्ड में दिखाया गया). संसाधन नाम में जनरेट हुआ है जवाब का मुख्य हिस्सा समय दिखाई देता है.

उदाहरण के लिए, get() तरीके का इस्तेमाल करके मैसेज वापस पाने के लिए, किस मैसेज को वापस लाना है, यह तय करने के लिए रिसॉर्स का नाम. संसाधन का नाम है spaces/{space}/messages/{message} के तौर पर फ़ॉर्मैट किया गया है, जहां {message} से पता चलता है कि असाइन की गई आईडी होती है. अगर आपने मैसेज को नाम दिया है, तो उसे बदला जा सकता है कस्टम आईडी के साथ {message} की वैल्यू.

किसी मैसेज को नाम देने के लिए, कस्टम आईडी डालें messageId फ़ील्ड में फिर से शामिल करें. messageId फ़ील्ड clientAssignedMessageId Message संसाधन का फ़ील्ड.

मैसेज बनाने के बाद ही उसे नाम दिया जा सकता है. आप नाम नहीं रख सकते या मौजूदा मैसेज के कस्टम आईडी में बदलाव कर सकते हैं. कस्टम आईडी इन शर्तों के मुताबिक होना चाहिए ज़रूरतें:

  • client- से शुरू होता है. उदाहरण के लिए, client-custom-name एक मान्य कस्टम वैल्यू है आईडी है, लेकिन custom-name नहीं है.
  • इसमें 63 वर्ण तक शामिल हैं और सिर्फ़ अंग्रेज़ी के छोटे अक्षर, अंक, और हाइफ़न.
  • हर स्पेस का यूनीक स्पेस होता है. Chat ऐप्लिकेशन, अलग-अलग मैसेज के लिए एक ही कस्टम आईडी.

कस्टम आईडी से मैसेज भेजने का तरीका यहां बताया गया है:

Python

  1. अपनी वर्किंग डायरेक्ट्री में, chat_create_named_message.py.
  2. chat_create_named_message.py में यह कोड शामिल करें:

    from apiclient.discovery import build
    from google.oauth2 import service_account
    
    # Specify required scopes.
    SCOPES = ['https://www.googleapis.com/auth/chat.bot']
    
    # Specify service account details.
    CREDENTIALS = service_account.Credentials.from_service_account_file(
        'credentials.json', scopes=SCOPES)
    
    # Build the URI and authenticate with the service account.
    chat = build('chat', 'v1', credentials=CREDENTIALS)
    
    # Create a Chat message with a custom name.
    result = chat.spaces().messages().create(
    
        # The space to create the message in.
        #
        # Replace SPACE with a space name.
        # Obtain the space name from the spaces resource of Chat API,
        # or from a space's URL.
        parent='spaces/SPACE',
    
        # Custom name for the message used to facilitate later operations.
        messageId='client-NAME',
    
        # The message to create.
        body={'text': 'Hello, world!'}
    
    ).execute()
    
    print(result)
    
  3. कोड में, इन्हें बदलें:

    • SPACE: आपको जिस स्पेस को जोड़ना है उसका आईडी संदेश पोस्ट करें, जिसे आप spaces.list तरीका या स्पेस के यूआरएल से मिलेगी.
    • NAME: मैसेज के लिए पसंद के मुताबिक नाम.
  4. अपनी वर्किंग डायरेक्ट्री में, सैंपल बनाएं और चलाएं:

    python3 chat_create_named_message.py
    

Chat API, Message.

मैसेज के निचले हिस्से में इंटरैक्टिव विजेट जोड़ें

इसके अलावा, ऐक्सेसरी विजेट के साथ मैसेज जोड़े जा सकते हैं. ऐक्सेसरी विजेट, मैसेज में मौजूद किसी टेक्स्ट या कार्ड के बाद दिखते हैं. आप इनका इस्तेमाल कर सकते हैं विजेट आपके मैसेज के साथ कई तरीकों से इंटरैक्ट करने के लिए उपयोगकर्ताओं को सूचना देते हैं. इनमें ये शामिल हैं निम्न:

  • बताएं कि कोई मैसेज कितना सटीक या सही है.
  • मैसेज या Chat ऐप्लिकेशन से जुड़ी समस्या की शिकायत करें.
  • मिलते-जुलते कॉन्टेंट, जैसे कि दस्तावेज़ का लिंक खोलें.
  • Chat ऐप्लिकेशन से मिलते-जुलते मैसेज को खारिज करना या स्नूज़ करना समय कम या ज़्यादा करते हैं.

ऐक्सेसरी विजेट जोड़ने के लिए, accessoryWidgets[] ऑब्जेक्ट को ढूंढने के लिए, एक या एक से ज़्यादा AccessoryWidgets शामिल किए जा सकते हैं. स्पेस के सभी सदस्यों को यह मैसेज दिखना चाहिए (आप निजी मैसेज में ऐक्सेसरी विजेट नहीं जोड़ सकते).

नीचे दी गई इमेज में, जोड़ा जा रहा Chat ऐप्लिकेशन दिखाया गया है ऐक्सेसरी विजेट के साथ मैसेज, ताकि उपयोगकर्ता अपने अनुभव को रेटिंग दे सकें के साथ चैट ऐप्लिकेशन में साइन इन करें.

ऐक्सेसरी विजेट के उदाहरण

नीचे दिया गया कोड सैंपल, इस मैसेज के लिए JSON दिखाता है. जब कोई उपयोगकर्ता क्लिक करता है किसी बटन से इंटरैक्शन होता है, तो इंटरैक्शन उससे जुड़े फ़ंक्शन को ट्रिगर करता है (जैसे कि doUpvote) है जो रेटिंग को प्रोसेस करता है.


 "text": "Rate your experience with this Chat app.",
 "accessoryWidgets": [
   {
     "buttonList": {
       "buttons": [
         {
           "icon": {
             "material_icon": {
               "name": "thumb_up"
             }
           },
           "color": {
             "red": 0,
             "blue": 255,
             "green": 0
           },
           "onClick": {
             "action": {
               "function": "doUpvote",
             }
           }
         },
         {
           "icon": {
             "material_icon": {
               "name": "thumb_down"
             }
           },
           "color": {
             "red": 0,
             "blue": 255,
             "green": 0
           },
           "onClick": {
             "action": {
               "function": "doDownvote",
             }
           }
         }
       ]
     }
   }
 ]

निजी तौर पर मैसेज भेजें

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

ज़्यादा जानकारी के लिए, Google Chat पर निजी मैसेज भेजें उपयोगकर्ता.

समस्या हल करें

जब Google Chat ऐप्लिकेशन या card कोई गड़बड़ी दिखाता है, Chat के इंटरफ़ेस पर, "कोई गड़बड़ी हुई" मैसेज दिखता है. या "आपका अनुरोध प्रोसेस नहीं किया जा सका." कभी-कभी Chat यूज़र इंटरफ़ेस (यूआई) गड़बड़ी का कोई मैसेज नहीं दिखाता है. हालांकि, Chat ऐप्लिकेशन या कार्ड से कोई अनचाहा नतीजा मिलता है; उदाहरण के लिए, कार्ड मैसेज शायद दिखाना चाहते हैं.

हालांकि, Chat के यूज़र इंटरफ़ेस (यूआई) में गड़बड़ी का मैसेज शायद न दिखे, गड़बड़ी ठीक करने में आपकी मदद करने के लिए, जानकारी देने वाले गड़बड़ी के मैसेज और लॉग डेटा उपलब्ध है जब चैट ऐप्लिकेशन के लिए गड़बड़ी लॉग करने की सेटिंग चालू हो. मदद के लिए, डीबग करने और गड़बड़ियां ठीक करने के लिए, देखें Google Chat से जुड़ी गड़बड़ियां हल करना और गड़बड़ियां ठीक करना.