एसएमएस उपयोगकर्ता सहमति एपीआई, एसएमएस Retriever API की मदद से ऐप्लिकेशन को यह अनुमति देता है कि वह उपयोगकर्ता को किसी एसएमएस के कॉन्टेंट का ऐक्सेस देने का अनुरोध करे. जब कोई उपयोगकर्ता सहमति देता है, तब ऐप्लिकेशन को मैसेज के पूरे मुख्य हिस्से का ऐक्सेस मिलता है, ताकि वह मैसेज (एसएमएस) की पुष्टि को अपने-आप पूरा कर सके.
एसएमएस के उपयोगकर्ता की सहमति वाले एपीआई के लिए यूज़र फ़्लो
एक बार इस्तेमाल होने वाले कोड अपने-आप भरने के लिए, एसएमएस User Consent API का इस्तेमाल करते समय, उपयोगकर्ता से कहा जाएगा कि वह आपके ऐप्लिकेशन को एक एसएमएस मैसेज पढ़ने की अनुमति दे. एसएमएस के उपयोगकर्ता सहमति एपीआई का इस्तेमाल करते समय, उपयोगकर्ता को ये स्क्रीन दिखेंगी.
जब उपयोगकर्ता मैसेज (एसएमएस) की मदद से पुष्टि करने की प्रक्रिया शुरू करेगा, तो उसे कीबोर्ड का इस्तेमाल करके एक बार इस्तेमाल होने वाला कोड डालने के लिए कहा जाएगा. ऐसा तब करना ज़रूरी है, जब उपयोगकर्ता को ऐप्लिकेशन के बजाय, किसी दूसरे डिवाइस पर एसएमएस मिलता हो.
इसके बाद, अगर आपके ऐप्लिकेशन ने एसएमएस के लिए उपयोगकर्ता की सहमति का अनुरोध किया है, तो उपयोगकर्ता को एक बार इस्तेमाल होने वाला कोड वाला इनकमिंग एसएमएस मैसेज दिखेगा. इसमें उपयोगकर्ता को एक एसएमएस मैसेज का पूरा कॉन्टेंट शेयर करने का विकल्प दिखेगा. ऐसा सिर्फ़ तब होगा, जब आपके ऐप्लिकेशन ने एसएमएस के लिए उपयोगकर्ता की सहमति का अनुरोध किया हो और वह उस डिवाइस पर चल रहा हो जिस पर एसएमएस मैसेज मिला है.
अगर उपयोगकर्ता आपके ऐप्लिकेशन पर एसएमएस मैसेज का कॉन्टेंट उपलब्ध कराता है, तो उसका पूरा टेक्स्ट शेयर किया जाएगा. उपयोगकर्ता को मैसेज (एसएमएस) की पुष्टि की प्रक्रिया अपने आप पूरी होती दिखाई देती है.
अगर उपयोगकर्ता, मैसेज (एसएमएस) शेयर नहीं करना चाहता, तो उसे पुष्टि करने के लिए, मैन्युअल तरीके से एक बार इस्तेमाल होने वाला कोड टाइप करना होगा.
एसएमएस के उपयोगकर्ता की सहमति वाले एपीआई के लिए डेवलपर फ़्लो
एसएमएस के उपयोगकर्ता की सहमति वाले एपीआई का इस्तेमाल करके, एसएमएस की पुष्टि करने का पूरा फ़्लो लागू करने के लिए, आपको मैसेज (एसएमएस) भेजने के लिए बैकएंड सर्वर और 'एसएमएस उपयोगकर्ता सहमति एपीआई', दोनों से इंटरैक्ट करना होगा. इससे उपयोगकर्ता को एक बार इस्तेमाल होने वाले कोड वाले मैसेज का ऐक्सेस पाने का अनुरोध करना होगा.
'एसएमएस उपयोगकर्ता सहमति एपीआई' का इस्तेमाल करके मैसेज (एसएमएस) पुष्टि फ़्लो लागू करने के लिए आपके ऐप्लिकेशन और सर्वर को ये काम करना होगा:
- आपका ऐप्लिकेशन, एसएमएस उपयोगकर्ता सहमति एपीआई को कॉल करता है, ताकि सर्वर से मैसेज (एसएमएस) के जवाब मिलना शुरू हो सकें. मैसेज (एसएमएस) शुरू होने से पहले मिला एसएमएस मैसेज, उपयोगकर्ता की सहमति आपके ऐप्लिकेशन पर नहीं भेजी जाएगी.
- एसएमएस उपयोगकर्ता सहमति एपीआई शुरू करने के बाद आपका ऐप्लिकेशन, सर्वर को एक अनुरोध भेजता है, ताकि मैसेज (एसएमएस) से पुष्टि करके, उपयोगकर्ता के फ़ोन नंबर की पुष्टि की जा सके.
- जब उपयोगकर्ता के डिवाइस पर एक बार इस्तेमाल होने वाला कोड वाला एसएमएस मैसेज मिलता है, तो Google Play services, उपयोगकर्ता को उस मैसेज का कॉन्टेंट दिखाता है. साथ ही, उस टेक्स्ट को आपके ऐप्लिकेशन पर उपलब्ध कराने की सहमति मांगता है.
- अगर उपयोगकर्ता की सहमति मिल जाती है, तो पूरा एसएमएस मैसेज आपके ऐप्लिकेशन में उपलब्ध करा दिया जाता है.
- आपका ऐप्लिकेशन, मैसेज के टेक्स्ट से एक बार इस्तेमाल होने वाले कोड को पार्स करता है और उसे सर्वर पर भेज देता है.
ज़्यादा जानकारी के लिए, एसएमएस से पुष्टि करने वाला कोड पढ़ने के लिए, एक बार सहमति देने का अनुरोध करें देखें.