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)

सिर्फ़ आउटपुट के लिए. मैसेज लिखने वाला उपयोगकर्ता. अगर आपका चैट ऐप्लिकेशन उपयोगकर्ता के तौर पर पुष्टि करता है, तो आउटपुट में संगठन के अंदर और बाहर के उपयोगकर्ताओं के लिए, सिर्फ़ user 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)

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

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

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

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

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

object (Annotation)

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

object (Thread)

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

object (Space)

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

string

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

object (ActionResponse)

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

string

सिर्फ़ आउटपुट के लिए. मैसेज का सादा टेक्स्ट, जिसमें चैट ऐप्लिकेशन के सभी टैग हटा दिए गए हैं.
slashCommand

object (SlashCommand)

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

object (Attachment)

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

object (MatchedUrl)

सिर्फ़ आउटपुट के लिए. चैट मैसेज 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 ऐप्लिकेशन उपयोगकर्ता के तौर पर पुष्टि करता है, तो वह कार्ड मैसेज बना सकता है. अगर आपका चैट ऐप्लिकेशन, डेवलपर के लिए झलक Program का हिस्सा नहीं है, तो वह उपयोगकर्ता की पुष्टि करने वाले कार्ड नहीं बना सकता.

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

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

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

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

string

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

object (Card)

एक कार्ड. ज़्यादा से ज़्यादा साइज़ 32 केबी होना चाहिए.
ownerUser

object (User)

सिर्फ़ आउटपुट के लिए. वह ऐप्लिकेशन जिसके पास कार्ड का मालिकाना हक है.

टिप्पणी

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

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

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)

वह चैट ऐप्लिकेशन जिसका कमांड इस्तेमाल किया गया था.
type

enum (Type)

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

string

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

string (int64 format)

इस्तेमाल किए गए स्लैश कमांड का कमांड आईडी.
triggersDialog

boolean

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

टाइप

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

RichLinkMetadata

किसी संसाधन का रिच लिंक. रिच लिंक, मैसेज के सादे टेक्स्ट वाले मुख्य हिस्से से जुड़े हो सकते हैं. इसके अलावा, ये ऐसी चिप को दिखा सकते हैं जो Google Docs या Sheets जैसे Google Workspace के संसाधनों से लिंक करती हैं. इनमें 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 मैसेज के लिए रिच लिंक का टाइप. उदाहरण के लिए, कैलेंडर चिप.

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

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

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

string

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

enum (Type)

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

enum (HuddleStatus)

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

टाइप

Meet स्पेस का टाइप.

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

HuddleStatus

हडल का स्टेटस

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

CalendarEventLinkData

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

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

string

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

string

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

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

कोड

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

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

Enums
OK

यह कोई गड़बड़ी नहीं है. यह कोड, कार्रवाई पूरी होने पर दिखता है.

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

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

एचटीटीपी मैपिंग: 499 Client Closed Request
UNKNOWN

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

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

क्लाइंट ने अमान्य आर्ग्युमेंट दिया है. ध्यान दें कि यह FAILED_PRECONDITION से अलग है. INVALID_ARGUMENT से उन आर्ग्युमेंट का पता चलता है जो सिस्टम की स्थिति के बावजूद समस्या पैदा करते हैं. जैसे, फ़ाइल का गलत नाम.

एचटीटीपी मैपिंग: 400 Bad Request
DEADLINE_EXCEEDED

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

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

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

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

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

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

एचटीटीपी मैपिंग: 409 Conflict
PERMISSION_DENIED

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

एचटीटीपी मैपिंग: 403 Forbidden
UNAUTHENTICATED

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

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

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

एचटीटीपी मैपिंग: 429 Too Many Requests
FAILED_PRECONDITION

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

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

एचटीटीपी मैपिंग: 400 Bad Request
ABORTED

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

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

एचटीटीपी मैपिंग: 409 Conflict
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 Bad Request
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

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

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 किसी चैट ऐप्लिकेशन ने समयसीमा खत्म होने पर अपना मैसेज मिटा दिया.
CREATOR_VIA_APP किसी Chat ऐप्लिकेशन ने मैसेज बनाने वाले व्यक्ति की ओर से मैसेज मिटाया है. इसके लिए, उपयोगकर्ता की पुष्टि करने की सुविधा का इस्तेमाल किया गया है.
SPACE_OWNER_VIA_APP किसी चैट ऐप्लिकेशन ने स्पेस मैनेजर की ओर से मैसेज मिटाया है. इसके लिए, उपयोगकर्ता की पुष्टि करने की सुविधा का इस्तेमाल किया गया है.
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

यह चैट मैसेज के टेक्स्ट को फ़ॉर्मैट करने के लिए इस्तेमाल किए जाने वाले मार्कअप सिंटैक्स के बारे में बताता है. यह 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

 किसी मैसेज को अपडेट करता है.