REST Resource: phones.agentMessages

रिसॉर्स: AgentMessage

एजेंट की ओर से किसी व्यक्ति को भेजा गया मैसेज.

JSON के काेड में दिखाना
{
  "name": string,
  "sendTime": string,
  "contentMessage": {
    object (AgentContentMessage)
  },
  "messageTrafficType": enum (MessageTrafficType),

  // Union field expiration can be only one of the following:
  "expireTime": string,
  "ttl": string
  // End of list of possible types for union field expiration.
}
फ़ील्ड
name

string

इस फ़ील्ड को RBM प्लैटफ़ॉर्म सेट करता है. एजेंट का मैसेज बनाते समय, इसे शामिल न करें. यह फ़ील्ड "phones/{E.164}/agentMessages/{messageId}" को हल करता है. इसमें {E.164} उपयोगकर्ता का फ़ोन नंबर E.164 फ़ॉर्मैट में होता है और {messageId} एजेंट के मैसेज का एजेंट-असाइन किया गया आईडी होता है.

sendTime

string (Timestamp format)

इस फ़ील्ड को RBM प्लैटफ़ॉर्म सेट करता है. एजेंट का मैसेज बनाते समय, इसे शामिल न करें. इस फ़ील्ड से, उपयोगकर्ता को मैसेज भेजे जाने के समय के बारे में पता चलता है.

यह RFC 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

contentMessage

object (AgentContentMessage)

एजेंट के मैसेज का कॉन्टेंट.

messageTrafficType

enum (MessageTrafficType)

मैसेज ट्रैफ़िक का टाइप.

यूनियन फ़ील्ड expiration.

expiration इनमें से सिर्फ़ एक हो सकता है:

expireTime

string (Timestamp format)

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

यह RFC 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

ttl

string (Duration format)

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

यह अवधि सेकंड में होती है. इसमें नौ दशमलव अंक तक हो सकते हैं. इसके आखिर में 's' होता है. उदाहरण: "3.5s".

AgentContentMessage

एजेंट से किसी व्यक्ति को भेजे गए मैसेज का कॉन्टेंट.

JSON के काेड में दिखाना
{
  "suggestions": [
    {
      object (Suggestion)
    }
  ],

  // Union field content can be only one of the following:
  "text": string,
  "fileName": string,
  "uploadedRbmFile": {
    object (UploadedRbmFile)
  },
  "richCard": {
    object (RichCard)
  },
  "contentInfo": {
    object (ContentInfo)
  }
  // End of list of possible types for union field content.
}
फ़ील्ड
suggestions[]

object (Suggestion)

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

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

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

string

UTF-8 में एन्कोड किया गया टेक्स्ट. ज़्यादा से ज़्यादा 3,072 वर्ण.

fileName
(deprecated)

string

किसी फ़ाइल का यूनीक नाम. जब कोई एजेंट फ़ाइल अपलोड करता है, तो RBM प्लैटफ़ॉर्म फ़ाइल का नाम दिखाता है. इसे नीचे दिए गए uploadedRbmFile के पक्ष में बंद कर दिया गया है

uploadedRbmFile

object (UploadedRbmFile)

इसमें RBM सर्वर पर अपलोड की गई और उससे दिखाई गई फ़ाइल और थंबनेल के आइडेंटिफ़ायर होते हैं

richCard

object (RichCard)

स्टैंडअलोन रिच कार्ड.

contentInfo

object (ContentInfo)

किसी फ़ाइल के बारे में जानकारी. इसमें फ़ाइल का यूआरएल और फ़ाइल के थंबनेल का यूआरएल शामिल है.

RBM प्लैटफ़ॉर्म, कैश मेमोरी से कॉन्टेंट दिखाता है. हालांकि, एजेंट RBM प्लैटफ़ॉर्म को कॉन्टेंट का नया वर्शन फ़ेच करने और कैश मेमोरी को रीफ़्रेश करने के लिए मजबूर कर सकता है.

UploadedRbmFile

फ़ाइल और थंबनेल की जानकारी देने वाला मैसेज

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

string

फ़ाइल का नाम. यह नाम, फ़ाइल अपलोड करते समय RBM प्लैटफ़ॉर्म से मिलता है.

thumbnailName

string

थंबनेल का नाम. इसे थंबनेल अपलोड करते समय, RBM प्लैटफ़ॉर्म ने दिखाया था.

RichCard

एजेंट की ओर से उपयोगकर्ता को भेजा गया स्टैंडअलोन रिच कार्ड या रिच कार्ड का कैरसेल.

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

  // Union field card can be only one of the following:
  "carouselCard": {
    object (CarouselCard)
  },
  "standaloneCard": {
    object (StandaloneCard)
  }
  // End of list of possible types for union field card.
}
फ़ील्ड
यूनियन फ़ील्ड card. स्टैंडअलोन कार्ड या कार्ड का कैरसेल. card इनमें से सिर्फ़ एक हो सकता है:
carouselCard

object (CarouselCard)

कार्ड का कैरसेल.

standaloneCard

object (StandaloneCard)

स्टैंडअलोन कार्ड.

CarouselCard

कार्ड का कैरसेल.

JSON के काेड में दिखाना
{
  "cardWidth": enum (CarouselCard.CardWidth),
  "cardContents": [
    {
      object (CardContent)
    }
  ]
}
फ़ील्ड
cardWidth

enum (CarouselCard.CardWidth)

कैरसेल में मौजूद कार्ड की चौड़ाई.

cardContents[]

object (CardContent)

कैरसेल में मौजूद हर कार्ड के लिए कॉन्टेंट की सूची. किसी कैरसेल में कम से कम दो और ज़्यादा से ज़्यादा 10 कार्ड हो सकते हैं.

CarouselCard.CardWidth

कैरसेल में मौजूद कार्ड की चौड़ाई.

Enums
CARD_WIDTH_UNSPECIFIED जानकारी नहीं दी गई है.
SMALL 120 डीपी. ध्यान दें कि लंबे मीडिया का इस्तेमाल नहीं किया जा सकता.
MEDIUM 232 डीपी.

CardContent

कार्ड का कॉन्टेंट

JSON के काेड में दिखाना
{
  "title": string,
  "description": string,
  "media": {
    object (Media)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ]
}
फ़ील्ड
title

string

(ज़रूरी नहीं) कार्ड का टाइटल. ज़्यादा से ज़्यादा 200 वर्ण.

description

string

(ज़रूरी नहीं) कार्ड की जानकारी. ज़्यादा से ज़्यादा 2,000 वर्ण.

media

object (Media)

(ज़रूरी नहीं) कार्ड में शामिल करने के लिए मीडिया (इमेज, GIF, वीडियो, PDF).

suggestions[]

object (Suggestion)

(ज़रूरी नहीं) कार्ड में शामिल करने के लिए सुझावों की सूची. ज़्यादा से ज़्यादा चार सुझाव.

मीडिया

रिच कार्ड में मौजूद मीडिया फ़ाइल.

JSON के काेड में दिखाना
{
  "height": enum (Media.Height),

  // Union field content can be only one of the following:
  "fileName": string,
  "uploadedRbmFile": {
    object (UploadedRbmFile)
  },
  "contentInfo": {
    object (ContentInfo)
  }
  // End of list of possible types for union field content.
}
फ़ील्ड
height

enum (Media.Height)

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

यूनियन फ़ील्ड content. मीडिया कॉन्टेंट content इनमें से सिर्फ़ एक हो सकता है:
fileName
(deprecated)

string

फ़ाइल का यूनीक नाम. इसे फ़ाइल अपलोड करते समय, RBM प्लैटफ़ॉर्म से वापस भेजा जाता है. इसे नीचे दिए गए uploadedRbmFile के पक्ष में बंद कर दिया गया है

uploadedRbmFile

object (UploadedRbmFile)

इसमें RBM सर्वर पर अपलोड की गई और उससे दिखाई गई फ़ाइल और थंबनेल के आइडेंटिफ़ायर होते हैं

contentInfo

object (ContentInfo)

किसी फ़ाइल के बारे में जानकारी. इसमें फ़ाइल का यूआरएल और फ़ाइल के थंबनेल का यूआरएल शामिल है.

RBM प्लैटफ़ॉर्म, कैश मेमोरी से कॉन्टेंट दिखाता है. हालांकि, एजेंट RBM प्लैटफ़ॉर्म को कॉन्टेंट का नया वर्शन फ़ेच करने और कैश मेमोरी को रीफ़्रेश करने के लिए मजबूर कर सकता है.

ContentInfo

कॉन्टेंट की जानकारी देने वाला मैसेज.

JSON के काेड में दिखाना
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "forceRefresh": boolean
}
फ़ील्ड
fileUrl

string

फ़ाइल का ऐसा यूआरएल जिसे कोई भी ऐक्सेस कर सके. जब RBM प्लैटफ़ॉर्म फ़ाइल फ़ेच करता है, तब वह एचटीटीपी हेडर में मौजूद कॉन्टेंट-टाइप फ़ील्ड से फ़ाइल का MIME टाइप तय करता है. यूआरएल से मिले एचटीटीपी रिस्पॉन्स में, कॉन्टेंट-टाइप फ़ील्ड मौजूद होना चाहिए और उसमें दी गई जानकारी सटीक होनी चाहिए. हमारा सुझाव है कि फ़ाइल का साइज़ 100 एमबी से ज़्यादा न हो.

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

thumbnailUrl

string

(सिर्फ़ इमेज, ऑडियो, और वीडियो फ़ाइलों के लिए ज़रूरी नहीं) थंबनेल का ऐसा यूआरएल जिसे सार्वजनिक तौर पर ऐक्सेस किया जा सकता हो. इसका साइज़ 100 केबी से ज़्यादा नहीं होना चाहिए.

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

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

forceRefresh

boolean

अगर यह विकल्प सेट किया जाता है, तो RBM प्लैटफ़ॉर्म, फ़ाइल और थंबनेल को बताए गए यूआरएल से फ़ेच करता है. भले ही, प्लैटफ़ॉर्म के पास फ़ाइल और/या थंबनेल की कैश की गई कॉपी मौजूद हों.

Media.Height

मीडिया ऊंचाई

Enums
HEIGHT_UNSPECIFIED जानकारी नहीं दी गई है.
SHORT 112 डीपी.
MEDIUM 168 डीपी.
TALL 264 डीपी. कार्ड की चौड़ाई को 'छोटा' पर सेट करने पर, रिच कार्ड कैरसेल के लिए उपलब्ध नहीं है.

सुझाव

सुझाया गया जवाब या सुझाई गई कार्रवाई, जो रिच कार्ड या सुझाव वाले चिप की सूची में शामिल है.

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

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

object (SuggestedReply)

उपयोगकर्ता, सुझाए गए जवाब पर टैप करके, एजेंट को टेक्स्ट जवाब भेज सकते हैं.

action

object (SuggestedAction)

उपयोगकर्ता, सुझाई गई कार्रवाई पर टैप करके, डिवाइस पर उससे जुड़ी कार्रवाई शुरू कर सकते हैं.

SuggestedReply

इस पर टैप करने से, एजेंट को टेक्स्ट के ज़रिए जवाब भेजा जाता है.

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

string

यह वह टेक्स्ट होता है जो सुझाए गए जवाब में दिखता है. जब उपयोगकर्ता इस पर टैप करता है, तो यह टेक्स्ट एजेंट को वापस भेज दिया जाता है. ज़्यादा से ज़्यादा 25 वर्ण.

postbackData

string

यह base64 में कोड किया गया पेलोड होता है. जब उपयोगकर्ता सुझाए गए जवाब पर टैप करता है, तब एजेंट को यह पेलोड, उपयोगकर्ता के इवेंट में मिलता है.

SuggestedAction

इस पर टैप करने से, डिवाइस पर इससे जुड़ी नेटिव कार्रवाई शुरू हो जाती है.

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

  // Union field action can be only one of the following:
  "dialAction": {
    object (DialAction)
  },
  "viewLocationAction": {
    object (ViewLocationAction)
  },
  "createCalendarEventAction": {
    object (CreateCalendarEventAction)
  },
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "shareLocationAction": {
    object (ShareLocationAction)
  }
  // End of list of possible types for union field action.
}
फ़ील्ड
text

string

सुझाई गई कार्रवाई में दिखने वाला टेक्स्ट. ज़्यादा से ज़्यादा 25 वर्ण.

postbackData

string

यह पेलोड (base64 में कोड किया गया) है. इसे उपयोगकर्ता के उस इवेंट में एजेंट को भेजा जाएगा जो उपयोगकर्ता के सुझाई गई कार्रवाई पर टैप करने से ट्रिगर होता है. ज़्यादा से ज़्यादा 2048 वर्ण.

fallbackUrl

string

(ज़रूरी नहीं) अगर कोई क्लाइंट सुझाई गई कार्रवाई के साथ काम नहीं करता है, तो इस फ़ॉलबैक यूआरएल का इस्तेमाल करें. फ़ॉलबैक यूआरएल, नई ब्राउज़र विंडो में खुलते हैं. आरएफ़सी 3986 के मुताबिक, यह एक मान्य यूआरआई होना चाहिए. ज़्यादा से ज़्यादा 2048 वर्ण.

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

object (DialAction)

इससे उपयोगकर्ता का डिफ़ॉल्ट डायलर ऐप्लिकेशन खुलता है. इसमें एजेंट की ओर से दिया गया फ़ोन नंबर पहले से भरा होता है.

viewLocationAction

object (ViewLocationAction)

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

createCalendarEventAction

object (CreateCalendarEventAction)

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

openUrlAction

object (OpenUrlAction)

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

shareLocationAction

object (ShareLocationAction)

इससे आरसीएस ऐप्लिकेशन का लोकेशन चुनने वाला टूल खुलता है, ताकि उपयोगकर्ता एजेंट को अपनी जगह की जानकारी भेज सके.

DialAction

इससे उपयोगकर्ता का डिफ़ॉल्ट डायलर ऐप्लिकेशन खुलता है. इसमें एजेंट की ओर से दिया गया फ़ोन नंबर पहले से भरा होता है.

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

string

E.164 फ़ॉर्मैट में फ़ोन नंबर. उदाहरण के लिए, +12223334444.

ViewLocationAction

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

JSON के काेड में दिखाना
{
  "latLong": {
    object (LatLng)
  },
  "label": string,
  "query": string
}
फ़ील्ड
latLong

object (LatLng)

(ज़रूरी नहीं) बताई गई जगह का अक्षांश और देशांतर.

label

string

(ज़रूरी नहीं) latLong पर पिन किए गए मार्कर का लेबल.

query

string

(ज़रूरी नहीं, सिर्फ़ Android Messages क्लाइंट पर काम करता है) एजेंट, latLong (और चाहें, तो लेबल) के बजाय क्वेरी स्ट्रिंग तय कर सकता है. डिफ़ॉल्ट मैप ऐप्लिकेशन में खोज की सुविधा होती है. इनमें Google Maps भी शामिल है. इस सुविधा के तहत सुझाए गए ऐक्शन पर टैप करने से, उपयोगकर्ता की मौजूदा जगह के आस-पास की जगहें खोजी जाती हैं. अगर क्वेरी में जगह की जानकारी साफ़ तौर पर दी गई है, तो एजेंट इसका इस्तेमाल करके दुनिया की किसी भी जगह को चुन सकते हैं.

उदाहरण के लिए, क्वेरी स्ट्रिंग को "Growing Tree Bank" पर सेट करने से, उपयोगकर्ता को उसके आस-पास मौजूद Growing Tree Bank की सभी लोकेशन दिखेंगी. क्वेरी स्ट्रिंग को "1600 Amphitheater Parkway, Mountain View, CA 94043" पर सेट करने से, उस पते को चुना जाएगा. भले ही, उपयोगकर्ता की जगह कोई भी हो.

LatLng

यह ऑब्जेक्ट, अक्षांश/देशांतर की जोड़ी को दिखाता है. इसे डबल के तौर पर दिखाया जाता है, ताकि अक्षांश और देशांतर की डिग्री को दिखाया जा सके. जब तक अलग से कोई जानकारी न दी जाए, तब तक इस ऑब्जेक्ट को WGS84 स्टैंडर्ड के मुताबिक होना चाहिए. वैल्यू, सामान्य की गई सीमाओं के अंदर होनी चाहिए.

JSON के काेड में दिखाना
{
  "latitude": number,
  "longitude": number
}
फ़ील्ड
latitude

number

डिग्री में अक्षांश. यह [-90.0, +90.0] की रेंज में होना चाहिए.

longitude

number

डिग्री में देशांतर. यह [-180.0, +180.0] की रेंज में होना चाहिए.

CreateCalendarEventAction

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

JSON के काेड में दिखाना
{
  "startTime": string,
  "endTime": string,
  "title": string,
  "description": string
}
फ़ील्ड
startTime

string (Timestamp format)

इवेंट के शुरू होने का समय.

यह RFC 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

इवेंट के खत्म होने का समय.

यह RFC 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

title

string

इवेंट का टाइटल. ज़्यादा से ज़्यादा 100 वर्ण.

description

string

इवेंट की जानकारी. ज़्यादा से ज़्यादा 500 वर्ण.

OpenUrlAction

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

JSON के काेड में दिखाना
{
  "url": string,
  "application": enum (OpenUrlApplication),
  "webviewViewMode": enum (WebviewViewMode),
  "description": string
}
फ़ील्ड
url

string

खोलने के लिए यूआरएल. यूआरएल स्कीम, 1 नवंबर, 2025 से https:// या http:// होनी चाहिए. इस तारीख के बाद, किसी अन्य स्कीम (जैसे कि tel:, mailto:, sms:) का इस्तेमाल करके किए गए एपीआई अनुरोधों को अस्वीकार कर दिया जाएगा. साथ ही, 400 Bad Request गड़बड़ी का मैसेज दिखेगा. यूआरएल, आरएफ़सी 3986 में बताए गए मान्य यूआरआई के मुताबिक होना चाहिए. ज़्यादा से ज़्यादा 2048 वर्ण.

application

enum (OpenUrlApplication)

यूआरएल खोलने वाला ऐप्लिकेशन, ब्राउज़र या वेबव्यू. यह देखने के लिए कि किसी उपयोगकर्ता के डिवाइस पर वेबव्यू मोड काम करता है या नहीं, पहले यह जांच करें कि डिवाइस में यह सुविधा उपलब्ध है या नहीं. ज़्यादा जानकारी के लिए, यह दस्तावेज़ देखें: https://developers.google.com/business-communications/rcs-business-messaging/guides/build/capabilities.

webviewViewMode

enum (WebviewViewMode)

वेबव्यू के लिए व्यू मोड

description

string

वेबव्यू के लिए सुलभता की जानकारी.

OpenUrlApplication

यूआरएल खोलने वाले ऐप्लिकेशन का टाइप

Enums
OPEN_URL_APPLICATION_UNSPECIFIED यह जानकारी नहीं दी गई है. इसे खोलने के लिए ब्राउज़र का इस्तेमाल किया जाएगा.
BROWSER यूआरएल खोलने के लिए ब्राउज़र का इस्तेमाल करें.
WEBVIEW यूआरएल को इंटिग्रेटेड वेब व्यू विंडो में खोलें

WebviewViewMode

वेबव्यू के व्यू मोड का टाइप.

Enums
WEBVIEW_VIEW_MODE_UNSPECIFIED जानकारी नहीं दी गई है. वेबव्यू का इस्तेमाल करने के लिए, व्यू मोड तय करना ज़रूरी है.
FULL इसमें फ़ुल स्क्रीन ओवरले की ज़रूरत होती है. साथ ही, स्टेटस बार में चैटबॉट से हुई बातचीत को लेबल किया जाता है.
HALF इसके लिए, हाफ़ स्क्रीन ओवरले की ज़रूरत होती है.
TALL इसके लिए, स्क्रीन का तीन-चौथाई हिस्सा ओवरले करना ज़रूरी है.

ShareLocationAction

इस टाइप में कोई फ़ील्ड नहीं है.

इससे आरसीएस ऐप्लिकेशन का लोकेशन चूज़र खुलता है, ताकि उपयोगकर्ता एजेंट को वापस भेजने के लिए कोई जगह चुन सके.

StandaloneCard

स्टैंडअलोन कार्ड

JSON के काेड में दिखाना
{
  "cardOrientation": enum (StandaloneCard.CardOrientation),
  "thumbnailImageAlignment": enum (StandaloneCard.ThumbnailImageAlignment),
  "cardContent": {
    object (CardContent)
  }
}
फ़ील्ड
cardOrientation

enum (StandaloneCard.CardOrientation)

कार्ड का ओरिएंटेशन.

thumbnailImageAlignment

enum (StandaloneCard.ThumbnailImageAlignment)

हॉरिज़ॉन्टल लेआउट वाले स्टैंडअलोन कार्ड के लिए, इमेज की झलक दिखाने की सुविधा.

cardContent

object (CardContent)

कार्ड का कॉन्टेंट.

StandaloneCard.CardOrientation

कार्ड का ओरिएंटेशन.

Enums
CARD_ORIENTATION_UNSPECIFIED जानकारी नहीं दी गई है.
HORIZONTAL

हॉरिज़ॉन्टल लेआउट.

अगर किसी हॉरिज़ॉन्टल रिच कार्ड के object(CardContent) में media फ़ील्ड शामिल है, तो इसमें कम से कम एक title, description या suggestions[] फ़ील्ड भी शामिल होना चाहिए.

VERTICAL वर्टिकल लेआउट.

StandaloneCard.ThumbnailImageAlignment

हॉरिज़ॉन्टल लेआउट वाले स्टैंडअलोन कार्ड के लिए, इमेज की झलक दिखाने की सुविधा.

Enums
THUMBNAIL_IMAGE_ALIGNMENT_UNSPECIFIED जानकारी नहीं दी गई है.
LEFT फ़ाइल की झलक को बाईं ओर अलाइन किया गया है.
RIGHT फ़ाइल की झलक, दाईं ओर अलाइन की गई है.

MessageTrafficType

मैसेज ट्रैफ़िक के साथ काम करने वाले टाइप. ज़्यादा ट्रैफ़िक टाइप के साथ काम करने के लिए, enum को बढ़ाया जाएगा.

Enums
MESSAGE_TRAFFIC_TYPE_UNSPECIFIED डिफ़ॉल्ट व्यवहार: मैसेज के ट्रैफ़िक टाइप का पता, एजेंट के इस्तेमाल के उदाहरण से चलता है. मैसेज के कॉन्टेंट के आधार पर, ट्रैफ़िक टाइप को ज़रूरत के हिसाब से अपडेट करें. एक से ज़्यादा कामों के लिए इस्तेमाल किए जाने वाले एजेंट के लिए, कोई डिफ़ॉल्ट वैल्यू नहीं दी जाती है. ट्रैफ़िक टाइप को मैन्युअल तरीके से सेट किया जाना चाहिए. उदाहरण के लिए, TRANSACTION, PROMOTION).
AUTHENTICATION ओटीपी एजेंट के इस्तेमाल के उदाहरण में पुष्टि करने वाले मैसेज के लिए.
TRANSACTION लेन-देन से जुड़े मैसेज के लिए, लेन-देन या कई कामों के लिए इस्तेमाल होने वाले एजेंट के इस्तेमाल के उदाहरण.
PROMOTION प्रमोशन से जुड़े मैसेज के लिए, प्रमोशन या कई कामों के लिए इस्तेमाल होने वाले एजेंट के इस्तेमाल के उदाहरण.
SERVICEREQUEST उन सेवाओं के बारे में मैसेज पाने के लिए जिनके लिए उपयोगकर्ता ने सहमति दी है. इसका इस्तेमाल ओटीपी, लेन-देन, प्रमोशन या एजेंट के कई कामों के लिए किया जाता है.
ACKNOWLEDGEMENT उन ईमेल के लिए जिनमें सदस्यता छोड़ने के अनुरोध की पुष्टि की गई हो. इसका इस्तेमाल ओटीपी, लेन-देन, प्रमोशन या एजेंट के कई कामों के लिए किया जाता है.

तरीके

create

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

delete

भेजे गए ऐसे एजेंट मैसेज को रद्द करता है जो अब तक डिलीवर नहीं हुआ है.