REST Resource: spaces.messages

संसाधन: मैसेज

Google Chat स्पेस में मौजूद कोई मैसेज.

JSON के काेड में दिखाना 
{
  "name": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "deleteTime": string,
  "text": string,
  "formattedText": string,
  "cards": [
    {
      object (Card)
    }
  ],
  "cardsV2": [
    {
      object (CardWithId)
    }
  ],
  "annotations": [
    {
      object (Annotation)
    }
  ],
  "thread": {
    object (Thread)
  },
  "space": {
    object (Space)
  },
  "fallbackText": string,
  "actionResponse": {
    object (ActionResponse)
  },
  "argumentText": string,
  "slashCommand": {
    object (SlashCommand)
  },
  "attachment": [
    {
      object (Attachment)
    }
  ],
  "matchedUrl": {
    object (MatchedUrl)
  },
  "threadReply": boolean,
  "clientAssignedMessageId": string,
  "emojiReactionSummaries": [
    {
      object (EmojiReactionSummary)
    }
  ],
  "privateMessageViewer": {
    object (User)
  },
  "deletionMetadata": {
    object (DeletionMetadata)
  },
  "quotedMessageMetadata": {
    object (QuotedMessageMetadata)
  },
  "attachedGifs": [
    {
      object (AttachedGif)
    }
  ],
  "accessoryWidgets": [
    {
      object (AccessoryWidget)
    }
  ]
}
फ़ील्ड
name

string

आइडेंटिफ़ायर. मैसेज के संसाधन का नाम.

फ़ॉर्मैट: spaces/{space}/messages/{message}

यहां {space} उस स्पेस का आईडी है जहां मैसेज पोस्ट किया गया है. साथ ही, {message} सिस्टम की ओर से असाइन किया गया मैसेज आईडी है. उदाहरण के लिए, spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB.

अगर मैसेज बनाते समय कस्टम आईडी सेट किया जाता है, तो इस आईडी का इस्तेमाल अनुरोध में मैसेज के बारे में बताने के लिए किया जा सकता है. इसके लिए, {message} फ़ील्ड की वैल्यू को clientAssignedMessageId से बदलें. उदाहरण के लिए, spaces/AAAAAAAAAAA/messages/client-custom-name. ज़्यादा जानकारी के लिए, किसी मैसेज को नाम देना लेख पढ़ें.
sender

object (User)

सिर्फ़ आउटपुट के लिए. मैसेज बनाने वाला उपयोगकर्ता. अगर आपका Chat ऐप्लिकेशन उपयोगकर्ता के तौर पर पुष्टि करता है, तो आउटपुट में user name और type की जानकारी शामिल होती है.
createTime

string (Timestamp format)

ज़रूरी नहीं. इम्यूटेबल. Chat में बनाए गए स्पेस के लिए, मैसेज बनाने का समय. यह फ़ील्ड सिर्फ़ आउटपुट के लिए होता है. हालांकि, इसका इस्तेमाल इंपोर्ट मोड वाले स्पेस में किया जा सकता है.

इंपोर्ट मोड वाले स्पेस के लिए, इस फ़ील्ड को उस पुराने टाइमस्टैंप पर सेट करें जिस पर सोर्स में मैसेज बनाया गया था, ताकि मैसेज बनाने का मूल समय सुरक्षित रखा जा सके.
lastUpdateTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह समय, जब किसी उपयोगकर्ता ने मैसेज में आखिरी बार बदलाव किया था. अगर मैसेज में कभी बदलाव नहीं किया गया है, तो यह फ़ील्ड खाली होता है.
deleteTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. Google Chat में मैसेज मिटाने का समय. अगर मैसेज कभी नहीं मिटाया जाता है, तो यह फ़ील्ड खाली होता है.
text

string

ज़रूरी नहीं. मैसेज का मुख्य हिस्सा, सादे टेक्स्ट में होता है. किसी इमेज, वीडियो या वेब पेज के पहले लिंक से झलक वाला चिप जनरेट होता है. आपके पास Google Chat के किसी उपयोगकर्ता या स्पेस में मौजूद सभी लोगों को@mention करने का विकल्प भी होता है.

टेक्स्ट मैसेज बनाने के बारे में जानने के लिए, मैसेज भेजना लेख पढ़ें.
formattedText

string

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

  • बोल्ड, इटैलिक, स्ट्राइकथ्रू, मोनोस्पेस, मोनोस्पेस ब्लॉक, और बुलेट वाली सूची के लिए मार्कअप सिंटैक्स.

  • <users/{user}> फ़ॉर्मैट का इस्तेमाल करके, उपयोगकर्ता के नाम टैग किए गए हों.

  • <{url}|{rendered_text}> फ़ॉर्मैट का इस्तेमाल करके बनाए गए कस्टम हाइपरलिंक. इसमें पहली स्ट्रिंग यूआरएल होती है और दूसरी स्ट्रिंग रेंडर किया गया टेक्स्ट होता है. उदाहरण के लिए, <{url}|{rendered_text}>.<http://example.com|custom text>

  • कस्टम इमोजी, :{emojiName}: फ़ॉर्मैट में होना चाहिए. उदाहरण के लिए, :smile:. यह यूनिकोड इमोजी पर लागू नहीं होता. जैसे, मुस्कुराते हुए चेहरे वाले इमोजी के लिए U+1F600.

ज़्यादा जानकारी के लिए, किसी मैसेज में भेजी गई टेक्स्ट फ़ॉर्मैटिंग देखना लेख पढ़ें
cards[]
(deprecated)

object (Card)

इस्तेमाल बंद कर दिया गया है: इसके बजाय, cardsV2 का इस्तेमाल करें.

रिच, फ़ॉर्मैट किए गए, और इंटरैक्टिव कार्ड. इनका इस्तेमाल यूज़र इंटरफ़ेस (यूआई) एलिमेंट दिखाने के लिए किया जा सकता है. जैसे: फ़ॉर्मैट किए गए टेक्स्ट, बटन, और क्लिक की जा सकने वाली इमेज. कार्ड आम तौर पर, मैसेज के मुख्य हिस्से के नीचे दिखते हैं. cards और cardsV2 का साइज़ ज़्यादा से ज़्यादा 32 केबी हो सकता है.
cardsV2[]

object (CardWithId)

ज़रूरी नहीं. कार्ड का ऐरे.

सिर्फ़ Chat ऐप्लिकेशन, कार्ड बना सकते हैं. अगर आपका Chat ऐप्लिकेशन उपयोगकर्ता के तौर पर पुष्टि करता है, तो मैसेज में कार्ड नहीं हो सकते.

कार्ड वाला मैसेज बनाने का तरीका जानने के लिए, मैसेज भेजना लेख पढ़ें.

कार्ड बिल्डर की मदद से, कार्ड डिज़ाइन करें और उनकी झलक देखें.

कार्ड बिल्डर खोलना
annotations[]

object (Annotation)

सिर्फ़ आउटपुट के लिए. एनोटेशन को मैसेज के सामान्य टेक्स्ट वाले हिस्से या Google Workspace के संसाधनों से लिंक करने वाले चिप के साथ जोड़ा जा सकता है. जैसे, Google Docs या Sheets के साथ startIndex और length का 0.
thread

object (Thread)

वह थ्रेड जिससे मैसेज जुड़ा है. इसे इस्तेमाल करने के तरीके के बारे में जानने के लिए, मैसेज थ्रेड शुरू करना या उसका जवाब देना लेख पढ़ें.
space

object (Space)

सिर्फ़ आउटपुट के लिए. अगर आपका Chat ऐप्लिकेशन उपयोगकर्ता के तौर पर पुष्टि करता है, तो आउटपुट में सिर्फ़ स्पेस की जानकारी दिखती है name.
fallbackText

string

ज़रूरी नहीं. मैसेज के कार्ड का सामान्य टेक्स्ट वाला ब्यौरा. इसका इस्तेमाल तब किया जाता है, जब असली कार्ड नहीं दिखाए जा सकते. उदाहरण के लिए, मोबाइल सूचनाएं.
actionResponse

object (ActionResponse)

सिर्फ़ इनपुट के लिए. ऐसे पैरामीटर जिनका इस्तेमाल करके, Chat ऐप्लिकेशन यह कॉन्फ़िगर कर सकता है कि उसके जवाब को कैसे पोस्ट किया जाए.
argumentText

string

सिर्फ़ आउटपुट के लिए. मैसेज का मुख्य हिस्सा, सादे टेक्स्ट में होता है. इसमें Chat ऐप्लिकेशन के सभी मेंशन हटा दिए जाते हैं.
slashCommand

object (SlashCommand)

सिर्फ़ आउटपुट के लिए. अगर लागू हो, तो स्लैश कमांड के बारे में जानकारी.
attachment[]

object (Attachment)

ज़रूरी नहीं. उपयोगकर्ता का अपलोड किया गया अटैचमेंट.
matchedUrl

object (MatchedUrl)

सिर्फ़ आउटपुट के लिए. spaces.messages.text में मौजूद ऐसा यूआरएल जो लिंक की झलक के पैटर्न से मेल खाता हो. ज़्यादा जानकारी के लिए, लिंक की झलक देखना लेख पढ़ें.
threadReply

boolean

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

अगर स्पेस में थ्रेड में जवाब देने की सुविधा काम नहीं करती है, तो यह फ़ील्ड हमेशा false होता है.
clientAssignedMessageId

string

ज़रूरी नहीं. मैसेज के लिए कस्टम आईडी. इस फ़ील्ड का इस्तेमाल, किसी मैसेज की पहचान करने के लिए किया जा सकता है. इसके अलावा, इसका इस्तेमाल किसी मैसेज को पाने, मिटाने या अपडेट करने के लिए भी किया जा सकता है. कस्टम आईडी सेट करने के लिए, मैसेज बनाते समय messageId फ़ील्ड की जानकारी दें. ज़्यादा जानकारी के लिए, किसी मैसेज को नाम देना लेख पढ़ें.
emojiReactionSummaries[]

object (EmojiReactionSummary)

सिर्फ़ आउटपुट के लिए. मैसेज पर, इमोजी से दी गई प्रतिक्रियाओं की खास जानकारी की सूची.
privateMessageViewer

object (User)

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

ज़्यादा जानकारी के लिए, निजी मैसेज भेजना लेख पढ़ें.
deletionMetadata

object (DeletionMetadata)

सिर्फ़ आउटपुट के लिए. मिटाए गए मैसेज के बारे में जानकारी. deleteTime सेट होने पर, मैसेज मिटा दिया जाता है.
quotedMessageMetadata

object (QuotedMessageMetadata)

सिर्फ़ आउटपुट के लिए. किसी स्पेस में Google Chat का इस्तेमाल करने वाले व्यक्ति के कोट किए गए मैसेज के बारे में जानकारी. Google Chat का इस्तेमाल करने वाले लोग, किसी मैसेज का जवाब देने के लिए उसे कोट कर सकते हैं.
attachedGifs[]

object (AttachedGif)

सिर्फ़ आउटपुट के लिए. मैसेज में अटैच की गई GIF इमेज.
accessoryWidgets[]

object (AccessoryWidget)

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

ऐक्सेसरी विजेट के साथ मैसेज बनाने के लिए, ऐप्लिकेशन की पुष्टि करना ज़रूरी है.

CardWithId

Google Chat मैसेज में मौजूद कार्ड.

सिर्फ़ Chat ऐप्लिकेशन, कार्ड बना सकते हैं. अगर आपका Chat ऐप्लिकेशन उपयोगकर्ता के तौर पर पुष्टि करता है, तो मैसेज में कार्ड नहीं हो सकते.

कार्ड बिल्डर की मदद से, कार्ड डिज़ाइन करें और उनकी झलक देखें.

कार्ड बिल्डर खोलना

JSON के काेड में दिखाना 
{
  "cardId": string,
  "card": {
    object (Card)
  }
}
फ़ील्ड
cardId

string

अगर मैसेज में एक से ज़्यादा कार्ड शामिल हैं, तो यह फ़ील्ड ज़रूरी है. यह मैसेज में मौजूद किसी कार्ड के लिए यूनीक आइडेंटिफ़ायर होता है.
card

object (Card)

कार्ड. ज़्यादा से ज़्यादा 32 केबी.

टिप्पणी

सिर्फ़ आउटपुट के लिए. एनोटेशन को मैसेज के सामान्य टेक्स्ट वाले हिस्से या Google Workspace के संसाधनों से लिंक करने वाले चिप के साथ जोड़ा जा सकता है. जैसे, Google Docs या Sheets के साथ startIndex और length का 0. टेक्स्ट मैसेज में बेसिक फ़ॉर्मैटिंग जोड़ने के लिए, टेक्स्ट मैसेज को फ़ॉर्मैट करना लेख पढ़ें.

सादे टेक्स्ट वाले मैसेज के मुख्य भाग का उदाहरण:

Hello @FooBot how are you!"

इससे जुड़े एनोटेशन का मेटाडेटा:

"annotations":[{
  "type":"USER_MENTION",
  "startIndex":6,
  "length":7,
  "userMention": {
    "user": {
      "name":"users/{user}",
      "displayName":"FooBot",
      "avatarUrl":"https://goo.gl/aeDtrS",
      "type":"BOT"
    },
    "type":"MENTION"
   }
}]
JSON के काेड में दिखाना 
{
  "type": enum (AnnotationType),
  "length": integer,
  "startIndex": integer,

  // Union field metadata can be only one of the following:
  "userMention": {
    object (UserMentionMetadata)
  },
  "slashCommand": {
    object (SlashCommandMetadata)
  },
  "richLinkMetadata": {
    object (RichLinkMetadata)
  },
  "customEmojiMetadata": {
    object (CustomEmojiMetadata)
  }
  // End of list of possible types for union field metadata.
}
फ़ील्ड
type

enum (AnnotationType)

यह एनोटेशन किस तरह का है.
length

integer

यह एनोटेशन, सादे टेक्स्ट वाले मैसेज के मुख्य हिस्से में मौजूद जिस सबस्ट्रिंग से मेल खाता है उसकी लंबाई. अगर यह मौजूद नहीं है, तो इसका मतलब है कि इसकी लंबाई 0 है.
startIndex

integer

यह एनोटेशन, सादे टेक्स्ट वाले मैसेज के जिस हिस्से से जुड़ा है उसका शुरुआती इंडेक्स. यह इंडेक्स, 0 से शुरू होता है और इसमें शामिल होता है.
यूनियन फ़ील्ड metadata. एनोटेशन के बारे में अतिरिक्त मेटाडेटा. metadata इनमें से सिर्फ़ एक हो सकता है:
userMention

object (UserMentionMetadata)

उपयोगकर्ता को टैग करने से जुड़ा मेटाडेटा.
slashCommand

object (SlashCommandMetadata)

स्लैश कमांड का मेटाडेटा.
customEmojiMetadata

object (CustomEmojiMetadata)

कस्टम इमोजी का मेटाडेटा.

AnnotationType

एनोटेशन का टाइप.

Enums
ANNOTATION_TYPE_UNSPECIFIED एनम के लिए डिफ़ॉल्ट वैल्यू. इसका इस्तेमाल न करें.
USER_MENTION किसी उपयोगकर्ता को टैग किया गया हो.
SLASH_COMMAND स्लैश कमांड का इस्तेमाल किया जाता है.
CUSTOM_EMOJI कस्टम इमोजी एनोटेशन.

UserMentionMetadata

उपयोगकर्ता के नाम (@) के लिए एनोटेशन मेटाडेटा.

JSON के काेड में दिखाना 
{
  "user": {
    object (User)
  },
  "type": enum (Type)
}
फ़ील्ड
user

object (User)

जिस उपयोगकर्ता का ज़िक्र किया गया है.
type

enum (Type)

उपयोगकर्ता को टैग करने का टाइप.

टाइप

Enums
TYPE_UNSPECIFIED एनम के लिए डिफ़ॉल्ट वैल्यू. इसका इस्तेमाल न करें.
ADD उपयोगकर्ता को स्पेस में जोड़ें.
MENTION स्पेस में किसी उपयोगकर्ता का नाम टैग करें.

SlashCommandMetadata

स्लैश कमांड (/) के लिए एनोटेशन मेटाडेटा.

JSON के काेड में दिखाना 
{
  "bot": {
    object (User)
  },
  "type": enum (Type),
  "commandName": string,
  "commandId": string,
  "triggersDialog": boolean
}
फ़ील्ड
bot

object (User)

वह Chat ऐप्लिकेशन जिसकी कमांड शुरू की गई थी.
type

enum (Type)

स्लैश कमांड का टाइप.
commandName

string

इनवोक किए गए स्लैश कमांड का नाम.
commandId

string (int64 format)

बुलाए गए स्लैश कमांड का आईडी.
triggersDialog

boolean

इससे पता चलता है कि स्लैश कमांड, डायलॉग के लिए है या नहीं.

टाइप

Enums
TYPE_UNSPECIFIED एनम के लिए डिफ़ॉल्ट वैल्यू. इसका इस्तेमाल न करें.
ADD स्पेस में Chat ऐप्लिकेशन जोड़ें.
INVOKE स्पेस में स्लैश कमांड का इस्तेमाल करना.

RichLinkMetadata

किसी संसाधन का रिच लिंक. रिच लिंक, मैसेज के सामान्य टेक्स्ट वाले मुख्य हिस्से से जुड़े हो सकते हैं. इसके अलावा, ये ऐसे चिप भी हो सकते हैं जो Google Workspace के संसाधनों से लिंक होते हैं. जैसे, Google Docs या Sheets, जिनमें startIndex और length की वैल्यू 0 होती है.

JSON के काेड में दिखाना 
{
  "uri": string,
  "richLinkType": enum (RichLinkType),

  // Union field data can be only one of the following:
  "driveLinkData": {
    object (DriveLinkData)
  },
  "chatSpaceLinkData": {
    object (ChatSpaceLinkData)
  },
  "meetSpaceLinkData": {
    object (MeetSpaceLinkData)
  },
  "calendarEventLinkData": {
    object (CalendarEventLinkData)
  }
  // End of list of possible types for union field data.
}
फ़ील्ड
uri

string

इस लिंक का यूआरआई.
यूनियन फ़ील्ड data. लिंक किए गए संसाधन का डेटा. data इनमें से सिर्फ़ एक हो सकता है:

RichLinkType

रिच लिंक का टाइप. आने वाले समय में, इसमें और टाइप जोड़े जा सकते हैं.

Enums
DRIVE_FILE Google Drive का रिच लिंक टाइप.
CHAT_SPACE यह Chat स्पेस के रिच लिंक का टाइप है. उदाहरण के लिए, स्पेस का स्मार्ट चिप.
MEET_SPACE यह Meet मैसेज में इस्तेमाल होने वाले रिच लिंक का टाइप है. उदाहरण के लिए, Meet का चिप.
CALENDAR_EVENT Calendar मैसेज में मौजूद रिच लिंक का टाइप. उदाहरण के लिए, कैलेंडर चिप.

DriveLinkData

Google Drive के लिंक का डेटा.

JSON के काेड में दिखाना 
{
  "driveDataRef": {
    object (DriveDataRef)
  },
  "mimeType": string
}
फ़ील्ड
driveDataRef

object (DriveDataRef)

DriveDataRef, जो Google Drive में मौजूद किसी फ़ाइल का रेफ़रंस देता है.
mimeType

string

लिंक किए गए Google Drive संसाधन का MIME टाइप.

ChatSpaceLinkData

Chat स्पेस के लिंक का डेटा.

JSON के काेड में दिखाना 
{
  "space": string,
  "thread": string,
  "message": string
}
फ़ील्ड
space

string

लिंक किए गए Chat स्पेस रिसॉर्स का स्पेस.

फ़ॉर्मैट: spaces/{space}
thread

string

लिंक किए गए Chat स्पेस संसाधन का थ्रेड.

फ़ॉर्मैट: spaces/{space}/threads/{thread}
message

string

लिंक किए गए Chat स्पेस रिसॉर्स का मैसेज.

फ़ॉर्मैट: spaces/{space}/messages/{message}

MeetSpaceLinkData

मीटिंग स्पेस के लिंक का डेटा.

JSON के काेड में दिखाना 
{
  "meetingCode": string,
  "type": enum (Type),
  "huddleStatus": enum (HuddleStatus)
}
फ़ील्ड
meetingCode

string

लिंक किए गए Meet स्पेस का मीटिंग कोड.
type

enum (Type)

इससे Meet स्पेस के टाइप के बारे में पता चलता है.
huddleStatus

enum (HuddleStatus)

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

टाइप

मीटिंग स्पेस का टाइप.

Enums
TYPE_UNSPECIFIED एनम के लिए डिफ़ॉल्ट वैल्यू. इसका इस्तेमाल न करें.
MEETING मीट स्पेस एक मीटिंग है.
HUDDLE मीटिंग स्पेस एक हडल है.

HuddleStatus

हडल का स्टेटस

Enums
HUDDLE_STATUS_UNSPECIFIED एनम के लिए डिफ़ॉल्ट वैल्यू. इसका इस्तेमाल न करें.
STARTED हडल कॉल शुरू हो गया है.
ENDED हडल कॉल खत्म हो गया है. इस मामले में, Meet स्पेस का यूआरआई और आइडेंटिफ़ायर अब मान्य नहीं होंगे.
MISSED हडल छूट गया है. इस मामले में, Meet स्पेस का यूआरआई और आइडेंटिफ़ायर अब मान्य नहीं होंगे.

CalendarEventLinkData

कैलेंडर इवेंट के लिंक का डेटा.

JSON के काेड में दिखाना 
{
  "calendarId": string,
  "eventId": string
}
फ़ील्ड
calendarId

string

लिंक किए गए कैलेंडर का कैलेंडर आइडेंटिफ़ायर.
eventId

string

लिंक किए गए Calendar इवेंट का इवेंट आइडेंटिफ़ायर.

CustomEmojiMetadata

कस्टम इमोजी के लिए एनोटेशन मेटाडेटा.

JSON के काेड में दिखाना 
{
  "customEmoji": {
    object (CustomEmoji)
  }
}
फ़ील्ड
customEmoji

object (CustomEmoji)

कस्टम इमोजी.

थ्रेड

Google Chat स्पेस में मौजूद कोई थ्रेड. इसे इस्तेमाल करने के तरीके के बारे में जानने के लिए, मैसेज थ्रेड शुरू करना या उसका जवाब देना लेख पढ़ें.

मैसेज बनाते समय थ्रेड तय करने पर, messageReplyOption फ़ील्ड सेट किया जा सकता है. इससे यह तय किया जा सकता है कि मिलती-जुलती थ्रेड न मिलने पर क्या होगा.

JSON के काेड में दिखाना 
{
  "name": string,
  "threadKey": string
}
फ़ील्ड
name

string

आइडेंटिफ़ायर. थ्रेड के संसाधन का नाम.

उदाहरण: spaces/{space}/threads/{thread}
threadKey

string

ज़रूरी नहीं. थ्रेड बनाने या अपडेट करने के लिए इनपुट. इसके अलावा, सिर्फ़ आउटपुट के लिए. थ्रेड का आईडी. इसमें ज़्यादा से ज़्यादा 4,000 वर्ण इस्तेमाल किए जा सकते हैं.

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

ActionResponse

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

JSON के काेड में दिखाना 
{
  "type": enum (ResponseType),
  "url": string,
  "dialogAction": {
    object (DialogAction)
  },
  "updatedWidget": {
    object (UpdatedWidget)
  }
}
फ़ील्ड
type

enum (ResponseType)

सिर्फ़ इनपुट के लिए. Chat ऐप्लिकेशन से मिले जवाब का टाइप.
url

string

सिर्फ़ इनपुट के लिए. उपयोगकर्ताओं के लिए पुष्टि करने या कॉन्फ़िगर करने का यूआरएल. (सिर्फ़ REQUEST_CONFIG जवाब के टाइप के लिए.)
dialogAction

object (DialogAction)

सिर्फ़ इनपुट के लिए. डायलॉग से जुड़े इंटरैक्शन इवेंट का जवाब. ResponseType.Dialog के साथ होना चाहिए.
updatedWidget

object (UpdatedWidget)

सिर्फ़ इनपुट के लिए. अपडेट किए गए विजेट का जवाब.

ResponseType

Chat ऐप्लिकेशन से मिले जवाब का टाइप.

Enums
TYPE_UNSPECIFIED डिफ़ॉल्ट टाइप, जिसे NEW_MESSAGE के तौर पर हैंडल किया जाता है.
NEW_MESSAGE विषय में नया मैसेज पोस्ट करें.
UPDATE_MESSAGE Chat ऐप्लिकेशन के मैसेज को अपडेट करें. इस सुविधा का इस्तेमाल सिर्फ़ CARD_CLICKED इवेंट में किया जा सकता है. साथ ही, मैसेज भेजने वाले का टाइप BOT होना चाहिए.
UPDATE_USER_MESSAGE_CARDS उपयोगकर्ता के मैसेज में मौजूद कार्ड अपडेट करें. इस तरह के रिस्पॉन्स को सिर्फ़ MESSAGE इवेंट के जवाब के तौर पर इस्तेमाल किया जा सकता है. इस इवेंट में, मैच किया गया यूआरएल मौजूद होता है. इसके अलावा, इसे CARD_CLICKED इवेंट के जवाब के तौर पर भी इस्तेमाल किया जा सकता है. इस इवेंट में, मैसेज भेजने वाले का टाइप HUMAN होता है. टेक्स्ट को अनदेखा कर दिया जाता है.
REQUEST_CONFIG उपयोगकर्ता से निजी तौर पर, पुष्टि करने या कॉन्फ़िगरेशन के बारे में ज़्यादा जानकारी मांगें.
DIALOG यह एक डायलॉग दिखाता है.
UPDATE_WIDGET विजेट में टेक्स्ट को अपने-आप पूरा करने के विकल्पों के बारे में क्वेरी.

DialogAction

इसमें डायलॉग और अनुरोध का स्टेटस कोड होता है.

JSON के काेड में दिखाना 
{
  "actionStatus": {
    object (ActionStatus)
  },

  // Union field action can be only one of the following:
  "dialog": {
    object (Dialog)
  }
  // End of list of possible types for union field action.
}
फ़ील्ड
actionStatus

object (ActionStatus)

सिर्फ़ इनपुट के लिए. डायलॉग को शुरू करने या सबमिट करने के अनुरोध की स्थिति. ज़रूरत पड़ने पर, यह कुकी उपयोगकर्ताओं को स्टेटस और मैसेज दिखाती है. उदाहरण के लिए, गड़बड़ी होने या कार्रवाई पूरी होने पर.
यूनियन फ़ील्ड action. की जाने वाली कार्रवाई. action इनमें से सिर्फ़ एक हो सकता है:
dialog

object (Dialog)

सिर्फ़ इनपुट के लिए. अनुरोध के लिए डायलॉग.

Dialog

डायलॉग के कार्ड बॉडी के चारों ओर रैपर.

JSON के काेड में दिखाना 
{
  "body": {
    object (Card)
  }
}
फ़ील्ड
body

object (Card)

सिर्फ़ इनपुट के लिए. डायलॉग का मुख्य हिस्सा, जिसे मोडल में रेंडर किया जाता है. Google Chat ऐप्लिकेशन, कार्ड की इन इकाइयों के साथ काम नहीं करते: DateTimePicker, OnChangeAction.

ActionStatus

इससे, डायलॉग को शुरू करने या सबमिट करने के अनुरोध की स्थिति के बारे में पता चलता है.

JSON के काेड में दिखाना 
{
  "statusCode": enum (Code),
  "userFacingMessage": string
}
फ़ील्ड
statusCode

enum (Code)

स्टेटस कोड.
userFacingMessage

string

लोगों को उनके अनुरोध की स्थिति के बारे में बताने के लिए मैसेज. अगर इसे सेट नहीं किया जाता है, तो statusCode के आधार पर एक सामान्य मैसेज भेजा जाता है.

कोड

gRPC API के लिए कैननिकल गड़बड़ी कोड.

कभी-कभी एक से ज़्यादा गड़बड़ी कोड लागू हो सकते हैं. सेवाओं को सबसे सटीक गड़बड़ी कोड दिखाना चाहिए. उदाहरण के लिए, अगर दोनों कोड लागू होते हैं, तो FAILED_PRECONDITION के बजाय OUT_OF_RANGE को प्राथमिकता दें. इसी तरह, FAILED_PRECONDITION के बजाय NOT_FOUND या ALREADY_EXISTS को प्राथमिकता दें.

Enums
OK

यह कोई गड़बड़ी नहीं है. यह अनुरोध पूरा होने पर दिखता है.

एचटीटीपी मैपिंग: 200 ठीक है
CANCELLED

कार्रवाई रद्द कर दी गई थी. आम तौर पर, ऐसा कॉल करने वाला व्यक्ति करता है.

एचटीटीपी मैपिंग: 499 अनुरोध की प्रोसेस होने के दौरान क्लाइंट ने कनेक्शन बंद कर दिया
UNKNOWN

ऐसी गड़बड़ी जिसके बारे में कोई जानकारी नहीं है. उदाहरण के लिए, यह गड़बड़ी तब दिख सकती है, जब किसी दूसरे पते के स्पेस से मिली Status वैल्यू, किसी ऐसे गड़बड़ी वाले स्पेस से जुड़ी हो जिसके बारे में इस पते के स्पेस में जानकारी न हो. साथ ही, ऐसे एपीआई से मिली गड़बड़ियों को भी इस गड़बड़ी में बदला जा सकता है जो गड़बड़ी की पूरी जानकारी नहीं देते.

HTTP मैपिंग: 500 सर्वर में गड़बड़ी
INVALID_ARGUMENT

क्लाइंट ने एक अमान्य तर्क बताया. ध्यान दें कि यह FAILED_PRECONDITION से अलग है. INVALID_ARGUMENT से ऐसे तर्कों का पता चलता है जिनमें सिस्टम की स्थिति से कोई फ़र्क़ नहीं पड़ता. जैसे, गलत फ़ॉर्मैट वाली फ़ाइल का नाम.

एचटीटीपी मैपिंग: 400 गलत अनुरोध
DEADLINE_EXCEEDED

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

एचटीटीपी मैपिंग: 504 गेटवे का समय खत्म हो गया है
NOT_FOUND

अनुरोध की गई कुछ इकाइयां (जैसे, फ़ाइल या डायरेक्ट्री) नहीं मिलीं.

सर्वर डेवलपर के लिए सूचना: अगर उपयोगकर्ताओं के किसी ग्रुप के लिए अनुरोध अस्वीकार कर दिया जाता है, तो NOT_FOUND का इस्तेमाल किया जा सकता है. जैसे, सुविधा को धीरे-धीरे रोल आउट करना या बिना दस्तावेज़ वाली अनुमति वाली सूची. अगर उपयोगकर्ताओं के किसी ग्रुप (जैसे, उपयोगकर्ता के आधार पर ऐक्सेस कंट्रोल) में शामिल कुछ उपयोगकर्ताओं के अनुरोध को अस्वीकार कर दिया जाता है, तो PERMISSION_DENIED का इस्तेमाल करना ज़रूरी है.

एचटीटीपी मैपिंग: 404 नहीं मिला
ALREADY_EXISTS

क्लाइंट ने जिस इकाई को बनाने की कोशिश की है (जैसे, फ़ाइल या डायरेक्ट्री), वह पहले से मौजूद है.

एचटीटीपी मैपिंग: 409 गड़बड़ी
PERMISSION_DENIED

कॉलर के पास, तय की गई कार्रवाई को पूरा करने की अनुमति नहीं है. PERMISSION_DENIED का इस्तेमाल, किसी संसाधन के खत्म होने की वजह से अस्वीकार किए गए अनुरोधों के लिए नहीं किया जाना चाहिए. इसके बजाय, उन गड़बड़ियों के लिए RESOURCE_EXHAUSTED का इस्तेमाल करें. अगर कॉल करने वाले की पहचान नहीं की जा सकती, तो PERMISSION_DENIED का इस्तेमाल नहीं किया जाना चाहिए. इसके बजाय, उन गड़बड़ियों के लिए UNAUTHENTICATED का इस्तेमाल करें. इस गड़बड़ी के कोड का मतलब यह नहीं है कि अनुरोध मान्य है या अनुरोध की गई इकाई मौजूद है या अन्य ज़रूरी शर्तें पूरी करती है.

एचटीटीपी मैपिंग: 403 अनुमति नहीं है
UNAUTHENTICATED

अनुरोध में, कार्रवाई के लिए पुष्टि करने वाले मान्य क्रेडेंशियल मौजूद नहीं हैं.

एचटीटीपी मैपिंग: 401 Unauthorized
RESOURCE_EXHAUSTED

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

एचटीटीपी मैपिंग: 429 कई बार अनुरोध किया गया
FAILED_PRECONDITION

इस कार्रवाई को अस्वीकार कर दिया गया है, क्योंकि सिस्टम उस स्थिति में नहीं है जिसमें कार्रवाई को पूरा किया जा सकता है. उदाहरण के लिए, मिटाई जाने वाली डायरेक्ट्री खाली नहीं है, rmdir ऑपरेशन को किसी डायरेक्ट्री पर लागू नहीं किया गया है वगैरह.

सेवा लागू करने वाले लोग, FAILED_PRECONDITION, ABORTED, और UNAVAILABLE में से किसी एक को चुनने के लिए, इन दिशा-निर्देशों का इस्तेमाल कर सकते हैं: (a) अगर क्लाइंट सिर्फ़ फ़ेल हुए कॉल को फिर से आज़मा सकता है, तो UNAVAILABLE का इस्तेमाल करें. (b) अगर क्लाइंट को ज़्यादा लेवल पर फिर से कोशिश करनी चाहिए, तो ABORTED का इस्तेमाल करें. उदाहरण के लिए, जब क्लाइंट की ओर से तय किया गया टेस्ट-एंड-सेट फ़ेल हो जाता है, तो इसका मतलब है कि क्लाइंट को read-modify-write सीक्वेंस को फिर से शुरू करना चाहिए. (c) अगर सिस्टम की स्थिति ठीक होने तक क्लाइंट को फिर से कोशिश नहीं करनी चाहिए, तो FAILED_PRECONDITION का इस्तेमाल करें. उदाहरण के लिए, अगर कोई डायरेक्ट्री खाली न होने की वजह से "rmdir" काम नहीं करता है, तो FAILED_PRECONDITION को वापस कर दिया जाना चाहिए. ऐसा इसलिए, क्योंकि क्लाइंट को तब तक फिर से कोशिश नहीं करनी चाहिए, जब तक डायरेक्ट्री से फ़ाइलें नहीं मिटा दी जातीं.

एचटीटीपी मैपिंग: 400 गलत अनुरोध
ABORTED

आम तौर पर, यह गड़बड़ी एक साथ कई अनुरोध मिलने की वजह से होती है. जैसे, सीक्वेंसर की जांच पूरी न हो पाना या लेन-देन रद्द होना.

FAILED_PRECONDITION, ABORTED, और UNAVAILABLE में से किसी एक को चुनने के लिए, ऊपर दिए गए दिशा-निर्देश देखें.

एचटीटीपी मैपिंग: 409 गड़बड़ी
OUT_OF_RANGE

मान्य सीमा से ज़्यादा बार कार्रवाई करने की कोशिश की गई. उदाहरण के लिए, फ़ाइल के आखिर से पहले या बाद में डेटा खोजना या पढ़ना.

INVALID_ARGUMENT के उलट, इस गड़बड़ी से पता चलता है कि कोई ऐसी समस्या है जिसे सिस्टम की स्थिति बदलने पर ठीक किया जा सकता है. उदाहरण के लिए, अगर किसी 32-बिट फ़ाइल सिस्टम से ऐसे ऑफ़सेट पर पढ़ने के लिए कहा जाता है जो [0,2^32-1] की सीमा में नहीं है, तो वह INVALID_ARGUMENT जनरेट करेगा. हालांकि, अगर उससे मौजूदा फ़ाइल साइज़ से ज़्यादा ऑफ़सेट पर पढ़ने के लिए कहा जाता है, तो वह OUT_OF_RANGE जनरेट करेगा.

FAILED_PRECONDITION और OUT_OF_RANGE के बीच काफ़ी ओवरलैप है. हमारा सुझाव है कि जब OUT_OF_RANGE (ज़्यादा सटीक गड़बड़ी) लागू हो, तब इसका इस्तेमाल करें. इससे कॉल करने वाले लोग, स्पेस में बार-बार होने वाली गड़बड़ी को आसानी से ढूंढ सकते हैं. साथ ही, यह पता लगा सकते हैं कि गड़बड़ी कब ठीक हुई.OUT_OF_RANGE

एचटीटीपी मैपिंग: 400 गलत अनुरोध
UNIMPLEMENTED

यह ऑपरेशन लागू नहीं किया गया है या इस सेवा में काम नहीं करता/चालू नहीं है.

एचटीटीपी मैपिंग: 501 अनुरोध पूरा करने के लिए सुविधाएं मौजूद नहीं हैं
INTERNAL

सिस्टम की गड़बड़ियां. इसका मतलब है कि सिस्टम के कुछ इनवेरिएंट टूट गए हैं. यह गड़बड़ी कोड, गंभीर गड़बड़ियों के लिए रिज़र्व किया गया है.

HTTP मैपिंग: 500 सर्वर में गड़बड़ी
UNAVAILABLE

फ़िलहाल, सेवा उपलब्ध नहीं है. यह एक अस्थायी समस्या है. कुछ समय बाद फिर से कोशिश करने पर, यह ठीक हो सकती है. ध्यान दें कि नॉन-आइटमपोटेंट ऑपरेशनों को फिर से आज़माना हमेशा सुरक्षित नहीं होता.

FAILED_PRECONDITION, ABORTED, और UNAVAILABLE में से किसी एक को चुनने के लिए, ऊपर दिए गए दिशा-निर्देश देखें.

HTTP मैपिंग: 503 सेवा उपलब्ध नहीं है
DATA_LOSS

डेटा को वापस नहीं पाया जा सकता या डेटा खराब हो गया.

HTTP मैपिंग: 500 सर्वर में गड़बड़ी

UpdatedWidget

selectionInput विजेट के लिए, यह फ़ंक्शन एक से ज़्यादा आइटम चुनने वाले मेन्यू के लिए, अपने-आप पूरा होने के सुझाव दिखाता है.

JSON के काेड में दिखाना 
{
  "widget": string,

  // Union field updated_widget can be only one of the following:
  "suggestions": {
    object (SelectionItems)
  }
  // End of list of possible types for union field updated_widget.
}
फ़ील्ड
widget

string

अपडेट किए गए विजेट का आईडी. यह आईडी, उस विजेट के आईडी से मेल खाना चाहिए जिसने अपडेट का अनुरोध ट्रिगर किया है.
यूनियन फ़ील्ड updated_widget. उपयोगकर्ता की कार्रवाई के जवाब में विजेट अपडेट किया गया. updated_widget इनमें से सिर्फ़ एक हो सकता है:
suggestions

object (SelectionItems)

विजेट के लिए, अपने-आप पूरे होने वाले नतीजों की सूची

SelectionItems

विजेट के लिए, अपने-आप पूरे होने वाले नतीजों की सूची.

JSON के काेड में दिखाना 
{
  "items": [
    {
      object (SelectionItem)
    }
  ]
}
फ़ील्ड
items[]

object (SelectionItem)

SelectionItem ऑब्जेक्ट का कलेक्शन.

SlashCommand

Google Chat में स्लैश कमांड के बारे में मेटाडेटा.

JSON के काेड में दिखाना 
{
  "commandId": string
}
फ़ील्ड
commandId

string (int64 format)

स्लैश कमांड का आईडी.

MatchedUrl

Chat मैसेज में मैच किया गया यूआरएल. चैट ऐप्लिकेशन, मैच किए गए यूआरएल की झलक दिखा सकते हैं. ज़्यादा जानकारी के लिए, लिंक की झलक देखना लेख पढ़ें.

JSON के काेड में दिखाना 
{
  "url": string
}
फ़ील्ड
url

string

सिर्फ़ आउटपुट के लिए. वह यूआरएल जिससे मैच किया गया है.

EmojiReactionSummary

किसी मैसेज पर, किसी खास इमोजी का इस्तेमाल करके प्रतिक्रिया देने वाले लोगों की संख्या.

JSON के काेड में दिखाना 
{
  "emoji": {
    object (Emoji)
  },
  "reactionCount": integer
}
फ़ील्ड
emoji

object (Emoji)

सिर्फ़ आउटपुट के लिए. प्रतिक्रियाओं से जुड़ा इमोजी.
reactionCount

integer

सिर्फ़ आउटपुट के लिए. इमोजी का इस्तेमाल करके दी गई प्रतिक्रियाओं की कुल संख्या.

DeletionMetadata

मिटाए गए मैसेज के बारे में जानकारी. deleteTime सेट होने पर, मैसेज मिटा दिया जाता है.

JSON के काेड में दिखाना 
{
  "deletionType": enum (DeletionType)
}
फ़ील्ड
deletionType

enum (DeletionType)

इससे पता चलता है कि मैसेज किसने मिटाया है.

DeletionType

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

Enums
DELETION_TYPE_UNSPECIFIED इस वैल्यू का इस्तेमाल नहीं किया गया है.
CREATOR उपयोगकर्ता ने अपना मैसेज मिटा दिया है.
SPACE_OWNER स्पेस मैनेजर ने मैसेज मिटा दिया है.
ADMIN Google Workspace एडमिन ने मैसेज मिटा दिया है. एडमिन, स्पेस में मौजूद किसी भी मैसेज को मिटा सकते हैं. इनमें स्पेस के किसी सदस्य या Chat ऐप्लिकेशन से भेजे गए मैसेज भी शामिल हैं.
APP_MESSAGE_EXPIRY Chat ऐप्लिकेशन ने समयसीमा खत्म होने पर, अपना मैसेज मिटा दिया.
CREATOR_VIA_APP Chat ऐप्लिकेशन ने, मैसेज बनाने वाले व्यक्ति की ओर से मैसेज मिटाया है. इसके लिए, उपयोगकर्ता की पुष्टि करने की सुविधा का इस्तेमाल किया गया है.
SPACE_OWNER_VIA_APP Chat ऐप्लिकेशन ने स्पेस मैनेजर की ओर से मैसेज मिटाया है. इसके लिए, उपयोगकर्ता की पुष्टि करने की सुविधा का इस्तेमाल किया गया है.
SPACE_MEMBER स्पेस के किसी सदस्य ने मैसेज मिटा दिया है. उपयोगकर्ता, ऐप्लिकेशन से भेजे गए मैसेज मिटा सकते हैं.

QuotedMessageMetadata

कोट किए गए मैसेज के बारे में जानकारी.

JSON के काेड में दिखाना 
{
  "name": string,
  "lastUpdateTime": string
}
फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. कोट किए गए मैसेज के संसाधन का नाम.

फ़ॉर्मैट: spaces/{space}/messages/{message}
lastUpdateTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. कोट किए गए मैसेज को बनाए जाने या उसे आखिरी बार अपडेट किए जाने का टाइमस्टैंप.

AttachedGif

यूआरएल से तय की गई GIF इमेज.

JSON के काेड में दिखाना 
{
  "uri": string
}
फ़ील्ड
uri

string

सिर्फ़ आउटपुट के लिए. GIF इमेज को होस्ट करने वाला यूआरएल.

AccessoryWidget

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

JSON के काेड में दिखाना 
{

  // Union field action can be only one of the following:
  "buttonList": {
    object (ButtonList)
  }
  // End of list of possible types for union field action.
}
फ़ील्ड
यूनियन फ़ील्ड action. कार्रवाई किस तरह की है. action इनमें से सिर्फ़ एक हो सकता है:
buttonList

object (ButtonList)

बटन की सूची.

तरीके

create

 यह फ़ंक्शन, Google Chat स्पेस में कोई मैसेज बनाता है.

delete

 यह कुकी, मैसेज को मिटाती है.

get

 किसी मैसेज के बारे में जानकारी दिखाता है.

list

 इस स्पेस में मौजूद मैसेज की सूची दिखाता है. इसमें ब्लॉक किए गए सदस्यों और स्पेस के मैसेज भी शामिल होते हैं.

patch

 इस कुकी का इस्तेमाल मैसेज को अपडेट करने के लिए किया जाता है.

update

 इस कुकी का इस्तेमाल मैसेज को अपडेट करने के लिए किया जाता है.