एक टैप से नए खाते बनाएं

अगर आपने अपने ऐप्लिकेशन में Google खातों से साइन इन करने की सुविधा दी है, तो One Tap साइन-इन क्लाइंट का इस्तेमाल करके, अपने उपयोगकर्ताओं को खाता बनाने का आसान अनुभव दिया जा सकता है. इससे, उपयोगकर्ता आपके ऐप्लिकेशन से कभी बाहर नहीं निकलेंगे.

One Tap साइन-अप का यूज़र इंटरफ़ेस (यूआई)

One Tap यूज़र इंटरफ़ेस (यूआई) दिखाने पर, उपयोगकर्ताओं को अपने डिवाइस पर मौजूद किसी Google खाते का इस्तेमाल करके, आपके ऐप्लिकेशन में नया खाता बनाने के लिए कहा जाता है. अगर उपयोगकर्ता आगे बढ़ने का विकल्प चुनता है, तो आपको प्रोफ़ाइल की बुनियादी जानकारी वाला आईडी टोकन मिलता है. इसमें उपयोगकर्ता का नाम, प्रोफ़ाइल फ़ोटो, और पुष्टि किया गया ईमेल पता शामिल होता है. इसका इस्तेमाल, नया खाता बनाने के लिए किया जा सकता है.

एक टैप से खाता बनाने की सुविधा को लागू करने के दो चरण हैं:

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

मुझे One Tap साइन-अप की सुविधा कहां इस्तेमाल करनी चाहिए?

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

शुरू करने से पहले

One Tap साइन-इन की सुविधा का इस्तेमाल शुरू करना में बताए गए तरीके के मुताबिक, अपना Google API कंसोल प्रोजेक्ट और Android प्रोजेक्ट सेट अप करें.

1. One Tap क्लाइंट को कॉन्फ़िगर करना

खाता बनाने के लिए, One Tap क्लाइंट को कॉन्फ़िगर करने के लिए, यह तरीका अपनाएं:

  • पासवर्ड क्रेडेंशियल के अनुरोधों को चालू न करें. (One Tap साइन-अप की सुविधा सिर्फ़ टोकन पर आधारित पुष्टि के साथ काम करती है.)
  • setGoogleIdTokenRequestOptions() और इन सेटिंग का इस्तेमाल करके, Google आईडी टोकन के अनुरोध चालू करें:

    • सर्वर क्लाइंट आईडी को Google APIs कंसोल में बनाए गए आईडी पर सेट करें. ध्यान दें कि यह आपके सर्वर का क्लाइंट आईडी है, न कि आपका Android क्लाइंट आईडी.
    • क्लाइंट को कॉन्फ़िगर करें, ताकि वह डिवाइस पर सभी Google खाते दिखा सके. इसका मतलब है कि अनुमति वाले खातों के हिसाब से फ़िल्टर न करें.
    • इसके अलावा, आपके पास खाते के लिए पुष्टि किए गए फ़ोन नंबर का अनुरोध करने का विकल्प भी है.

Java

public class YourActivity extends AppCompatActivity {

  // ...

  private SignInClient oneTapClient;
  private BeginSignInRequest signUpRequest;

  @Override
  public void onCreate(@Nullable Bundle savedInstanceState,
                       @Nullable PersistableBundle persistentState) {
      super.onCreate(savedInstanceState, persistentState);

      oneTapClient = Identity.getSignInClient(this);
      signUpRequest = BeginSignInRequest.builder()
              .setGoogleIdTokenRequestOptions(GoogleIdTokenRequestOptions.builder()
                      .setSupported(true)
                      // Your server's client ID, not your Android client ID.
                      .setServerClientId(getString(R.string.your_web_client_id))
                      // Show all accounts on the device.
                      .setFilterByAuthorizedAccounts(false)
                      .build())
              .build();

      // ...
  }
}

Kotlin

class YourActivity : AppCompatActivity() {
    // ...

    private lateinit var oneTapClient: SignInClient
    private lateinit var signUpRequest: BeginSignInRequest

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        oneTapClient = Identity.getSignInClient(this)
        signUpRequest = BeginSignInRequest.builder()
            .setGoogleIdTokenRequestOptions(
                BeginSignInRequest.GoogleIdTokenRequestOptions.builder()
                    .setSupported(true)
                    // Your server's client ID, not your Android client ID.
                    .setServerClientId(getString(R.string.your_web_client_id))
                    // Show all accounts on the device.
                    .setFilterByAuthorizedAccounts(false)
                    .build())
            .build()
        // ...
    }
    // ...
}

2. One Tap यूज़र इंटरफ़ेस (यूआई) के रद्द होने पर नज़र रखना

आपको यह ट्रैक करना चाहिए कि उपयोगकर्ता ने पहले ही, One Tap साइन-अप का इस्तेमाल करने से मना किया है या नहीं. ऐसा करने के लिए, प्रॉम्प्ट को बंद करें या उसके बाहर टैप करें. यह आपकी गतिविधि की बूलियन प्रॉपर्टी की तरह ही आसान हो सकता है. (One Tap का यूज़र इंटरफ़ेस (यूआई) दिखाना बंद करना लेख पढ़ें.)

3. One Tap साइन-अप का यूज़र इंटरफ़ेस (यूआई) दिखाना

अगर उपयोगकर्ता ने नया खाता बनाने के लिए, One Tap का इस्तेमाल करने से मना नहीं किया है, तो क्लाइंट ऑब्जेक्ट के beginSignIn() तरीके को कॉल करें और Task को अटैच करें. आम तौर पर, ऐप्लिकेशन यह चरण तब पूरा करते हैं, जब One Tap से साइन इन करने के अनुरोध में सेव किए गए कोई क्रेडेंशियल न मिले. इसका मतलब है कि साइन-इन करने के अनुरोध के फ़ेल्योर लिसनर में.

अगर उपयोगकर्ता के डिवाइस पर एक या एक से ज़्यादा Google खाते सेट अप हैं, तो One Tap क्लाइंट, 'सफलता के बारे में सुनने वाला' फ़ंक्शन को कॉल करेगा. 'सफलता सुनने वाला' फ़ंक्शन में, Task नतीजे से, बाकी बचे इंटेंट को पाएं और One Tap यूज़र इंटरफ़ेस (यूआई) शुरू करने के लिए, उसे startIntentSenderForResult() को पास करें.

अगर उपयोगकर्ता के डिवाइस पर कोई Google खाता नहीं है, तो One Tap क्लाइंट, गड़बड़ी सुनने वाले को कॉल करेगा. इस मामले में, कोई कार्रवाई करने की ज़रूरत नहीं है: आपके पास ऐप्लिकेशन को साइन-आउट किए हुए अनुभव के तौर पर दिखाने का विकल्प है. साथ ही, उपयोगकर्ता आपके खाता बनाने के सामान्य फ़्लो का इस्तेमाल करके साइन अप कर सकता है.

Java

oneTapClient.beginSignIn(signUpRequest)
        .addOnSuccessListener(this, new OnSuccessListener<BeginSignInResult>() {
            @Override
            public void onSuccess(BeginSignInResult result) {
                try {
                    startIntentSenderForResult(
                            result.getPendingIntent().getIntentSender(), REQ_ONE_TAP,
                            null, 0, 0, 0);
                } catch (IntentSender.SendIntentException e) {
                    Log.e(TAG, "Couldn't start One Tap UI: " + e.getLocalizedMessage());
                }
            }
        })
        .addOnFailureListener(this, new OnFailureListener() {
            @Override
            public void onFailure(@NonNull Exception e) {
                // No Google Accounts found. Just continue presenting the signed-out UI.
                Log.d(TAG, e.getLocalizedMessage());
            }
        });

Kotlin

oneTapClient.beginSignIn(signUpRequest)
    .addOnSuccessListener(this) { result ->
        try {
            startIntentSenderForResult(
                result.pendingIntent.intentSender, REQ_ONE_TAP,
                null, 0, 0, 0)
        } catch (e: IntentSender.SendIntentException) {
            Log.e(TAG, "Couldn't start One Tap UI: ${e.localizedMessage}")
        }
    }
    .addOnFailureListener(this) { e ->
        // No Google Accounts found. Just continue presenting the signed-out UI.
        Log.d(TAG, e.localizedMessage)
    }

4. उपयोगकर्ता के जवाब को मैनेज करना

One Tap से साइन अप करने के लिए उपयोगकर्ता का जवाब, आपके ऐप्लिकेशन को भेजा जाएगा. इसके लिए, गतिविधि के onActivityResult() तरीके का इस्तेमाल किया जाएगा. अगर उपयोगकर्ता ने खाता बनाने का विकल्प चुना, तो नतीजा Google आईडी टोकन होगा. अगर उपयोगकर्ता ने साइन अप करने से मना कर दिया है, तो RESULT_CANCELED कोड के साथ नतीजा दिखेगा. ऐसा तब होगा, जब उपयोगकर्ता ने One Tap यूज़र इंटरफ़ेस (यूआई) को बंद किया हो या उसके बाहर टैप किया हो. आपके ऐप्लिकेशन को दोनों स्थितियों को मैनेज करना होगा.

Google आईडी टोकन की मदद से खाता बनाना

अगर उपयोगकर्ता ने Google खाते से साइन अप करने का विकल्प चुना है, तो onActivityResult() से One Tap क्लाइंट के getSignInCredentialFromIntent() तरीके में इंटेंट डेटा भेजकर, उपयोगकर्ता के लिए आईडी टोकन पाया जा सकता है. क्रेडेंशियल में, googleIdToken प्रॉपर्टी की वैल्यू शून्य नहीं होगी.

अपने बैकएंड पर खाता बनाने के लिए, आईडी टोकन का इस्तेमाल करें. इसके लिए, आईडी टोकन का इस्तेमाल करके बैकएंड से पुष्टि करना लेख पढ़ें. इसके बाद, उपयोगकर्ता को साइन इन कराएं.

क्रेडेंशियल में, आपके अनुरोध की गई अन्य जानकारी भी शामिल होती है. जैसे, अगर खाते का पुष्टि किया गया फ़ोन नंबर उपलब्ध है, तो वह भी शामिल होता है.

Java

public class YourActivity extends AppCompatActivity {

  // ...
  private static final int REQ_ONE_TAP = 2;  // Can be any integer unique to the Activity.
  private boolean showOneTapUI = true;
  // ...

  @Override
  protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
      super.onActivityResult(requestCode, resultCode, data);

      switch (requestCode) {
          case REQ_ONE_TAP:
              try {
                  SignInCredential credential = oneTapClient.getSignInCredentialFromIntent(data);
                  String idToken = credential.getGoogleIdToken();
                  if (idToken !=  null) {
                      // Got an ID token from Google. Use it to authenticate
                      // with your backend.
                      Log.d(TAG, "Got ID token.");
                  }
              } catch (ApiException e) {
                  // ...
              }
              break;
      }
  }
}

Kotlin

class YourActivity : AppCompatActivity() {

    // ...
    private val REQ_ONE_TAP = 2  // Can be any integer unique to the Activity
    private var showOneTapUI = true
    // ...

    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        super.onActivityResult(requestCode, resultCode, data)

        when (requestCode) {
             REQ_ONE_TAP -> {
                try {
                    val credential = oneTapClient.getSignInCredentialFromIntent(data)
                    val idToken = credential.googleIdToken
                    when {
                        idToken != null -> {
                            // Got an ID token from Google. Use it to authenticate
                            // with your backend.
                            Log.d(TAG, "Got ID token.")
                        }
                        else -> {
                            // Shouldn't happen.
                            Log.d(TAG, "No ID token!")
                        }
                    }
                } catch (e: ApiException) {
                    // ...
            }
        }
    }
    // ...
}

One Tap का यूज़र इंटरफ़ेस दिखाना बंद करना

अगर उपयोगकर्ता ने साइन इन करने से मना कर दिया, तो getSignInCredentialFromIntent() पर किए गए कॉल से ApiException दिखेगा. साथ ही, CommonStatusCodes.CANCELED स्टेटस कोड भी दिखेगा. ऐसा होने पर, आपको कुछ समय के लिए One Tap साइन-इन यूज़र इंटरफ़ेस (यूआई) दिखाना बंद कर देना चाहिए, ताकि बार-बार प्रॉम्प्ट दिखाकर उपयोगकर्ताओं को परेशान न किया जाए. यहां दिए गए उदाहरण में, गतिविधि पर प्रॉपर्टी सेट करके ऐसा किया गया है. इस प्रॉपर्टी का इस्तेमाल यह तय करने के लिए किया जाता है कि उपयोगकर्ता को One Tap साइन-इन की सुविधा देनी है या नहीं. हालांकि, SharedPreferences में कोई वैल्यू सेव की जा सकती है या किसी अन्य तरीके का इस्तेमाल किया जा सकता है.

One Tap साइन इन के अनुरोधों की दर को सीमित करना ज़रूरी है. अगर ऐसा नहीं किया जाता है और कोई उपयोगकर्ता लगातार कई अनुरोधों को रद्द करता है, तो One Tap क्लाइंट अगले 24 घंटों तक उपयोगकर्ता को अनुरोध नहीं करेगा.

Java

public class YourActivity extends AppCompatActivity {

  // ...
  private static final int REQ_ONE_TAP = 2;  // Can be any integer unique to the Activity.
  private boolean showOneTapUI = true;
  // ...

  @Override
  protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
      super.onActivityResult(requestCode, resultCode, data);

      switch (requestCode) {
          case REQ_ONE_TAP:
              try {
                  // ...
              } catch (ApiException e) {
                  switch (e.getStatusCode()) {
                      case CommonStatusCodes.CANCELED:
                          Log.d(TAG, "One-tap dialog was closed.");
                          // Don't re-prompt the user.
                          showOneTapUI = false;
                          break;
                      case CommonStatusCodes.NETWORK_ERROR:
                          Log.d(TAG, "One-tap encountered a network error.");
                          // Try again or just ignore.
                          break;
                      default:
                          Log.d(TAG, "Couldn't get credential from result."
                                  + e.getLocalizedMessage());
                          break;
                  }
              }
              break;
      }
  }
}

Kotlin

class YourActivity : AppCompatActivity() {

    // ...
    private val REQ_ONE_TAP = 2  // Can be any integer unique to the Activity
    private var showOneTapUI = true
    // ...

    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        super.onActivityResult(requestCode, resultCode, data)

        when (requestCode) {
            REQ_ONE_TAP -> {
                try {
                    // ...
                } catch (e: ApiException) {
                    when (e.statusCode) {
                        CommonStatusCodes.CANCELED -> {
                            Log.d(TAG, "One-tap dialog was closed.")
                            // Don't re-prompt the user.
                            showOneTapUI = false
                        }
                        CommonStatusCodes.NETWORK_ERROR -> {
                            Log.d(TAG, "One-tap encountered a network error.")
                            // Try again or just ignore.
                        }
                        else -> {
                            Log.d(TAG, "Couldn't get credential from result." +
                                " (${e.localizedMessage})")
                        }
                    }
                }
            }
        }
    }
    // ...
}

अगले चरण

जब कोई उपयोगकर्ता One Tap साइन-अप फ़्लो पूरा करता है, तो आपको Google आईडी टोकन मिलता है. इसमें प्रोफ़ाइल की कुछ बुनियादी जानकारी शामिल होती है: उपयोगकर्ता का ईमेल पता, पूरा नाम, और प्रोफ़ाइल फ़ोटो का यूआरएल. कई ऐप्लिकेशन के लिए, यह जानकारी बैकएंड पर उपयोगकर्ता की पुष्टि करने और नया खाता बनाने के लिए काफ़ी है.

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