अपडेट: नई सुविधाओं और प्रॉडक्ट के अपडेट के लिए, प्रॉडक्ट की जानकारी देखें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

क्षमता की जांच

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

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

क्षमता की जांच भेजें

यह कोड क्षमता की जांच भेजता है और जवाब का इंतज़ार करता है. फ़ॉर्मैटिंग और वैल्यू के विकल्पों के लिए, getCapabilities देखें.

cURL

curl -X GET "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/capabilities?requestId=REQUEST_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`"

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('../libs/rbm_api_helper');

// Send a capability check to the device
rbmApiHelper.checkCapability('+12223334444', function(response) {
   // Print capabilities of the device
   console.log(response);
});

यह कोड, आरबीएम के सैंपल एजेंट से लिया गया है.

Java

import com.google.rbm.samples.lib.RbmApiHelper;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper();

// Check the capabilities of the device
boolean capability = rbmApiHelper.getCapability("+12223334444");

यह कोड, आरबीएम के सैंपल एजेंट से लिया गया है.

Python

# Reference to RBM Python client helper
from rcs_business_messaging import rbm_service

# Send the tester invite to a device
response = rbm_service.make_cap_request('+12223334444')

यह कोड, आरबीएम के सैंपल एजेंट से लिया गया है.

C#

using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                             projectId);

// Register the device as a tester
Capabilities capabilities = rbmApiHelper.GetCapability("+12223334444");

यह कोड, आरबीएम के सैंपल एजेंट से लिया गया है.

क्षमता जवाब

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

{
  "features": [
    "REVOCATION",
    "RICHCARD_STANDALONE",
    "RICHCARD_CAROUSEL",
    "ACTION_CREATE_CALENDAR_EVENT",
    "ACTION_DIAL",
    "ACTION_OPEN_URL",
    "ACTION_SHARE_LOCATION",
    "ACTION_VIEW_LOCATION",
  ]
}

अगर किसी ऐसे उपयोगकर्ता को क्षमता की जांच भेजी जाती है जो आरबीएम से ऐक्सेस नहीं कर सकता. उदाहरण के लिए, अगर उसका डिवाइस आरसीएस के साथ काम नहीं करता है, तो आरबीएम प्लैटफ़ॉर्म 404 गड़बड़ी दिखाता है.

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

एक साथ कई सुविधाओं की जांच

आरबीएम के ज़रिए ऐक्सेस किए जा सकने वाले उपयोगकर्ताओं की संख्या का अनुमान लगाने के लिए, एक साथ कई क्षमता की जांच करें. बल्क चेक से यह पता चलता है कि फ़ोन नंबर से संपर्क किया जा सकता है या नहीं, लेकिन यह पता नहीं चलता कि फ़ोन नंबर किन सुविधाओं के साथ काम करता है.

एक साथ कई क्षमता की जांच करने पर, ज़्यादा से ज़्यादा 10,000 फ़ोन नंबर तय किए जा सकते हैं. ज़्यादा संख्याएं देखने के लिए, कई जांच करें. CSV फ़ाइलों को इनपुट फ़ॉर्मैट के तौर पर इस्तेमाल करने के लिए, बल्क क्षमता जांच स्क्रिप्ट का इस्तेमाल करें.

एक साथ कई क्षमता की जांच करने की सुविधा में, हर मिनट ज़्यादा से ज़्यादा 600 क्वेरी (क्यूपीएम) होती हैं.

एक साथ कई क्षमता की जांच करने की सुविधा से, उन नंबर की सूची मिलती है जिन पर आपका एजेंट, हाल ही में लॉन्च की गई मोबाइल और इंटरनेट सेवा देने वाली कंपनियों के पास पहुंच सकता है. साथ ही, इसमें सभी मोबाइल और इंटरनेट सेवा देने वाली कंपनियों के उन उपयोगकर्ताओं की कुल संख्या का अनुमान भी दिखाया जाता है जिन तक पहुंचा जा सकता है. बल्क क्षमता जाँच जवाब देखें.

कुल पहुंच सकने वाले उपयोगकर्ताओं का अनुमान लगाएं

एक साथ कई जांच करने वाले जवाबों में, उन फ़ोन नंबर की सूची होती है जिन्हें आपके एजेंट ने मोबाइल और इंटरनेट सेवा देने वाली कंपनियों की ओर से लॉन्च किया है (reachableUsers), लेकिन जवाबों में दो वैल्यू भी शामिल होती हैं. इनसे आपको सभी मोबाइल और इंटरनेट सेवा देने वाली कंपनियों के संपर्क किए जा सकने वाले उपयोगकर्ताओं की कुल संख्या का अनुमान लगाने में मदद मिलती है.

जब आपका एजेंट 500 से ज़्यादा फ़ोन नंबर की बल्क क्षमता जांच करता है, तो आरबीएम रैंडम तरीके से उन ~75% नंबर का नमूना लेता है, ताकि सभी मोबाइल और इंटरनेट सेवा देने वाली कंपनियों की जांच की जा सके (totalRandomSampleUserCount में रिपोर्ट किया गया). आरबीएम, रैंडम सैंपल से आरबीएम से ऐक्सेस किए जा सकने वाले नंबरों की संख्या भी दिखाता है, कैरियर के लॉन्च की स्थिति reachableRandomSampleUserCount पर ध्यान दिए बिना. reachableRandomSampleUserCount को totalRandomSampleUserCount से भाग देकर, यह अनुमान लगाया जा सकता है कि सभी कैरियर पर लॉन्च होने पर आपका एजेंट कितने प्रतिशत तक पहुंच सकता है.

उदाहरण के लिए, अगर एक साथ कई क्षमता की जांच में 5,000 फ़ोन नंबर तय किए जाते हैं और आरबीएम, बताई गई संख्या में से 75% नंबर का सैंपल देता है, तो totalRandomSampleUserCount 3750 हो सकता है. अगर reachableRandomSampleUserCount 3000 है, तो सैंपल के तौर पर चुने गए नंबरों का 80% ऐक्सेस आपके पास था.

रैंडम सैंपल की जांच करने से, अलग-अलग प्रतिशत में अंतर आ सकता है. रैंडम सैंपलिंग के असर को देखने के लिए, बड़ी संख्या में फ़ोन नंबर से बल्क में क्षमता की जांच करें. आप संख्याओं के एक ही बैच के साथ कई बार जांच कर सकते हैं और फिर रैंडम सैंपलिंग के व्यवहार को सामान्य बनाने के लिए नतीजों का औसत बना सकते हैं.

एक साथ कई लोगों को उनकी क्षमता की जांच भेजें

यह कोड, क्षमता की जांच भेजता है और जवाब का इंतज़ार करता है. फ़ॉर्मैटिंग और वैल्यू के विकल्पों के लिए, users.batchGet देखें.

फ़ोन नंबर, E.164 फ़ॉर्मैट में होने चाहिए. उदाहरण के लिए, "+12223334444".

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/users:batchGet \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "users": [
    "PHONE_NUMBER",
  ]
}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('../libs/rbm_api_helper');

// Specify phone numbers
let phoneNumbers = ['+12223334444', '+12223334444'];

// Perform a bulk capability check
rbmApiHelper.getUsers(phone_numbers, function(response) {
   // Print the bulk capability check response
   console.log(response);
});

यह कोड, आरबीएम सैंपल एजेंट का इस्तेमाल करता है.

Java

import com.google.rbm.samples.lib.RbmApiHelper;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper();

// Perform a bulk capability check
BatchGetUsersResponse batchGetUsersResponse = rbmApiHelper.getUsers(Arrays.asList("+12223334444", "+12223334444"));

यह कोड, आरबीएम सैंपल एजेंट का इस्तेमाल करता है.

Python

# Reference to RBM Python client helper
from rcs_business_messaging import rbm_service

# Perform a bulk capability check
response = rbm_service.make_batch_cap_request(['+12223334444', '+12223334444'])

यह कोड, आरबीएम सैंपल एजेंट का इस्तेमाल करता है.

C#

using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                             projectId);

// Perform a bulk capability check
BatchGetUsersResponse batchGetUsersResponse = rbmApiHelper.GetUsers(new List({"+12223334444", "+12223334444"}));

यह कोड, आरबीएम सैंपल एजेंट का इस्तेमाल करता है.

एक साथ कई क्षमता की जांच का जवाब

बल्क में क्षमता की जांच करने के बाद, आरबीएम, JSON फ़ॉर्मैट वाला जवाब देता है.

{
  "reachableUsers": [
    "PHONE_NUMBER"
  ],
  "totalRandomSampleUserCount": "COUNT_OF_SAMPLE",
  "reachableRandomSampleUserCount": "REACHABLE_FROM_SAMPLE"
}

फ़ील्ड	ब्यौरा
`reachableUsers`	एजेंट के हाल ही में लॉन्च किए गए मोबाइल और इंटरनेट सेवा देने वाली कंपनियों के जिन उपयोगकर्ताओं तक पहुंचा जा सकता है उनकी सूची.
`totalRandomSampleUserCount`	तय की गई संख्याओं के किसी यादृच्छिक नमूने की संख्या. आम तौर पर, बताई गई संख्याओं का ~75%.
`reachableRandomSampleUserCount`	रैंडम नमूने में दी गई संख्याओं की वह संख्या जिन पर आरबीएम से सभी मोबाइल और इंटरनेट सेवा देने वाली कंपनियां पहुंच सकती हैं. भले ही, एजेंट ने इस समय कोई भी कैरियर लॉन्च किया हो.

टूल: बल्क क्षमता जांच स्क्रिप्ट

बक की क्षमता की जांच स्क्रिप्ट (डाउनलोड करने के लिए साइन इन करें) CSV फ़ाइलों को इनपुट और आउटपुट फ़ॉर्मैट के तौर पर इस्तेमाल करके बल्क में क्षमता की जांच करता है. स्क्रिप्ट जाता है कि CSVSDN की CSV फ़ाइल को पार्स करती है और हर सूची में शामिल डिवाइस की क्षमताओं की जांच करने के लिए, RBM SDK टूल का इस्तेमाल करती है.

500 थ्रेड वाली स्क्रिप्ट पर चलने वाली 2 सीपीयू और 4 जीबी रैम वाली वर्चुअल मशीन करीब 1 हज़ार क्यूपीएस तक पहुंच सकती है. हालांकि, कुल क्यूपीएस इस्तेमाल की जाने वाली मशीन, डिवाइस के देश, एजेंट के रीजनल कॉन्फ़िगरेशन, और इस्तेमाल किए गए एपीआई एंडपॉइंट पर निर्भर करता है.

ज़रूरी शर्तें

कई क्षमता की जांच करने के लिए इस टूल का इस्तेमाल करने से पहले, यहां दी गई शर्तें पूरी करें:

उस CSV फ़ाइल का पाथ जिस परMSSDNs के साथ क्षमता की जांच करने के लिए इस्तेमाल किया जाता है
आपकी डेवलपमेंट मशीन पर, आपके एजेंट के सेवा खाता कुंजी का पाथ

इसके अलावा, आपको अपनी डेवलपमेंट मशीन पर नीचे दिया गया सॉफ़्टवेयर इंस्टॉल करना होगा:

Apache Maven 3.3.9 या इसके बाद का वर्शन
Java 8

सेट अप करें

अपनी डेवलपमेंट मशीन पर, बल्क क्षमता जांच स्क्रिप्ट (डाउनलोड करने के लिए साइन इन करें).
स्क्रिप्ट की रूट डायरेक्ट्री पर जाएं.
सेवा खाता कुंजी का नाम बदलकर "rbm-agent-service-account-credits.json" करें. इसके बाद, सेवा खाता कुंजी को "src/main/resources" डायरेक्ट्री में ले जाएं.

एक साथ कई प्रोफ़ाइलों की जांच करें

टर्मिनल में, स्क्रिप्ट की रूट डायरेक्ट्री पर जाएं.

इन निर्देशों का पालन करें:

export MAVEN_OPTS="-Xms1024m -Xmx3000m"
mvn compile && mvn exec:java -Dexec.args="INPUT_FILE OUTPUT_FILE NUM_OF_THREADS START_INDEX END_INDEX"

वैरिएबल को उन वैल्यू से बदलें जिनकी आपने पहचान की है.

बदलें	इसके साथ	उदाहरण
`INPUT_FILE`	इनपुट CSV फ़ाइल का पाथ.	`input.csv`
`OUTPUT_FILE`	आउटपुट CSV फ़ाइल का पाथ.	`output.csv`
`NUM_OF_THREADS`	क्षमता की जांच के लिए इस्तेमाल किए जाने वाले थ्रेड की संख्या.	`500`
`START_INDEX`	ज़रूरी नहीं. CSV फ़ाइल में मौजूद वह वैल्यू जिसकी जांच शुरू करनी है.	`5`
`END_INDEX`	ज़रूरी नहीं. CSV फ़ाइल का वह मान जिसके बाद जांच खत्म करनी है.	`500`

स्क्रिप्ट पूरी होने पर, नतीजे देखने के लिए आउटपुट CSV फ़ाइल खोलें.