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 ऐप्लिकेशन में उपयोगकर्ता के तौर पर पुष्टि की जाती है, तो आउटपुट उपयोगकर्ता 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.

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

cards[]
(deprecated)

object (Card)

अब काम नहीं करता: इसके बजाय, cardsV2 का इस्तेमाल करें.

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

cardsV2[]

object (CardWithId)

कार्ड का कलेक्शन.

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

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

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

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

annotations[]

object (Annotation)

सिर्फ़ आउटपुट के लिए. इस मैसेज में मौजूद text से जुड़ी जानकारी.

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

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

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

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

string

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

card

object (Card)

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

टिप्पणी

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

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

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)
  }
  // End of list of possible types for union field metadata.
}
फ़ील्ड
type

enum (AnnotationType)

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

length

integer

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

startIndex

integer

उस सादे लेख वाले मुख्य हिस्से में स्टार्ट इंडेक्स (0-आधारित, शामिल है) जिससे यह जानकारी जुड़ी है.

यूनियन फ़ील्ड metadata. एनोटेशन के बारे में अतिरिक्त मेटाडेटा. metadata इनमें से सिर्फ़ एक हो सकता है:
userMention

object (UserMentionMetadata)

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

slashCommand

object (SlashCommandMetadata)

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

AnnotationType

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

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

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

किसी संसाधन का रिच लिंक.

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

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

string

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

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

RichLinkType

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

Enums
DRIVE_FILE Google Drive का रिच लिंक.
CHAT_SPACE चैट स्पेस के लिए रिच लिंक टाइप. उदाहरण के लिए, स्पेस की सुविधा देने वाला स्मार्ट चिप.

DriveLinkData

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

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

object (DriveDataRef)

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

mimeType

string

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

ChatSpaceLinkData

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

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

string

लिंक किए गए चैट स्पेस के संसाधन का स्पेस.

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

thread

string

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

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

message

string

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

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

थ्रेड

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

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

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

सेवा लागू करने वाले लोग, FAILED_PRECONDITION, ABORTED, और UNAVAILABLE के बीच फ़ैसला लेने के लिए इन दिशा-निर्देशों का पालन कर सकते हैं: (a) अगर क्लाइंट असफल कॉल होने पर भी फिर से कोशिश कर सकता है, तो UNAVAILABLE का इस्तेमाल करें. (b) अगर क्लाइंट को बड़े लेवल पर फिर से कोशिश करनी चाहिए, तो ABORTED का इस्तेमाल करें. उदाहरण के लिए, जब क्लाइंट की ओर से तय किया गया टेस्ट और सेट काम नहीं करता, तो इसका मतलब है कि क्लाइंट को पढ़ने-में बदलाव करने का क्रम फिर से शुरू करना चाहिए. (c) अगर सिस्टम की स्थिति साफ़ तौर पर ठीक नहीं हो जाती, तो क्लाइंट को फिर से कोशिश नहीं करनी चाहिए. ऐसे में, FAILED_PRECONDITION का इस्तेमाल करें. उदाहरण के लिए, अगर एक "rmder" यह प्रोसेस पूरी नहीं हो पाती, क्योंकि डायरेक्ट्री खाली नहीं है. 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 में से किसी एक को चुनने के लिए, ऊपर दिए गए दिशा-निर्देश देखें.

HTTP मैपिंग: 503 सेवा अनुपलब्ध

DATA_LOSS

डेटा खो जाना या खराब हो जाना.

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

UpdatedWidget

अपडेट किए गए विजेट का रिस्पॉन्स. इसका इस्तेमाल किसी विजेट के लिए, अपने-आप पूरा होने वाले विकल्प देने में किया जाता है.

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)

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

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

मैसेज किसने मिटाया और कैसे मिटाया.

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

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

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