Method: phones.agentMessages.delete

भेजे गए ऐसे एजेंट मैसेज को रद्द करता है जो अब तक डिलीवर नहीं हुआ है.

अगर RCS for Business प्लैटफ़ॉर्म किसी मैसेज को रद्द कर देता है, तो वह मैसेज उपयोगकर्ता की मैसेज कतार से मिटा दिया जाता है. साथ ही, उसे कभी डिलीवर नहीं किया जाता (200 OK).

404 'नहीं मिला' रिस्पॉन्स का मतलब है कि मैसेज डिलीवर हो गया है. इसलिए, उसे वापस नहीं लिया जा सकता.

ऐसा बहुत कम होता है कि आरसीएस फ़ॉर बिज़नेस प्लैटफ़ॉर्म मैसेज डिलीवर कर रहा हो और एजेंट, मैसेज वापस लेने की प्रोसेस शुरू कर दे. इन गिने-चुने मामलों में, एजेंट को मैसेज के लिए DELIVERED उपयोगकर्ता इवेंट मिलता है. यह इवेंट, ऐक्सेस रद्द करने का अनुरोध शुरू करने के कुछ समय बाद मिलता है.

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

DELETE https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*/agentMessages/*}

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

पाथ पैरामीटर

पैरामीटर
name

string

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

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

पैरामीटर
agentId

string

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

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

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

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

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

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

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

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

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