एजेंट को टेस्ट करने के लिए उपयोगकर्ता को न्योता देता है.
न्योता पाने वाले उपयोगकर्ता के पास आरसीएस की सुविधा होनी चाहिए. साथ ही, वह आरबीएम प्लैटफ़ॉर्म से संपर्क कर सकता हो. जब कोई एजेंट किसी उपयोगकर्ता को टेस्टर बनने का न्योता देता है, तो आरबीएम प्लैटफ़ॉर्म मैनेजमेंट एजेंट उपयोगकर्ता को एक मैसेज भेजकर, इस बात की पुष्टि करने के लिए कहता है कि उसे एजेंट को टेस्ट करना है. उपयोगकर्ता की पुष्टि करने के बाद, वह टेस्टर बन जाती है.
जो एजेंट अभी तक लॉन्च नहीं हुआ है, वह सिर्फ़ उन लोगों से इंटरैक्ट कर सकता है जो उस एजेंट को टेस्ट कर रहे हैं. अगर लॉन्च नहीं किया गया कोई एजेंट, नॉन-टेस्टर को मैसेज, इवेंट या सुविधा कॉलबैक भेजने की कोशिश करता है, तो आरबीएम प्लैटफ़ॉर्म 403 PERMISSION_DENIED
गड़बड़ी दिखाता है.
एक एजेंट हर दिन जांच करने वाले 20 अनुरोध भेज सकता है. इसमें टेस्टर के ज़्यादा से ज़्यादा 200 अनुरोध शामिल हो सकते हैं. अगर टेस्टर के लिए, तय सीमा से ज़्यादा अनुरोध भेजे जाते हैं, तो आरबीएम प्लैटफ़ॉर्म 429 RESOURCE_EXHAUSTED
रिस्पॉन्स भेजता है.
एचटीटीपी अनुरोध
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/testers
यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
parent |
"phone/{E.164}", जहां {E.164}, E.164 फ़ॉर्मैट में उपयोगकर्ता का फ़ोन नंबर है. उदाहरण के लिए, अमेरिका के फ़ोन नंबर +1-222-333-4444 के साथ, नतीजे के तौर पर मिलने वाला एंडपॉइंट https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/testers/ होगा. |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
agentId |
ज़रूरी है. एजेंट का यूनीक आइडेंटिफ़ायर. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में Tester
का उदाहरण है.
जवाब का मुख्य भाग
कामयाब होने पर, रिस्पॉन्स के मुख्य हिस्से में Tester
का नया इंस्टेंस शामिल किया जाता है.
अनुमति देने के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/rcsbusinessmessaging
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.