Method: phones.testers.create

यह कुकी, किसी व्यक्ति को एजेंट की जांच करने का न्योता देती है.

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

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

कोई एजेंट, हर दिन 20 टेस्टर के अनुरोध भेज सकता है. हालांकि, वह कुल मिलाकर ज़्यादा से ज़्यादा 200 टेस्टर के अनुरोध भेज सकता है. अगर टेस्टर के लिए अनुरोध, तय सीमा से ज़्यादा भेजे जाते हैं, तो RBM प्लैटफ़ॉर्म 429 RESOURCE_EXHAUSTED जवाब देता है.

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

POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/testers

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
parent

string

"phones/{E.164}", जहां {E.164} उपयोगकर्ता का फ़ोन नंबर E.164 फ़ॉर्मैट में है. उदाहरण के लिए, अमेरिका के फ़ोन नंबर +1-222-333-4444 के लिए, नतीजा यह एंडपॉइंट होगा: https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/testers/.

क्वेरी पैरामीटर

पैरामीटर
agentId

string

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

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

अनुरोध के मुख्य भाग में Tester का उदाहरण है.

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

अगर अनुरोध पूरा हो जाता है, तो जवाब के मुख्य हिस्से में Tester का नया इंस्टेंस शामिल किया जाता है.

अनुमति के स्कोप

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

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

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