Method: phones.getCapabilities

किसी उपयोगकर्ता के लिए, RBM से जुड़ी सुविधाएं पाना.

जवाब के तौर पर मिले पेलोड से पता चलता है कि किसी उपयोगकर्ता से RBM के ज़रिए संपर्क किया जा सकता है या नहीं. अगर संपर्क किया जा सकता है, तो यह भी पता चलता है कि उपयोगकर्ता RBM की किन सुविधाओं का इस्तेमाल कर सकता है.

गड़बड़ी ठीक करना: जब उपयोगकर्ता से RBM के ज़रिए संपर्क नहीं किया जा सकता, तब 404 NOT_FOUND गड़बड़ी दिखती है. इसमें कई स्थितियां शामिल हैं: (1) उपयोगकर्ता के डिवाइस पर आरसीएस की सुविधा काम नहीं करती या आरसीएस की सुविधा बंद है. (2) उपयोगकर्ता ऐसे मोबाइल नेटवर्क पर है जहां एजेंट लॉन्च नहीं किया गया है या जहां आरसीएस ट्रैफ़िक चालू नहीं है. (3) जब कोई ऐसा एजेंट, किसी ऐसे उपयोगकर्ता की क्षमताओं का अनुरोध करता है जिसे टेस्टर के तौर पर शामिल नहीं किया गया है.

एचटीटीपी अनुरोध

GET https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*}/capabilities

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
name

string

यह फ़ील्ड "phones/{E.164}/capabilities" के तौर पर दिखता है. इसमें {E.164} का मतलब, उपयोगकर्ता का फ़ोन नंबर E.164 फ़ॉर्मैट में है. उदाहरण के लिए, अगर किसी उपयोगकर्ता का फ़ोन नंबर अमेरिका का है और वह +1-222-333-4444 है, तो एंडपॉइंट https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities होगा.

क्वेरी पैरामीटर

पैरामीटर
requestId

string

एजेंट की ओर से असाइन किया गया अनुरोध का यूनीक आईडी. यह एक यूयूआईडी होना चाहिए, जैसा कि https://tools.ietf.org/html/rfc4122 में बताया गया है. अगर अनुरोध आईडी, एजेंट के पिछले अनुरोध के आईडी से मेल खाता है, तो RBM प्लैटफ़ॉर्म नए अनुरोध को अनदेखा कर देता है.
agentId

string

ज़रूरी है. एजेंट का यूनीक आइडेंटिफ़ायर.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

उपयोगकर्ता के लिए उपलब्ध सुविधाओं की सूची

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

JSON के काेड में दिखाना 
{
  "features": [
    enum (Feature)
  ]
}
फ़ील्ड
features[]

enum (Feature)

आरबीएम की उन सुविधाओं की सूची जो इस डिवाइस पर काम करती हैं.

अनुमति के स्कोप

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/rcsbusinessmessaging

ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.

सुविधा

उपयोगकर्ता के लिए उपलब्ध RBM की सुविधाएं.

Enums
FEATURE_UNSPECIFIED जानकारी नहीं दी गई है.
RICHCARD_STANDALONE स्टैंडअलोन रिच कार्ड.
ACTION_CREATE_CALENDAR_EVENT कैलेंडर इवेंट बनाने के लिए सुझाई गई कार्रवाई.
ACTION_DIAL किसी नंबर को डायल करने के लिए सुझाई गई कार्रवाई.
ACTION_OPEN_URL ब्राउज़र में यूआरएल खोलने के लिए सुझाई गई कार्रवाई.
ACTION_SHARE_LOCATION जगह की जानकारी शेयर करने के लिए सुझाई गई कार्रवाई.
ACTION_VIEW_LOCATION मैप ऐप्लिकेशन में किसी जगह की जानकारी देखने के लिए सुझाई गई कार्रवाई.
ACTION_OPEN_URL_IN_WEBVIEW वेबव्यू में यूआरएल खोलने के लिए सुझाई गई कार्रवाई.