Method: phones.getCapabilities

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

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

गड़बड़ी ठीक करना: अगर उपयोगकर्ता से RCS for Business के ज़रिए संपर्क नहीं किया जा सकता, तो 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 में बताया गया है. अगर अनुरोध आईडी, एजेंट के पिछले अनुरोध के आईडी से मेल खाता है, तो RCS for Business प्लैटफ़ॉर्म नए अनुरोध को अनदेखा कर देता है.
agentId

string

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

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

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

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

उपयोगकर्ता के हिसाब से, इस्तेमाल की जा सकने वाली सुविधाओं की सूची.

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

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

enum (Feature)

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

string

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

अनुमति पाने के लिंक

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

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

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

सुविधा

कारोबार के लिए आरसीएस की उन सुविधाओं के टाइप जिनके साथ उपयोगकर्ता काम करता है.

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 वेबव्यू में यूआरएल खोलने के लिए सुझाई गई कार्रवाई.