संसाधन: AgentMessage
एजेंट से किसी उपयोगकर्ता को भेजा गया मैसेज.
| JSON के काेड में दिखाना |
|---|
{ "name": string, "sendTime": string, "contentMessage": { object ( |
| फ़ील्ड | |
|---|---|
name |
इस फ़ील्ड को RCS for Business प्लैटफ़ॉर्म सेट करता है. एजेंट मैसेज बनाते समय इसे शामिल न करें. यह फ़ील्ड "phones/{E.164}/agentMessages/{messageId}" को रिज़ॉल्व करता है. इसमें {E.164}, E.164 फ़ॉर्मैट में उपयोगकर्ता का फ़ोन नंबर है और {messageId}, एजेंट के मैसेज का आईडी है. |
sendTime |
इस फ़ील्ड को RCS for Business प्लैटफ़ॉर्म सेट करता है. एजेंट मैसेज बनाते समय इसे शामिल न करें. इस फ़ील्ड से पता चलता है कि उपयोगकर्ता को मैसेज कब भेजा गया. यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
contentMessage |
एजेंट के मैसेज का कॉन्टेंट. |
messageTrafficType |
मैसेज ट्रैफ़िक का टाइप. |
richMessageClassification |
सिर्फ़ आउटपुट के लिए. यह अमेरिका के बिलिंग मॉडल के हिसाब से मैसेज को कैटगरी में बांटता है. हर क्लासिफ़िकेशन टाइप के बारे में ज़्यादा जानने के लिए, अमेरिका के लिए बिलिंग मॉडल गाइड देखें. यह फ़ील्ड सिर्फ़ अमेरिका के फ़ोन नंबर के लिए भरा जाता है. |
totalPayloadSizeBytes |
सिर्फ़ आउटपुट के लिए. मैसेज का कुल पेलोड साइज़, बाइट में. पेलोड में, RCS for Business मैसेज में मौजूद सभी अटैचमेंट गिने जाते हैं. इनमें वीडियो, इमेज, PDF वगैरह शामिल हो सकते हैं. हालांकि, मैसेज के टेक्स्ट या सुझावों को इसमें शामिल नहीं किया जाता. फ़िलहाल, यह फ़ील्ड सिर्फ़ अमेरिका के फ़ोन नंबर के लिए भरा जाता है. |
carrier |
सिर्फ़ आउटपुट के लिए. Google RCS के बैकएंड के मुताबिक, उपयोगकर्ता के फ़ोन नंबर से जुड़ी मोबाइल और इंटरनेट सेवा देने वाली कंपनी की जानकारी. फ़िलहाल, यह फ़ील्ड सिर्फ़ अमेरिका के फ़ोन नंबर के लिए भरा जाता है. |
| यहां ऐसे फ़ील्ड की सूची दी गई है जो एक-दूसरे से अलग हैं. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
expireTime |
ज़रूरी नहीं. यूटीसी में वह टाइमस्टैंप जब इस संसाधन की समयसीमा खत्म हो जाएगी. मैसेज सबमिट करने के कम से कम छह सेकंड बाद. अगर सबमिट करने के बाद, छह सेकंड से कम का कोई टाइमस्टैंप दिया जाता है, तो प्लैटफ़ॉर्म उसे अपने-आप छह सेकंड पर सेट कर देता है. मैसेज सबमिट करने के समय या उससे पहले का कोई भी टाइमस्टैंप, यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
ttl |
ज़रूरी नहीं. सिर्फ़ इनपुट के लिए. वह अवधि जिसके बाद मैसेज अपने-आप रद्द हो जाएगा. वीडियो कम से कम छह सेकंड का होना चाहिए. अगर छह सेकंड से कम की पॉज़िटिव वैल्यू दी जाती है, तो प्लैटफ़ॉर्म उसे अपने-आप छह सेकंड पर सेट कर देता है. साथ ही, अडजस्ट की गई वैल्यू को रिस्पॉन्स के सेकंड में अवधि, जिसमें नौ फ़्रैक्शनल अंक हो सकते हैं. यह ' |
| एक-दूसरे से अलग फ़ील्ड का अंत. | |
AgentContentMessage
एजेंट से किसी उपयोगकर्ता को भेजे गए मैसेज का कॉन्टेंट.
| JSON के काेड में दिखाना |
|---|
{ "suggestions": [ { object ( |
| फ़ील्ड | |
|---|---|
suggestions[] |
सुझाए गए जवाबों और सुझाई गई कार्रवाइयों की सूची, जो एजेंट के मैसेज के बाद सुझाव वाले चिप की सूची के तौर पर दिखती है. ज़्यादा से ज़्यादा 11 सुझाव. चिप्स सिर्फ़ तब दिखती हैं, जब उनसे जुड़ा एजेंट मैसेज, बातचीत में सबसे हाल का मैसेज हो. इसमें एजेंट और उपयोगकर्ता, दोनों के मैसेज शामिल हैं. उपयोगकर्ता, सुझाए गए जवाब पर टैप करके, एजेंट को टेक्स्ट जवाब भेज सकता है. इसके अलावा, सुझाए गए ऐक्शन पर टैप करके, डिवाइस पर नेटिव ऐक्शन शुरू कर सकता है. सुझाव के पैटर्न दो तरह के होते हैं: परसिस्टेंट और ट्रांज़िएंट. ज़्यादा जानकारी के लिए, सुझाव देखें. |
| एजेंट के मैसेज का कॉन्टेंट. यहां ऐसे फ़ील्ड की सूची दी गई है जो एक-दूसरे से अलग हैं. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
text |
UTF-8 में एन्कोड किया गया टेक्स्ट. ज़्यादा से ज़्यादा 3072 वर्ण. |
fileName |
फ़ाइल का यूनीक नाम. जब कोई एजेंट कोई फ़ाइल अपलोड करता है, तो RCS for Business प्लैटफ़ॉर्म उस फ़ाइल का नाम दिखाता है. इसे अब इस्तेमाल नहीं किया जा सकता. इसके बजाय, नीचे दिए गए uploadedRbmFile का इस्तेमाल करें. |
uploadedRbmFile |
इसमें उस फ़ाइल और थंबनेल के आइडेंटिफ़ायर होते हैं जिसे RCS for Business के सर्वर पर अपलोड किया गया था और जिसे इस सर्वर से भेजा गया था. |
richCard |
एक अलग से मौजूद रिच कार्ड. |
contentInfo |
किसी फ़ाइल की जानकारी. इसमें फ़ाइल का यूआरएल और फ़ाइल के थंबनेल का यूआरएल शामिल है. RCS for Business प्लैटफ़ॉर्म, कैश मेमोरी से कॉन्टेंट दिखाता है. हालांकि, एजेंट, RCS for Business प्लैटफ़ॉर्म को कॉन्टेंट का नया वर्शन फ़ेच करने और कैश मेमोरी को रीफ़्रेश करने के लिए मजबूर कर सकता है. |
| एक-दूसरे से अलग फ़ील्ड का अंत. | |
UploadedRbmFile
फ़ाइल और थंबनेल की जानकारी वाला मैसेज
| JSON के काेड में दिखाना |
|---|
{ "fileName": string, "thumbnailName": string } |
| फ़ील्ड | |
|---|---|
fileName |
फ़ाइल का नाम, जो फ़ाइल अपलोड होने पर RCS for Business प्लैटफ़ॉर्म से मिला था. |
thumbnailName |
थंबनेल का नाम. यह नाम, 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 |
स्टैंडअलोन कार्ड. |
| एक-दूसरे से अलग फ़ील्ड का अंत. | |
CarouselCard
कार्ड का कैरसेल.
| JSON के काेड में दिखाना |
|---|
{ "cardWidth": enum ( |
| फ़ील्ड | |
|---|---|
cardWidth |
कैरसेल में मौजूद कार्ड की चौड़ाई. |
cardContents[] |
कैरसेल में मौजूद हर कार्ड के कॉन्टेंट की सूची. कैरसेल में कम से कम दो और ज़्यादा से ज़्यादा 10 कार्ड हो सकते हैं. |
CarouselCard.CardWidth
कैरसेल में मौजूद कार्ड की चौड़ाई.
| Enums | |
|---|---|
CARD_WIDTH_UNSPECIFIED |
जानकारी नहीं दी गई है. |
SMALL |
120 डीपी. |
MEDIUM |
232 डीपी. |
CardContent
कार्ड का कॉन्टेंट
| JSON के काेड में दिखाना |
|---|
{ "title": string, "description": string, "media": { object ( |
| फ़ील्ड | |
|---|---|
title |
(ज़रूरी नहीं) कार्ड का टाइटल. ज़्यादा से ज़्यादा 200 वर्ण. |
description |
(ज़रूरी नहीं) कार्ड की जानकारी. ज़्यादा से ज़्यादा 2,000 वर्ण. |
media |
(ज़रूरी नहीं) कार्ड में शामिल करने के लिए मीडिया (इमेज, GIF, वीडियो, PDF). |
suggestions[] |
(ज़रूरी नहीं) कार्ड में शामिल करने के लिए सुझावों की सूची. ज़्यादा से ज़्यादा चार सुझाव. |
मीडिया
रिच कार्ड में मौजूद मीडिया फ़ाइल.
| JSON के काेड में दिखाना |
|---|
{ "height": enum ( |
| फ़ील्ड | |
|---|---|
height |
वर्टिकल लेआउट वाले रिच कार्ड में मौजूद मीडिया की ऊंचाई. हॉरिज़ॉन्टल लेआउट वाले स्टैंडअलोन कार्ड के लिए, iOS के साथ काम करने के लिए |
contentDescription |
ज़रूरी नहीं. यह वैकल्पिक टेक्स्ट उपलब्ध कराकर, सुलभता के लिए मीडिया कॉन्टेंट के बारे में जानकारी देता है. इसमें ज़्यादा से ज़्यादा 200 वर्णों का सामान्य टेक्स्ट इस्तेमाल किया जा सकता है. |
| मीडिया कॉन्टेंट: यहां ऐसे फ़ील्ड की सूची दी गई है जो एक-दूसरे से अलग हैं. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
fileName |
फ़ाइल का यूनीक नाम. यह नाम, RCS for Business प्लैटफ़ॉर्म से तब मिलता है, जब फ़ाइल अपलोड की जाती है. इसे अब इस्तेमाल नहीं किया जा सकता. इसके बजाय, नीचे दिए गए uploadedRbmFile का इस्तेमाल करें. |
uploadedRbmFile |
इसमें उस फ़ाइल और थंबनेल के आइडेंटिफ़ायर होते हैं जिसे RCS for Business के सर्वर पर अपलोड किया गया था और जिसे इस सर्वर से भेजा गया था. |
contentInfo |
किसी फ़ाइल की जानकारी. इसमें फ़ाइल का यूआरएल और फ़ाइल के थंबनेल का यूआरएल शामिल है. RCS for Business प्लैटफ़ॉर्म, कैश मेमोरी से कॉन्टेंट दिखाता है. हालांकि, एजेंट, RCS for Business प्लैटफ़ॉर्म को कॉन्टेंट का नया वर्शन फ़ेच करने और कैश मेमोरी को रीफ़्रेश करने के लिए मजबूर कर सकता है. |
| एक-दूसरे से अलग फ़ील्ड का अंत. | |
ContentInfo
कॉन्टेंट की जानकारी वाला मैसेज.
| JSON के काेड में दिखाना |
|---|
{ "fileUrl": string, "thumbnailUrl": string, "forceRefresh": boolean } |
| फ़ील्ड | |
|---|---|
fileUrl |
फ़ाइल का ऐसा यूआरएल जिसे कोई भी ऐक्सेस कर सके. जब RCS for Business प्लैटफ़ॉर्म किसी फ़ाइल को फ़ेच करता है, तो वह एचटीटीपी हेडर में मौजूद कॉन्टेंट-टाइप फ़ील्ड से, फ़ाइल के एमआईएमई टाइप का पता लगाता है. यूआरएल से मिले एचटीटीपी रिस्पॉन्स में, कॉन्टेंट-टाइप फ़ील्ड मौजूद होना चाहिए और उसकी वैल्यू सटीक होनी चाहिए. हमारा सुझाव है कि फ़ाइल का साइज़ 100 एमबी से ज़्यादा न हो. ध्यान दें: फ़ाइल के यूआरएल में रीडायरेक्ट करने की सुविधा काम नहीं करती. अगर रीडायरेक्ट करना ज़रूरी है, तो कृपया CreateFileRequest का इस्तेमाल करें. |
thumbnailUrl |
(ज़रूरी नहीं, सिर्फ़ इमेज, ऑडियो, और वीडियो फ़ाइलों के लिए) थंबनेल का सार्वजनिक तौर पर ऐक्सेस किया जा सकने वाला यूआरएल. ज़्यादा से ज़्यादा 100 केबी. अगर आपने थंबनेल का यूआरएल नहीं दिया है, तो RCS for Business प्लैटफ़ॉर्म पर थंबनेल की जगह खाली प्लेसहोल्डर दिखता है. ऐसा तब तक होता है, जब तक उपयोगकर्ता के डिवाइस पर फ़ाइल डाउनलोड नहीं हो जाती. उपयोगकर्ता की सेटिंग के आधार पर, हो सकता है कि फ़ाइल अपने-आप डाउनलोड न हो. इसके लिए, उपयोगकर्ता को डाउनलोड बटन पर टैप करना पड़ सकता है. ध्यान दें: फ़ाइल के यूआरएल में रीडायरेक्ट करने की सुविधा काम नहीं करती. अगर रीडायरेक्ट करना ज़रूरी है, तो कृपया CreateFileRequest का इस्तेमाल करें. |
forceRefresh |
अगर यह सेट है, तो RCS for Business प्लैटफ़ॉर्म, दिए गए यूआरएल से फ़ाइल और थंबनेल फ़ेच करता है. भले ही, प्लैटफ़ॉर्म के पास फ़ाइल और/या थंबनेल की कैश कॉपी हों. |
Media.Height
मीडिया ऊंचाई
| Enums | |
|---|---|
HEIGHT_UNSPECIFIED |
जानकारी नहीं दी गई है. |
SHORT |
112 डीपी. |
MEDIUM |
168 डीपी. |
TALL |
264 डीपी. |
सुझाव
रिच कार्ड या सुझाव वाले चिप की सूची में शामिल, सुझाया गया जवाब या सुझाई गई कार्रवाई.
| JSON के काेड में दिखाना |
|---|
{ "suggestionDisplay": enum ( |
| फ़ील्ड | |
|---|---|
suggestionDisplay |
ज़रूरी नहीं. इससे यह कंट्रोल किया जाता है कि सुझाव किस तरह दिखे. यह सुविधा सिर्फ़ Google Messages क्लाइंट (वर्शन 20260225.00 या इसके बाद के वर्शन) को भेजे गए सादे टेक्स्ट मैसेज पर लागू होती है. यह फ़ील्ड, सिर्फ़ सामान्य टेक्स्ट मैसेज से जुड़े अलग-अलग सुझावों पर सेट होना चाहिए. अगर इस फ़ील्ड को रिच कार्ड में दिए गए सुझावों या फ़ाइल ट्रांसफ़र के साथ दिए गए अलग से मौजूद सुझावों पर लागू किया जाता है, तो सर्वर मैसेज को अस्वीकार कर देगा. यह सेटिंग सिर्फ़ Google Messages के लिए सीरियलाइज़ की जाती है. अन्य क्लाइंट (जैसे, iOS या Samsung) इसे अनदेखा कर देते हैं. |
| सुझाया गया जवाब या सुझाई गई कार्रवाई. यहां ऐसे फ़ील्ड की सूची दी गई है जो एक-दूसरे से अलग हैं. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
reply |
उपयोगकर्ता, सुझाए गए जवाब पर टैप करके, एजेंट को टेक्स्ट के ज़रिए जवाब भेज सकते हैं. |
action |
उपयोगकर्ता, सुझाए गए किसी ऐक्शन पर टैप करके, डिवाइस पर उससे जुड़ी नेटिव कार्रवाई शुरू कर सकते हैं. |
| एक-दूसरे से अलग फ़ील्ड का अंत. | |
SuggestedReply
इस पर टैप करने से, एजेंट को टेक्स्ट में जवाब भेजा जाता है.
| JSON के काेड में दिखाना |
|---|
{ "text": string, "postbackData": string } |
| फ़ील्ड | |
|---|---|
text |
यह वह टेक्स्ट होता है जो सुझाए गए जवाब में दिखता है. साथ ही, जब उपयोगकर्ता इस पर टैप करता है, तो यह एजेंट को वापस भेज दिया जाता है. ज़्यादा से ज़्यादा 25 वर्णों में जानकारी दें. |
postbackData |
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 ( |
| फ़ील्ड | |
|---|---|
text |
सुझाई गई कार्रवाई में दिखने वाला टेक्स्ट. ज़्यादा से ज़्यादा 25 वर्णों में जानकारी दें. |
postbackData |
पेलोड (base64 कोड में बदला गया) जिसे उपयोगकर्ता के इवेंट में एजेंट को भेजा जाएगा. यह इवेंट तब ट्रिगर होता है, जब उपयोगकर्ता सुझाई गई कार्रवाई पर टैप करता है. ज़्यादा से ज़्यादा 2048 वर्ण. |
fallbackUrl |
(ज़रूरी नहीं) अगर कोई क्लाइंट सुझाए गए ऐक्शन के साथ काम नहीं करता है, तो इस्तेमाल करने के लिए फ़ॉलबैक यूआरएल. फ़ॉलबैक यूआरएल, नई ब्राउज़र विंडो में खुलते हैं. आरएफ़सी 3986 के मुताबिक, यह एक मान्य यूआरआई होना चाहिए. ज़्यादा से ज़्यादा 2048 वर्ण. |
| जब उपयोगकर्ता सुझाई गई कार्रवाई पर टैप करता है, तो डिवाइस पर नेटिव कार्रवाई शुरू होती है. यहां ऐसे फ़ील्ड की सूची दी गई है जो एक-दूसरे से अलग हैं. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
dialAction |
इससे उपयोगकर्ता का डिफ़ॉल्ट डायलर ऐप्लिकेशन खुल जाता है. इसमें एजेंट का बताया गया फ़ोन नंबर पहले से भरा होता है. |
viewLocationAction |
यह उपयोगकर्ता के डिफ़ॉल्ट मैप ऐप्लिकेशन को खोलता है और एजेंट की बताई गई जगह को चुनता है. इसके अलावा, एजेंट की बताई गई क्वेरी के आधार पर, उपयोगकर्ता की जगह के आस-पास खोज करता है. |
createCalendarEventAction |
इससे उपयोगकर्ता का डिफ़ॉल्ट कैलेंडर ऐप्लिकेशन खुलता है. साथ ही, एजेंट के तय किए गए इवेंट डेटा के साथ, नए कैलेंडर इवेंट का फ़्लो शुरू होता है. |
openUrlAction |
यह उपयोगकर्ता के डिफ़ॉल्ट वेब ब्राउज़र ऐप्लिकेशन को दिए गए यूआरएल पर खोलता है. अगर उपयोगकर्ता ने कोई ऐसा ऐप्लिकेशन इंस्टॉल किया है जो यूआरएल के लिए डिफ़ॉल्ट हैंडलर के तौर पर रजिस्टर है, तो इसके बजाय यह ऐप्लिकेशन खोला जाएगा. साथ ही, सुझाए गए ऐक्शन यूज़र इंटरफ़ेस (यूआई) में इसके आइकॉन का इस्तेमाल किया जाएगा. |
shareLocationAction |
यह आरसीएस ऐप्लिकेशन में जगह की जानकारी चुनने की सुविधा खोलता है, ताकि उपयोगकर्ता एजेंट को भेजने के लिए कोई जगह चुन सके. |
| एक-दूसरे से अलग फ़ील्ड का अंत. | |
DialAction
इससे उपयोगकर्ता का डिफ़ॉल्ट डायलर ऐप्लिकेशन खुल जाता है. इसमें एजेंट का बताया गया फ़ोन नंबर पहले से भरा होता है.
| JSON के काेड में दिखाना |
|---|
{ "phoneNumber": string } |
| फ़ील्ड | |
|---|---|
phoneNumber |
E.164 फ़ॉर्मैट में फ़ोन नंबर. उदाहरण के लिए, +12223334444. |
ViewLocationAction
यह उपयोगकर्ता के डिफ़ॉल्ट मैप ऐप्लिकेशन को खोलता है और एजेंट की बताई गई जगह को चुनता है. इसके अलावा, एजेंट की बताई गई क्वेरी के आधार पर, उपयोगकर्ता की जगह के आस-पास खोज करता है.
| JSON के काेड में दिखाना |
|---|
{
"latLong": {
object ( |
| फ़ील्ड | |
|---|---|
latLong |
(ज़रूरी नहीं) चुनी गई जगह का अक्षांश और देशांतर. |
label |
(ज़रूरी नहीं) latLong पर ड्रॉप किए गए पिन का लेबल. |
query |
(ज़रूरी नहीं) latLong (और लेबल, ज़रूरी नहीं) की जानकारी देने के बजाय, एजेंट क्वेरी स्ट्रिंग की जानकारी दे सकता है. खोज की सुविधा के साथ काम करने वाले डिफ़ॉल्ट मैप ऐप्लिकेशन (जैसे, Google Maps) के लिए, इस सुझाई गई कार्रवाई पर टैप करने से, उपयोगकर्ता की मौजूदा जगह के आस-पास की जगहों की खोज की जाती है. अगर क्वेरी में काफ़ी जानकारी दी गई है, तो एजेंट इसका इस्तेमाल करके दुनिया की किसी भी जगह को चुन सकते हैं. उदाहरण के लिए, क्वेरी स्ट्रिंग को "Growing Tree Bank" पर सेट करने से, उपयोगकर्ता के आस-पास मौजूद Growing Tree Bank की सभी जगहें दिखेंगी. क्वेरी स्ट्रिंग को "1600 Amphitheater Parkway, Mountain View, CA 94043" पर सेट करने से, उपयोगकर्ता की जगह की जानकारी के बावजूद, वह पता चुना जाएगा. |
LatLng
अक्षांश/देशांतर के जोड़े को दिखाने वाला ऑब्जेक्ट. इसे अक्षांश और देशांतर की डिग्री दिखाने के लिए, डबल के पेयर के तौर पर दिखाया जाता है. जब तक कोई और जानकारी न दी जाए, तब तक यह ऑब्जेक्ट WGS84 स्टैंडर्ड के मुताबिक होना चाहिए. वैल्यू, सामान्य रेंज में होनी चाहिए.
| JSON के काेड में दिखाना |
|---|
{ "latitude": number, "longitude": number } |
| फ़ील्ड | |
|---|---|
latitude |
डिग्री में अक्षांश. यह [-90.0, +90.0] की रेंज में होना चाहिए. |
longitude |
डिग्री में देशांतर. यह [-180.0, +180.0] की रेंज में होना चाहिए. |
CreateCalendarEventAction
इससे उपयोगकर्ता का डिफ़ॉल्ट कैलेंडर ऐप्लिकेशन खुलता है. साथ ही, एजेंट के तय किए गए इवेंट डेटा के साथ, नए कैलेंडर इवेंट का फ़्लो शुरू होता है.
| JSON के काेड में दिखाना |
|---|
{ "startTime": string, "endTime": string, "title": string, "description": string } |
| फ़ील्ड | |
|---|---|
startTime |
इवेंट शुरू होने का समय. यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
endTime |
इवेंट खत्म होने का समय. यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
title |
इवेंट का टाइटल. ज़्यादा से ज़्यादा 100 वर्ण. |
description |
इवेंट की जानकारी. ज़्यादा से ज़्यादा 500 वर्ण. |
OpenUrlAction
इससे उपयोगकर्ता का डिफ़ॉल्ट वेब ब्राउज़र ऐप्लिकेशन, दिए गए यूआरएल पर खुलता है. अगर उपयोगकर्ता ने कोई ऐसा ऐप्लिकेशन इंस्टॉल किया है जो यूआरएल के लिए डिफ़ॉल्ट हैंडलर के तौर पर रजिस्टर है, तो इसके बजाय यह ऐप्लिकेशन खोला जाएगा. साथ ही, सुझाए गए ऐक्शन यूज़र इंटरफ़ेस (यूआई) में इसके आइकॉन का इस्तेमाल किया जाएगा.
| JSON के काेड में दिखाना |
|---|
{ "url": string, "application": enum ( |
| फ़ील्ड | |
|---|---|
url |
वह यूआरएल जिसे खोलना है. यूआरएल स्कीम, https:// या http:// होनी चाहिए. यह शर्त 1 नवंबर, 2025 से लागू होगी. इस तारीख के बाद, किसी अन्य स्कीम (जैसे, tel:, mailto:, sms:) का इस्तेमाल करके किए गए एपीआई अनुरोधों को अस्वीकार कर दिया जाएगा. साथ ही, 400 Bad Request वाली गड़बड़ी दिखेगी. यूआरएल, आरएफ़सी 3986 के मुताबिक मान्य यूआरआई होना चाहिए. ज़्यादा से ज़्यादा 2048 वर्ण. |
application |
यूआरएल, ऐप्लिकेशन, ब्राउज़र या वेबव्यू खोलता है. यह देखने के लिए कि उपयोगकर्ता के डिवाइस पर वेबव्यू मोड काम करता है या नहीं, पहले यह जांच करें कि डिवाइस पर यह सुविधा उपलब्ध है या नहीं. ज़्यादा जानकारी के लिए, यह दस्तावेज़ देखें: https://developers.google.com/business-communications/rcs-business-messaging/guides/build/capabilities. |
webviewViewMode |
वेबव्यू के लिए व्यू मोड. |
description |
वेबव्यू के लिए सुलभता से जुड़ा ब्यौरा. |
OpenUrlApplication
यूआरएल से खोले जाने वाले ऐप्लिकेशन का टाइप
| Enums | |
|---|---|
OPEN_URL_APPLICATION_UNSPECIFIED |
कोई जानकारी नहीं दी गई है. इसे खोलने के लिए ब्राउज़र का इस्तेमाल किया जाएगा. |
BROWSER |
यूआरएल खोलने के लिए ब्राउज़र का इस्तेमाल करें. |
WEBVIEW |
यूआरएल को इंटिग्रेट की गई वेब व्यू विंडो में खोलें |
WebviewViewMode
वेबव्यू के व्यू मोड का टाइप.
| Enums | |
|---|---|
WEBVIEW_VIEW_MODE_UNSPECIFIED |
जानकारी नहीं दी गई है. वेबव्यू का इस्तेमाल करने के लिए, व्यू मोड तय करना ज़रूरी है. |
FULL |
इसके लिए, फ़ुल स्क्रीन ओवरले की ज़रूरत होती है. साथ ही, स्टेटस बार में चैटबॉट की बातचीत का लेबल होना चाहिए. |
HALF |
इसके लिए, हाफ़ स्क्रीन ओवरले की ज़रूरत होती है. |
TALL |
इसके लिए, तीन-चौथाई स्क्रीन ओवरले की ज़रूरत होती है. |
Suggestion.SuggestionDisplay
अलग से मौजूद टेक्स्ट के सुझावों को दिखाने का तरीका.
| Enums | |
|---|---|
SUGGESTION_DISPLAY_UNSPECIFIED |
क्लाइंट, डिफ़ॉल्ट डिसप्ले बिहेवियर लागू करते हैं:
|
PERSISTENT |
सुझाव, मैसेज बबल में लगातार दिखता रहता है. भले ही, बातचीत में नए मैसेज जोड़े जाएं. |
StandaloneCard
स्टैंडअलोन कार्ड
| JSON के काेड में दिखाना |
|---|
{ "cardOrientation": enum ( |
| फ़ील्ड | |
|---|---|
cardOrientation |
कार्ड का ओरिएंटेशन. |
thumbnailImageAlignment |
हॉरिज़ॉन्टल लेआउट वाले स्टैंडअलोन कार्ड के लिए, इमेज की झलक का अलाइनमेंट. |
cardContent |
कार्ड का कॉन्टेंट. |
StandaloneCard.CardOrientation
कार्ड का ओरिएंटेशन.
| Enums | |
|---|---|
CARD_ORIENTATION_UNSPECIFIED |
जानकारी नहीं दी गई है. |
HORIZONTAL |
हॉरिज़ॉन्टल लेआउट. अगर हॉरिज़ॉन्टल रिच कार्ड के |
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 ( |
| फ़ील्ड | |
|---|---|
classificationType |
|
segmentCount |
मैसेज के टेक्स्ट के लिए 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 मैसेज पर लागू नहीं होती. |
तरीके |
|
|---|---|
|
एजेंट से किसी उपयोगकर्ता को मैसेज भेजता है. |
|
यह एजेंट के उस मैसेज को वापस लेता है जो भेजा जा चुका है, लेकिन अब तक डिलीवर नहीं हुआ है. |