REST Resource: phones.agentMessages

संसाधन: AgentMessage

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "expireTime": string,
  "ttl": string
  // End of mutually exclusive fields.
}
फ़ील्ड
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 RCS के बैकएंड के मुताबिक, उपयोगकर्ता के फ़ोन नंबर से जुड़ी मोबाइल और इंटरनेट सेवा देने वाली कंपनी की जानकारी. फ़िलहाल, यह फ़ील्ड सिर्फ़ अमेरिका के फ़ोन नंबर के लिए भरा जाता है.

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

string (Timestamp format)

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

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

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

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

एक-दूसरे से अलग फ़ील्ड का अंत.

AgentContentMessage

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "text": string,
  "fileName": string,
  "uploadedRbmFile": {
    object (UploadedRbmFile)
  },
  "richCard": {
    object (RichCard)
  },
  "contentInfo": {
    object (ContentInfo)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
suggestions[]

object (Suggestion)

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

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

सुझाव के पैटर्न दो तरह के होते हैं: परसिस्टेंट और ट्रांज़िएंट. ज़्यादा जानकारी के लिए, सुझाव देखें.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "carouselCard": {
    object (CarouselCard)
  },
  "standaloneCard": {
    object (StandaloneCard)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
अलग से मौजूद कार्ड या कार्ड का कैरसेल. यहां ऐसे फ़ील्ड की सूची दी गई है जो एक-दूसरे से अलग हैं. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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),
  "contentDescription": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fileName": string,
  "uploadedRbmFile": {
    object (UploadedRbmFile)
  },
  "contentInfo": {
    object (ContentInfo)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
height

enum (Media.Height)

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

contentDescription

string

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "reply": {
    object (SuggestedReply)
  },
  "action": {
    object (SuggestedAction)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
suggestionDisplay

enum (Suggestion.SuggestionDisplay)

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

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

object (SuggestedReply)

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

action

object (SuggestedAction)

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

एक-दूसरे से अलग फ़ील्ड का अंत.

SuggestedReply

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

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

string

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

postbackData

string

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

SuggestedAction

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dialAction": {
    object (DialAction)
  },
  "viewLocationAction": {
    object (ViewLocationAction)
  },
  "createCalendarEventAction": {
    object (CreateCalendarEventAction)
  },
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "shareLocationAction": {
    object (ShareLocationAction)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
text

string

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

postbackData

string

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

fallbackUrl

string

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

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

वह यूआरएल जिसे खोलना है. यूआरएल स्कीम, https:// या http:// होनी चाहिए. यह शर्त 1 नवंबर, 2025 से लागू होगी. इस तारीख के बाद, किसी अन्य स्कीम (जैसे, 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

यह एजेंट के उस मैसेज को वापस लेता है जो भेजा जा चुका है, लेकिन अब तक डिलीवर नहीं हुआ है.