Method: phones.getCapabilities

किसी उपयोगकर्ता की आरबीएम से जुड़ी सुविधाएं पाएं.

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

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

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

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

string

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

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

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

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

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

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

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

enum (Feature)

इस डिवाइस पर काम करने वाली आरबीएम सुविधाओं की सूची.

अनुमति के दायरे

नीचे दिए गए 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 वेबव्यू में यूआरएल खोलने के लिए सुझाई गई कार्रवाई.
ACTION_COMPOSE टेक्स्ट/ऑडियो/वीडियो मैसेज लिखने के लिए सुझाई गई कार्रवाई.