REST Resource: phones.agentMessages

संसाधन: AgentMessage

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

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

  // 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

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

string (Timestamp format)

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

यह आरएफ़सी 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)

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

object (RichMessageClassification)

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

string (int64 format)

सिर्फ़ आउटपुट के लिए. मैसेज के कुल पेलोड का साइज़, बाइट में. पे लोड में, RCS for Business मैसेज में मौजूद सभी अटैचमेंट शामिल होते हैं. जैसे, वीडियो, इमेज, PDF वगैरह. हालांकि, इसमें मैसेज का टेक्स्ट या सुझाव शामिल नहीं होते. फ़िलहाल, इस फ़ील्ड में सिर्फ़ अमेरिका के फ़ोन नंबर की जानकारी भरी जाती है.
carrier

string

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

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

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

string (Timestamp format)

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

यह आरएफ़सी 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 सुझाव.

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

सुझाव के पैटर्न दो तरह के होते हैं: लगातार दिखने वाले और कुछ समय के लिए दिखने वाले. ज़्यादा जानकारी के लिए, सुझाव देखें.
यूनियन फ़ील्ड content. एजेंट के मैसेज content का कॉन्टेंट इनमें से सिर्फ़ एक हो सकता है:
text

string

UTF-8 में एन्कोड किया गया टेक्स्ट. ज़्यादा से ज़्यादा 3072 वर्ण.
fileName
(deprecated)

string

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

object (UploadedRbmFile)

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

object (RichCard)

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

object (ContentInfo)

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

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

UploadedRbmFile

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

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

string

यह फ़ाइल का वह नाम है जो फ़ाइल अपलोड होने पर, RCS for Business प्लैटफ़ॉर्म से मिलता है.
thumbnailName

string

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

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

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

object (UploadedRbmFile)

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

object (ContentInfo)

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

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

ContentInfo

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

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

string

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

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

string

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

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

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

boolean

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

Media.Height

मीडिया ऊंचाई

Enums
HEIGHT_UNSPECIFIED जानकारी नहीं दी गई है.
SHORT 112 डीपी.
MEDIUM 168 डीपी.
TALL 264 डीपी.

सुझाव

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

JSON के काेड में दिखाना 
{
  "suggestionDisplay": enum (Suggestion.SuggestionDisplay),

  // 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.
}
फ़ील्ड
suggestionDisplay

enum (Suggestion.SuggestionDisplay)

ज़रूरी नहीं. इससे यह कंट्रोल किया जाता है कि सुझाव किस तरह दिखेगा. यह सुविधा, Google Messages क्लाइंट (वर्शन 20260225.00 या इसके बाद का वर्शन) को भेजे गए सिर्फ़ सामान्य टेक्स्ट वाले मैसेज पर लागू होती है. इस फ़ील्ड को सिर्फ़ उन स्टैंडअलोन सुझावों पर सेट किया जाना चाहिए जो सामान्य टेक्स्ट मैसेज से जुड़े हैं. अगर इस फ़ील्ड को रिच कार्ड या फ़ाइल ट्रांसफ़र की सुविधा वाले स्टैंडअलोन सुझावों में लागू किया जाता है, तो सर्वर मैसेज को अस्वीकार कर देगा. यह सेटिंग सिर्फ़ Google Messages के लिए सीरियल की जाती है. इसे अन्य क्लाइंट (जैसे, iOS या Samsung) अनदेखा कर देते हैं.
यूनियन फ़ील्ड 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

यह बेस64 कोड में बदला गया पेलोड है. इसे उपयोगकर्ता के उस इवेंट में एजेंट को भेजा जाएगा जो उपयोगकर्ता के सुझाई गई कार्रवाई पर टैप करने से ट्रिगर होता है. ज़्यादा से ज़्यादा 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

(ज़रूरी नहीं) एजेंट, 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)

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

यह आरएफ़सी 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)

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

यह आरएफ़सी 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

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

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

Suggestion.SuggestionDisplay

स्टैंडअलोन टेक्स्ट के सुझावों को दिखाने का तरीका.

Enums
SUGGESTION_DISPLAY_UNSPECIFIED

क्लाइंट, डिसप्ले के डिफ़ॉल्ट तरीके को लागू करते हैं:

  • Google Messages में सिर्फ़ टेक्स्ट वाले मैसेज के लिए: नए मैसेज भेजने या पाने के बाद, सुझाव दिखना बंद हो जाते हैं.
  • iOS पर सिर्फ़ टेक्स्ट वाले मैसेज के लिए: सुझाव सिर्फ़ तब दिखना बंद होते हैं, जब उपयोगकर्ता उन पर टैप करता है.
  • रिच कार्ड के सभी क्लाइंट के लिए: सुझाव हमेशा बने रहते हैं; रिच कार्ड पर suggestionDisplay सेट करने पर, 400 गड़बड़ी होगी.
PERSISTENT यह सुझाव, मैसेज बबल में हमेशा दिखता रहता है. भले ही, बातचीत में नए मैसेज जुड़ते रहें.

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 उन मैसेज के लिए जिनमें उपयोगकर्ता के सदस्यता छोड़ने के अनुरोध की पुष्टि की गई हो. इसका इस्तेमाल ओटीपी, लेन-देन, प्रमोशन या एजेंट के कई इस्तेमाल के उदाहरणों में किया जाता है.

RichMessageClassification

सिर्फ़ अमेरिका में बिलिंग के लिए: बिलिंग के लिए इस्तेमाल किए गए मैसेज के टाइप के बारे में जानकारी.

JSON के काेड में दिखाना 
{
  "classificationType": enum (RichMessageClassificationType),
  "segmentCount": integer
}
फ़ील्ड
classificationType

enum (RichMessageClassificationType)
segmentCount

integer

मैसेज के टेक्स्ट के लिए 160 बाइट वाले सेगमेंट की संख्या. इसे हमेशा पूर्णांक में बदला जाता है.

इसकी गिनती सिर्फ़ टेक्स्ट कॉन्टेंट की कुल UTF-8 बाइट लेंथ के आधार पर की जाती है. इसमें सुझाए गए जवाबों या कार्रवाइयों का डेटा शामिल नहीं होता.

उदाहरण के लिए, 300 बाइट के टेक्स्ट मैसेज में segmentCount की वैल्यू 2 होती है.

यह फ़ील्ड सिर्फ़ RICH_MESSAGE टाइप के लिए अपने-आप भर जाता है.

RichMessageClassificationType

सिर्फ़ अमेरिका में बिलिंग के लिए: इससे बिलिंग के लिए मैसेज की कैटगरी तय की जाती है.

अहम जानकारी: अमेरिका में मोबाइल और इंटरनेट सेवा देने वाली कंपनियां, इस पेज पर बताए गए बिल किए जा सकने वाले मैसेज टाइप के लिए कीमत तय करती हैं. अमेरिका में मोबाइल और इंटरनेट सेवा देने वाली कंपनियां, RCS for Business मैसेज भेजने के लिए डेवलपर से लिया जाने वाला फ़ाइनल शुल्क भी तय करती हैं. कीमत या बिलिंग की जानकारी पाने के लिए, कृपया मोबाइल और इंटरनेट सेवा देने वाली कंपनी के प्रतिनिधियों से संपर्क करें.

Enums
RICH_MESSAGE_CLASSIFICATION_TYPE_UNSPECIFIED जानकारी नहीं दी गई
RICH_MESSAGE मैसेज को इन स्थितियों में रिच मैसेज के तौर पर क्लासिफ़ाई किया जाता है: 1. इसमें रिच कार्ड शामिल नहीं होते. 2. इसमें फ़ाइल अटैचमेंट शामिल नहीं होते. 3. इसमें सुझाई गई कार्रवाइयों में से कोई भी कार्रवाई, डायल करने की कार्रवाई या वेबव्यू का इस्तेमाल न करने वाली यूआरएल खोलने की कार्रवाई होनी चाहिए.
RICH_MEDIA_MESSAGE ऐसा कोई भी मैसेज जो RICH_MESSAGE की शर्तों को पूरा नहीं करता. इसमें ऐसे मैसेज शामिल हैं जिनमें रिच कार्ड, मीडिया फ़ाइल या ब्राउज़र में यूआरएल खोलें या डायल करें के अलावा कोई अन्य सुझाई गई कार्रवाई शामिल हो.
SUGGESTED_ACTION_CLICK इससे, सुझाई गई कार्रवाई (सुझाया गया जवाब नहीं) पर उपयोगकर्ता के टैप करने की जानकारी मिलती है. यह क्लासिफ़िकेशन सिर्फ़ उपयोगकर्ता की कार्रवाइयों पर लागू होता है. साथ ही, यह सिर्फ़ वेबुक के UserMessage पेलोड में दिखता है. यह A2P मैसेज पर लागू नहीं होता.

तरीके

create

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

delete

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