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,
  "silent": boolean,
  "clientAssignedMessageId": string,
  "emojiReactionSummaries": [
    {
      object (EmojiReactionSummary)
    }
  ],
  "privateMessageViewer": {
    object (User)
  },
  "deletionMetadata": {
    object (DeletionMetadata)
  },
  "quotedMessageMetadata": {
    object (QuotedMessageMetadata)
  },
  "attachedGifs": [
    {
      object (AttachedGif)
    }
  ],
  "accessoryWidgets": [
    {
      object (AccessoryWidget)
    }
  ],
  "elements": {
    object (Elements)
  },
  "markupSyntax": enum (MarkupSyntax)
}
फ़ील्ड
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 ऐप्लिकेशन उपयोगकर्ता के तौर पर पुष्टि करता है, तो आउटपुट में संगठन के अंदर और बाहर के उपयोगकर्ताओं के लिए, सिर्फ़ उपयोगकर्ता name और type फ़ील्ड की जानकारी दिखती है. हालांकि, अगर वे स्पेस के सदस्य हैं या उन्होंने कॉल करने वाले उपयोगकर्ता के साथ पहले कभी बातचीत की है, जैसे कि डायरेक्ट मैसेज (डीएम) के ज़रिए, तो उन्हें पूरी जानकारी दिखेगी.

createTime

string (Timestamp format)

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

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

lastUpdateTime

string (Timestamp format)

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

deleteTime

string (Timestamp format)

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

text

string

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

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

formattedText

string

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

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

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

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

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

  • तारे के निशान (*) का इस्तेमाल करके, बुलेट वाली सूची के आइटम—उदाहरण के लिए, * item.

ज़्यादा जानकारी के लिए, किसी मैसेज में भेजे गए टेक्स्ट फ़ॉर्मैटिंग को देखना लेख पढ़ें

cards[]
(deprecated)

object (Card)

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

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

cardsV2[]

object (CardWithId)

ज़रूरी नहीं. cards का कलेक्शन.

चैट ऐप्लिकेशन, ऐप्लिकेशन की पुष्टि की सुविधा वाले कार्ड बना सकते हैं. डेवलपर प्रीव्यू प्रोग्राम के तहत, अगर आपका Chat ऐप्लिकेशन उपयोगकर्ता के तौर पर पुष्टि करता है, तो वह कार्ड मैसेज बना सकता है. अगर आपका Chat ऐप्लिकेशन, Developer Preview Program का हिस्सा नहीं है, तो वह उपयोगकर्ता की पुष्टि करने वाले कार्ड नहीं बना सकता.

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

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

कार्ड बिल्डर खोलें

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)

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

threadReply

boolean

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

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

silent

boolean

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

clientAssignedMessageId

string

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

emojiReactionSummaries[]

object (EmojiReactionSummary)

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

privateMessageViewer

object (User)

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

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

deletionMetadata

object (DeletionMetadata)

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

quotedMessageMetadata

object (QuotedMessageMetadata)

ज़रूरी नहीं. किसी ऐसे मैसेज के बारे में जानकारी जिसे किसी दूसरे मैसेज में कोट किया गया है.

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

मैसेज अपडेट करते समय, quotedMessageMetadata फ़ील्ड को जोड़ा या बदला नहीं जा सकता. हालांकि, इसे हटाया जा सकता है.

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

attachedGifs[]

object (AttachedGif)

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

accessoryWidgets[]

object (AccessoryWidget)

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

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

elements

object (Elements)

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

markupSyntax

enum (MarkupSyntax)

ज़रूरी नहीं. इससे यह तय होता है कि सर्वर, मैसेज text फ़ील्ड के कॉन्टेंट को कैसे समझता है.

CardWithId

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

चैट ऐप्लिकेशन, ऐप्लिकेशन की पुष्टि की सुविधा वाले कार्ड बना सकते हैं. डेवलपर प्रीव्यू प्रोग्राम के तहत, अगर आपका Chat ऐप्लिकेशन उपयोगकर्ता के तौर पर पुष्टि करता है, तो वह कार्ड मैसेज बना सकता है. अगर आपका Chat ऐप्लिकेशन, Developer Preview Program का हिस्सा नहीं है, तो वह उपयोगकर्ता की पुष्टि करने वाले कार्ड नहीं बना सकता.

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

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

कार्ड बिल्डर खोलें

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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "userMention": {
    object (UserMentionMetadata)
  },
  "slashCommand": {
    object (SlashCommandMetadata)
  },
  "richLinkMetadata": {
    object (RichLinkMetadata)
  },
  "customEmojiMetadata": {
    object (CustomEmojiMetadata)
  }
}
फ़ील्ड
type

enum (AnnotationType)

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

length

integer

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

startIndex

integer

यह एनोटेशन, मैसेज के मुख्य हिस्से में मौजूद सादे टेक्स्ट के जिस हिस्से से जुड़ा है उसका शुरुआती इंडेक्स. यह इंडेक्स, 0 से शुरू होता है और इसमें शामिल होता है.

एनोटेशन के बारे में अतिरिक्त मेटाडेटा. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
userMention

object (UserMentionMetadata)

उपयोगकर्ता के नाम का मेटाडेटा.

slashCommand

object (SlashCommandMetadata)

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

customEmojiMetadata

object (CustomEmojiMetadata)

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

एक-दूसरे से अलग फ़ील्ड के आखिर में.

AnnotationType

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

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

UserMentionMetadata

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

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

object (User)

टैग किया गया उपयोगकर्ता.

type

enum (Type)

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

टाइप

Enums
TYPE_UNSPECIFIED enum के लिए डिफ़ॉल्ट वैल्यू. इसका इस्तेमाल न करें.
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 enum के लिए डिफ़ॉल्ट वैल्यू. इसका इस्तेमाल न करें.
ADD स्पेस में Chat ऐप्लिकेशन जोड़ें.
INVOKE स्पेस में स्लैश कमांड का इस्तेमाल करना.

RichLinkMetadata

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "driveLinkData": {
    object (DriveLinkData)
  },
  "chatSpaceLinkData": {
    object (ChatSpaceLinkData)
  },
  "meetSpaceLinkData": {
    object (MeetSpaceLinkData)
  },
  "calendarEventLinkData": {
    object (CalendarEventLinkData)
  }
}
फ़ील्ड
uri

string

इस लिंक का यूआरआई.

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

RichLinkType

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

Enums
DRIVE_FILE Google Drive के रिच लिंक का टाइप.
CHAT_SPACE Chat स्पेस का रिच लिंक टाइप. उदाहरण के लिए, स्पेस स्मार्ट चिप.
GMAIL_MESSAGE Gmail मैसेज में मौजूद रिच लिंक का टाइप. खास तौर पर, Chat में शेयर करें से मिला Gmail चिप. एपीआई सिर्फ़ GMAIL_MESSAGE रिच लिंक वाले मैसेज पढ़ सकता है.
MEET_SPACE यह Meet मैसेज में शामिल किए जाने वाले रिच लिंक का टाइप है. उदाहरण के लिए, Meet चिप.
CALENDAR_EVENT Calendar मैसेज में रिच लिंक का टाइप. उदाहरण के लिए, Calendar चिप.

DriveLinkData

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

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

object (DriveDataRef)

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

mimeType

string

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

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)

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

टाइप

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

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

HuddleStatus

हडल का स्टेटस

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

CalendarEventLinkData

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

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

string

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

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)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dialog": {
    object (Dialog)
  }
}
फ़ील्ड
actionStatus

object (ActionStatus)

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

की जाने वाली कार्रवाई. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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 के आधार पर एक सामान्य मैसेज भेजा जाता है.

Code

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

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

Enums
OK

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

एचटीटीपी मैपिंग: 200 OK

CANCELLED

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

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

UNKNOWN

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

एचटीटीपी मैपिंग: 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 बिना अनुमति वाला अनुरोध

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

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

एचटीटीपी मैपिंग: 500 इंटरनल सर्वर की गड़बड़ी

UNAVAILABLE

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

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

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

DATA_LOSS

डेटा को वापस नहीं लाया जा सकता या उसमें कोई गड़बड़ी हुई है.

एचटीटीपी मैपिंग: 500 इंटरनल सर्वर की गड़बड़ी

UpdatedWidget

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "suggestions": {
    object (SelectionItems)
  }
}
फ़ील्ड
widget

string

अपडेट किए गए विजेट का आईडी. आईडी, उस विजेट के आईडी से मेल खाना चाहिए जिसने अपडेट करने का अनुरोध ट्रिगर किया है.

उपयोगकर्ता की कार्रवाई के जवाब में अपडेट किया गया विजेट. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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

किसी ऐसे मैसेज के बारे में जानकारी जिसे किसी दूसरे मैसेज में कोट किया गया है.

मैसेज अपडेट करते समय, quotedMessageMetadata फ़ील्ड को जोड़ा या बदला नहीं जा सकता. हालांकि, इसे हटाया जा सकता है.

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

JSON के काेड में दिखाना
{
  "name": string,
  "lastUpdateTime": string,
  "quoteType": enum (QuoteType),
  "quotedMessageSnapshot": {
    object (QuotedMessageSnapshot)
  },
  "forwardedMetadata": {
    object (ForwardedMetadata)
  }
}
फ़ील्ड
name

string

ज़रूरी है. कोट किए गए मैसेज का संसाधन नाम.

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

lastUpdateTime

string (Timestamp format)

ज़रूरी है. कोट किए गए मैसेज के बनाए जाने या अपडेट किए जाने का टाइमस्टैंप.

अगर मैसेज में बदलाव किया गया है, तो इस फ़ील्ड lastUpdateTime का इस्तेमाल करें. अगर मैसेज में कभी बदलाव नहीं किया गया है, तो createTime का इस्तेमाल करें.

अगर lastUpdateTime, कोट किए गए मैसेज के नए वर्शन से मेल नहीं खाता है, तो अनुरोध पूरा नहीं किया जा सकेगा.

quoteType

enum (QuoteType)

ज़रूरी नहीं. इससे कोटेशन का टाइप पता चलता है. अगर इस नीति की वैल्यू सेट नहीं है, तो यह पिछले वर्शन के साथ काम करने के लिए, मैसेज पढ़ने/लिखने के पाथ में REPLY पर डिफ़ॉल्ट रूप से सेट हो जाती है.

quotedMessageSnapshot

object (QuotedMessageSnapshot)

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

forwardedMetadata

object (ForwardedMetadata)

सिर्फ़ आउटपुट के लिए. कोट किए गए मैसेज के सोर्स स्पेस के बारे में मेटाडेटा. यह सिर्फ़ FORWARD कोट टाइप के लिए भरा जाता है.

QuoteType

कोट किए गए मैसेज का कोट टाइप.

Enums
QUOTE_TYPE_UNSPECIFIED बुक किया गया. इस वैल्यू का इस्तेमाल नहीं किया गया है.
REPLY

quoteType के REPLY होने पर, ये काम किए जा सकते हैं:

  • अगर आपको किसी थ्रेड में जवाब देना है, तो उस थ्रेड में मौजूद किसी दूसरे मैसेज को कोट किया जा सकता है.

  • अगर आपको कोई रूट मैसेज बनाना है, तो उस स्पेस में मौजूद किसी दूसरे रूट मैसेज को कोट किया जा सकता है.

FORWARD

जब quoteType FORWARD हो, तब इनमें से किसी को कोट किया जा सकता है:

  • किसी दूसरे स्पेस से मिला मैसेज.

  • एक ही स्पेस में किसी दूसरे थ्रेड में मौजूद मैसेज का जवाब.

QuotedMessageSnapshot

यह कोट किए गए मैसेज के कॉन्टेंट का स्नैपशॉट दिखाता है. यह स्नैपशॉट, मैसेज को कोट या फ़ॉरवर्ड करने के समय का होता है

JSON के काेड में दिखाना
{
  "sender": string,
  "text": string,
  "formattedText": string,
  "annotations": [
    {
      object (Annotation)
    }
  ],
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
फ़ील्ड
sender

string

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

text

string

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

formattedText

string

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

annotations[]

object (Annotation)

सिर्फ़ आउटपुट के लिए. कोट किए गए मैसेज के टेक्स्ट से पार्स किए गए एनोटेशन. यह सिर्फ़ FORWARD कोट टाइप के लिए भरा जाता है.

attachments[]

object (Attachment)

सिर्फ़ आउटपुट के लिए. कोट किए गए मैसेज में मौजूद अटैचमेंट. ये कोट किए गए मैसेज के अटैचमेंट के मेटाडेटा की कॉपी हैं. यह सिर्फ़ FORWARD कोट टाइप के लिए भरा जाता है.

ForwardedMetadata

उस सोर्स स्पेस के बारे में मेटाडेटा जिससे मैसेज फ़ॉरवर्ड किया गया था.

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

string

सिर्फ़ आउटपुट के लिए. सोर्स स्पेस का संसाधन नाम. फ़ॉर्मैट: spaces/{space}

spaceDisplayName

string

सिर्फ़ आउटपुट के लिए. फ़ॉरवर्ड करते समय, सोर्स स्पेस या डीएम का डिसप्ले नेम. SPACE के लिए, यह स्पेस का नाम है. DIRECT_MESSAGE के लिए, यह बातचीत में शामिल दूसरे व्यक्ति का नाम है. उदाहरण के लिए, "उपयोगकर्ता A". GROUP_CHAT के लिए, यह नाम पैसे चुकाकर बने सदस्यों के नामों के आधार पर जनरेट किया जाता है.इसमें क्रिएटर के नाम के साथ-साथ, ज़्यादा से ज़्यादा पांच नाम शामिल किए जा सकते हैं. उदाहरण के लिए, "उपयोगकर्ता A, उपयोगकर्ता B".

AttachedGif

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

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

string

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

AccessoryWidget

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "buttonList": {
    object (ButtonList)
  }
}
फ़ील्ड
कार्रवाई का टाइप. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
buttonList

object (ButtonList)

बटन की सूची.

एक-दूसरे से अलग फ़ील्ड के आखिर में.

एलिमेंट

एलिमेंट, अतिरिक्त कॉम्पोनेंट होते हैं. ये मैसेज बनाते समय दिए गए मैसेज टेक्स्ट से जुड़े हो सकते हैं या नहीं भी हो सकते हैं.

JSON के काेड में दिखाना
{
  "citedSources": [
    {
      object (CitedSource)
    }
  ],
  "citations": [
    {
      object (Citation)
    }
  ]
}
फ़ील्ड
citedSources[]

object (CitedSource)

मैसेज के नीचे फ़ुटर लिंक के तौर पर दिखाए जाने वाले सोर्स की सूची. इन्हें इनलाइन के तौर पर नहीं दिखाया जाता. इनलाइन रेफ़रंस के लिए, citations का इस्तेमाल करें.

citations[]

object (Citation)

मैसेज के टेक्स्ट में शामिल इनलाइन उद्धरणों की सूची. इन्हें <chat-citation> टैग के ज़रिए शामिल किया जाता है. ये इंटरैक्टिव कार्ड के तौर पर दिखते हैं.

CitedSource

जानकारी के सोर्स का रेफ़रंस.

JSON के काेड में दिखाना
{
  "title": string,
  "uri": string,
  "snippet": {
    object (Snippet)
  },
  "footer": {
    object (Footer)
  }
}
फ़ील्ड
title

string

ज़रूरी है. CitedSource का सादा टेक्स्ट वाला टाइटल. इस फ़ील्ड में फ़ॉर्मैटिंग की सुविधा उपलब्ध नहीं है.

uri

string

ज़रूरी है. यह यूआरआई, इस CitedSource से रेफ़र किए गए संसाधन की ओर ले जाता है.

snippet

object (Snippet)

ज़रूरी नहीं. स्निपेट में, सीधे सोर्स से मिली जानकारी शामिल होती है.

footer

object (Footer)

ज़रूरी नहीं. फ़ुटर के तौर पर स्निपेट के साथ दिखाने के लिए अतिरिक्त जानकारी.

स्निपेट

स्निपेट ऑब्जेक्ट, बड़े कॉर्पस के किसी हिस्से को दिखाता है.

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

string

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

imagePreview

object (ElementsImage)

ज़रूरी नहीं. उद्धरण बनाते समय, इनपुट के तौर पर दिए गए स्निपेट की इमेज की झलक.

ElementsImage

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

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

  "imageUri": string
}
फ़ील्ड
ज़रूरी है. इमेज के लिए, इनमें से कोई एक फ़ॉर्मैट इस्तेमाल किया गया हो. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
imageUri

string

ज़रूरी है. इमेज के लिए, सार्वजनिक तौर पर ऐक्सेस किया जा सकने वाला यूआरआई.

एक-दूसरे से अलग फ़ील्ड के आखिर में.

यह किसी सोर्स का फ़ुटर होता है. इसका इस्तेमाल एट्रिब्यूशन के लिए किया जाता है.

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

string

ज़रूरी नहीं. फ़ुटर में दिखने वाला टेक्स्ट.

उद्धरण

साइटेशन, इनलाइन रेफ़रंस होते हैं. इनसे लोगों को इनलाइन रेफ़रंस के बारे में ज़्यादा जानकारी मिल सकती है. मैसेज के टेक्स्ट में, <chat-citation data-id="{id}">{text}</chat-citation> के मार्कअप फ़ॉर्मैट में इनलाइन उद्धरण मौजूद होने चाहिए. सिर्फ़ तब उद्धरण जोड़े जा सकते हैं, जब मैसेज के markupSyntax को MARKDOWN पर सेट किया गया हो.

Elements.citations में मौजूद ऐसे उद्धरणों को अनदेखा कर दिया जाता है जिनके लिए मैसेज के टेक्स्ट में <chat-citation> टैग मौजूद नहीं होता. इससे मैसेज अस्वीकार नहीं होता.

JSON के काेड में दिखाना
{
  "id": string,
  "citedSources": [
    {
      object (CitedSource)
    }
  ]
}
फ़ील्ड
id

string

ज़रूरी है. ऐप्लिकेशन के हिसाब से तय किया गया आईडी. इसमें सिर्फ़ ASCII अक्षर और संख्याएं होनी चाहिए. साथ ही, इसमें 63 से कम वर्ण होने चाहिए.

citedSources[]

object (CitedSource)

ज़रूरी नहीं. उद्धरण से जुड़े सोर्स की सूची. सोर्स, उद्धरण के होवर कार्ड में दिखते हैं.

MarkupSyntax

Chat मैसेज के टेक्स्ट को फ़ॉर्मैट करने के लिए इस्तेमाल किए गए मार्कअप सिंटैक्स के बारे में बताता है. यह Message संसाधन के text फ़ील्ड पर लागू होता है.

Enums
MARKUP_SYNTAX_UNSPECIFIED इससे ऐसी वैल्यू के बारे में पता चलता है जिसके बारे में जानकारी नहीं दी गई है.
MARKUP_SYNTAX_CHAT Google Chat के मार्कअप सिंटैक्स का इस्तेमाल करता है. ज़्यादा जानकारी के लिए, https://developers.google.com/workspace/chat/format-messages#format-texts पर जाएं.
MARKUP_SYNTAX_MARKDOWN मार्कडाउन सिंटैक्स का इस्तेमाल करता है. यह सिंटैक्स, CommonMark की खास बातों पर आधारित है. इसमें कुछ और एक्सटेंशन भी शामिल हैं. ज़्यादा जानकारी के लिए, https://developers.google.com/workspace/chat/format-messages#format-texts पर जाएं.

तरीके

create

Google Chat स्पेस में कोई मैसेज बनाता है.

delete

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

get

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

list

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

patch

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

replaceCards

यह किसी मैसेज में शामिल कार्ड बदलता है.
यह फ़ंक्शन, Google Chat में उन मैसेज को खोजता है जिन्हें कॉल करने वाला व्यक्ति ऐक्सेस कर सकता है.

update

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