खास जानकारी

OAuth-based App Flip Linking (App Flip) allows your users to easily and quickly link their accounts in your authentication system to their Google accounts. If your app is installed on your user’s phone when they initiate the account linking process, they are seamlessly flipped to your app to obtain user authorization.

This approach provides a faster and easier linking process since the user does not have to re-enter their username and password to authenticate; instead, App Flip leverages the credentials from the user's account on your app. Once a user has linked their Google account with your app, they can take advantage of any integrations that you have developed.

You can set up App Flip for both iOS and Android apps.

This figure shows the steps for a user to link their Google account to your authentication system. The first screenshot shows how a user can select your app if their Google account is linked to your app. The second screenshot shows the confirmation for linking their Google account with your app. The third screenshot shows a successfully linked user account in the Google app.
Figure 1. Account linking on a user's phone with App Flip.

Requirements

To implement App Flip, you must fulfill the following requirements:

  • You must have an Android or iOS app.
  • You must own, manage and maintain an OAuth 2.0 server which supports the OAuth 2.0 authorization code flow.

OAuth लिंक करने के ऑथराइज़ेशन कोड के फ़्लो के बारे में ज़्यादा जानकारी के लिए, अपना OAuth सर्वर लागू करना लेख पढ़ें.

डिज़ाइन से जुड़े दिशा-निर्देश

इस सेक्शन में, App Flipp खाता लिंक करने की सहमति वाली स्क्रीन के डिज़ाइन से जुड़ी ज़रूरी शर्तों और सुझावों के बारे में बताया गया है. Google आपके ऐप्लिकेशन को कॉल करने के बाद, आपका ऐप्लिकेशन उपयोगकर्ता को सहमति वाली स्क्रीन दिखाता है.

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

  1. आपको यह बताना होगा कि उपयोगकर्ता के खाते को Google से लिंक किया जा रहा है, न कि Google के किसी प्रॉडक्ट से, जैसे कि Google Home या Google Assistant.

सुझाव

हमारा सुझाव है कि आप ये काम करें:

  1. Google की निजता नीति दिखाएं. सहमति वाली स्क्रीन पर, Google की निजता नीति का लिंक शामिल करें.

  2. शेयर किया जाने वाला डेटा. साफ़ और कम शब्दों में उपयोगकर्ता को बताएं कि Google को उनके लिए कौनसे डेटा की ज़रूरत है और क्यों.

  3. साफ़ तौर पर कॉल-टू-ऐक्शन दें. सहमति वाली स्क्रीन पर, साफ़ तौर पर कॉल-टू-ऐक्शन दें. जैसे, “सहमति दें और लिंक करें”. ऐसा इसलिए ज़रूरी है, ताकि उपयोगकर्ताओं को यह समझ आ सके कि खाते लिंक करने के लिए, उन्हें Google के साथ कौनसा डेटा शेयर करना होगा.

  4. सदस्यता रद्द करने की सुविधा. उपयोगकर्ताओं को लिंक न करने का विकल्प चुनने पर, उन्हें वापस जाने या सदस्यता रद्द करने का तरीका बताएं.

  5. अनलिंक करने की सुविधा. उपयोगकर्ताओं को खाता अनलिंक करने का तरीका उपलब्ध कराएं. जैसे, आपके प्लैटफ़ॉर्म पर उनके खाते की सेटिंग का यूआरएल. इसके अलावा, Google खाते का लिंक भी शामिल किया जा सकता है, जहां उपयोगकर्ता अपने लिंक किए गए खाते को मैनेज कर सकते हैं.

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

    • अगर किसी उपयोगकर्ता को खाता स्विच करने के लिए, सहमति वाली स्क्रीन बंद करनी पड़ती है, तो Google को ऐसी गड़बड़ी भेजें जिसे ठीक किया जा सके. इससे उपयोगकर्ता, OAuth लिंकिंग और अनिमिट फ़्लो की मदद से, अपने पसंदीदा खाते में साइन इन कर सकता है.

  7. अपना लोगो शामिल करें. सहमति वाली स्क्रीन पर अपनी कंपनी का लोगो दिखाएं. अपना लोगो लगाने के लिए, स्टाइल से जुड़े दिशा-निर्देशों का इस्तेमाल करें. अगर आपको Google का लोगो भी दिखाना है, तो लोगो और ट्रेडमार्क देखें.

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

OAuth पर आधारित App Flip के लिए सेट अप करें

नीचे दिए गए सेक्शन में, OAuth पर आधारित ऐप्लिकेशन Flip से जुड़ी ज़रूरी शर्तों के बारे में बताया गया है. साथ ही, Actions कंसोल में अपने ऐप्लिकेशन Flip प्रोजेक्ट को कॉन्फ़िगर करने का तरीका भी बताया गया है.

कोई कार्रवाई बनाएं और OAuth 2.0 सर्वर सेट अप करें

App Flip को कॉन्फ़िगर करने से पहले, आपको ये काम करने होंगे:

Actions कंसोल में ऐप्लिकेशन फ़्लिप को कॉन्फ़िगर करें

नीचे दिए गए सेक्शन में, Actions कंसोल में App Flip को कॉन्फ़िगर करने का तरीका बताया गया है.

  1. सबसे ऊपर मौजूद नेविगेशन में, डेवलप करें पर क्लिक करें. इसके बाद, बाईं ओर मौजूद नेविगेशन में, खाता लिंक करना पर क्लिक करें.
  2. खाता जोड़ना के बगल में मौजूद स्विच को टॉगल करें.
  3. खाता बनाएं में जाकर, नहीं, मुझे सिर्फ़ अपनी वेबसाइट पर खाता बनाने की अनुमति देनी है को चुनें.
  4. आगे बढ़ें पर क्लिक करें.
  5. लिंक करने का टाइप में जाकर, ड्रॉप-डाउन मेन्यू से OAuth और ऑथराइज़ेशन कोड चुनें.
  6. आगे बढ़ें पर क्लिक करें.
  7. OAuth क्लाइंट की जानकारी में जाकर, सभी फ़ील्ड भरें. (अगर ऐप्लिकेशन फ़्लिप काम नहीं करता है, तो सामान्य OAuth का इस्तेमाल फ़ॉलबैक के तौर पर किया जाता है.)
  8. आगे बढ़ें पर क्लिक करें.
  9. खाता लिंक करने के लिए अपने ऐप्लिकेशन का इस्तेमाल करें (ज़रूरी नहीं) में जाकर, iOS के लिए चालू करें पर सही का निशान लगाएं.
  10. Universal लिंक फ़ील्ड भरें. यूनिवर्सल लिंक के बारे में ज़्यादा जानकारी के लिए, ऐप्लिकेशन और वेबसाइटों को अपने कॉन्टेंट से लिंक करने की अनुमति देना देखें.
  11. अगर आपको अपने क्लाइंट को वैकल्पिक तौर पर कॉन्फ़िगर करना है, तो स्कोप जोड़ें और अपने क्लाइंट को कॉन्फ़िगर करें (ज़रूरी नहीं) में जाकर, दायरा जोड़ें पर क्लिक करें. अगर नहीं, तो आगे बढ़ें पर क्लिक करें.
  12. जांच के निर्देशों में, प्लेसहोल्डर के तौर पर test (या कोई दूसरी स्ट्रिंग) टाइप करें. (इस फ़ील्ड में जांच वाला खाता भरना सिर्फ़ तब ज़रूरी होता है, जब आप असल में अपनी कार्रवाई को पब्लिश करने के लिए सबमिट कर रहे हों.)
  13. सेव करें पर क्लिक करें.

अब अगले सेक्शन पर जाकर, iOS या Android ऐप्लिकेशन में App Flip को लागू किया जा सकता है.

अपने खास ऐप्लिकेशन में App Flip लागू करना

App Flip को लागू करने के लिए, आपको अपने ऐप्लिकेशन में उपयोगकर्ता के ऑथराइज़ेशन कोड में बदलाव करना होगा, ताकि Google से डीप लिंक स्वीकार किया जा सके.

अपने डिवाइस पर ऐप्लिकेशन फ़्लिप की जांच करें

अब आपने कंसोल पर और अपने ऐप्लिकेशन में कार्रवाई बनाकर App Flip को कॉन्फ़िगर कर लिया है, इसलिए अब मोबाइल डिवाइस पर App Flip की जांच की जा सकती है. App Flip को टेस्ट करने के लिए Google Assistant ऐप्लिकेशन का इस्तेमाल किया जा सकता है.

Assistant ऐप्लिकेशन से App Flip को टेस्ट करने के लिए, यह तरीका अपनाएं:

  1. Actions कंसोल पर जाएं और अपना प्रोजेक्ट चुनें.
  2. सबसे ऊपर मौजूद नेविगेशन में जांच करें पर क्लिक करें.
  3. Assistant ऐप्लिकेशन से खाता लिंक करने के फ़्लो को ट्रिगर करना:
    1. Google Assistant ऐप्लिकेशन खोलें.
    2. सेटिंग पर क्लिक करें.
    3. Assistant टैब में, होम कंट्रोल पर क्लिक करें.
    4. जोड़ें(+) पर क्लिक करें.
    5. सेवा देने वालों की सूची में से अपनी कार्रवाई चुनें. सूची में इससे पहले “[test]” लगा दिया जाएगा. सूची में से [test] कार्रवाई चुनने पर, आपका ऐप्लिकेशन खुल जाएगा.
    6. पुष्टि करें कि आपका ऐप्लिकेशन लॉन्च हो गया है और अपने ऑथराइज़ेशन फ़्लो की जांच शुरू करें.