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

string

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

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

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

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

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

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

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "features": [
    enum (Feature)
  ],
  "carrier": string
}
फ़ील्ड
features[]

enum (Feature)

इस डिवाइस पर काम करने वाली, RCS for Business की सुविधाओं की सूची.
carrier

string

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

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

नीचे दिए गए OAuth अनुमति की ज़रूरत हाेती है:

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

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

सुविधा

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

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