Buat akun baru dengan sekali ketuk

Jika Anda mendukung Login dengan Google, Anda dapat menggunakan klien login Sekali Ketuk untuk memberi pengguna pengalaman pembuatan akun yang lancar dan tidak pernah mengalihkan mereka dari konteks aplikasi Anda.

UI pendaftaran sekali ketuk

Saat Anda menampilkan UI Sekali Ketuk, pengguna akan diminta untuk membuat akun baru dengan aplikasi Anda menggunakan salah satu Akun Google di perangkat mereka. Jika pengguna memilih untuk melanjutkan, Anda akan mendapatkan token ID dengan informasi profil dasar—nama, foto profil, dan alamat email terverifikasi—yang dapat Anda gunakan untuk membuat akun baru.

Penerapan pembuatan akun Sekali Ketuk memiliki dua bagian:

  • Mengintegrasikan klien Sekali Ketuk ke dalam aplikasi Anda, yang dijelaskan di halaman ini. Hal ini sebagian besar sama dengan menggunakan login Sekali Ketuk, tetapi dengan beberapa perbedaan dalam konfigurasi.
  • Menambahkan kemampuan untuk membuat akun pengguna dari token ID Google ke backend Anda, yang dibahas dalam Menggunakan token ID di backend.

Di mana saya harus menggunakan pendaftaran Sekali Ketuk?

Tempat paling efektif untuk menawarkan pendaftaran Sekali Ketuk kepada pengguna adalah dalam konteks di mana login akan mengaktifkan fitur baru. Pertama, coba proses login pengguna dengan kredensial tersimpan. Jika tidak ada kredensial tersimpan yang ditemukan, tawarkan untuk membuat akun baru bagi pengguna.

Sebelum memulai

Siapkan project Konsol Google Cloud dan project Android Anda seperti yang dijelaskan dalam Memulai login Sekali Ketuk.

1. Mengonfigurasi klien Sekali Ketuk

Untuk mengonfigurasi klien Sekali Ketuk untuk pembuatan akun, lakukan hal berikut:

  • Jangan aktifkan permintaan kredensial sandi. (Pendaftaran sekali ketuk hanya dapat dilakukan dengan autentikasi berbasis token.)

  • Aktifkan permintaan token ID Google menggunakan setGoogleIdTokenRequestOptions() dan setelan berikut:

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. Memantau pembatalan UI One Tap

Anda harus melacak apakah pengguna telah menolak untuk menggunakan pendaftaran Sekali Ketuk dengan menutup dialog atau mengetuk di luar dialog. Misalnya, Anda dapat menggunakan properti boolean Aktivitas Anda. (Lihat Berhenti menampilkan UI Sekali Ketuk, di bawah.)

3. Menampilkan UI pendaftaran Sekali Ketuk

Jika pengguna belum menolak menggunakan Sekali Ketuk untuk membuat akun baru, panggil metode beginSignIn() objek klien, dan lampirkan pemroses ke Task yang ditampilkan. Aplikasi biasanya melakukan langkah ini saat permintaan login Sekali Ketuk tidak menemukan kredensial tersimpan—yaitu, di pemroses kegagalan permintaan login:

  • Pemroses keberhasilan: Klien Sekali Ketuk memanggil pemroses keberhasilan jika pengguna telah menyiapkan satu atau beberapa Akun Google di perangkat. Di pemroses keberhasilan, dapatkan intent tertunda dari hasil Task dan teruskan ke startIntentSenderForResult() untuk memulai UI Sekali Ketuk.

  • Pemroses kegagalan: Jika pengguna tidak memiliki Akun Google di perangkat, klien One Tap akan memanggil pemroses kegagalan. Dalam hal ini, tidak ada tindakan yang diperlukan: terus tampilkan pengalaman logout aplikasi, dan pengguna dapat mendaftar dengan alur pembuatan akun normal Anda.

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. Menangani respons pengguna

Respons pengguna terhadap dialog pendaftaran Sekali Ketuk akan dilaporkan ke aplikasi Anda menggunakan metode onActivityResult() Aktivitas Anda. Jika pengguna memilih untuk membuat akun, hasilnya akan berupa token ID Google. Jika pengguna menolak untuk mendaftar, baik dengan menutup UI Sekali Ketuk atau mengetuk di luar UI tersebut, hasilnya akan ditampilkan dengan kode RESULT_CANCELED. Aplikasi Anda harus menangani kedua kemungkinan tersebut.

Membuat akun dengan token ID Google

Jika pengguna memilih untuk mendaftar dengan Akun Google, Anda bisa mendapatkan token ID untuk pengguna dengan meneruskan data intent dari onActivityResult() ke metode getSignInCredentialFromIntent() klien One Tap. Kredensial akan memiliki properti googleIdToken non-null.

Gunakan token ID untuk membuat akun di backend Anda (lihat Melakukan autentikasi dengan backend menggunakan token ID) dan proses login pengguna.

Kredensial juga berisi detail tambahan yang Anda minta, seperti nomor telepon terverifikasi akun jika tersedia.

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) {
                      // ...
              }
          }
      }
      // ...
  }

Berhenti menampilkan UI Sekali Ketuk

Jika pengguna menolak untuk login, panggilan ke getSignInCredentialFromIntent() akan menampilkan ApiException dengan kode status CommonStatusCodes.CANCELED. Jika hal ini terjadi, Anda harus berhenti menampilkan UI login Sekali Ketuk untuk sementara agar tidak mengganggu pengguna dengan perintah berulang. Contoh berikut mencapai hal ini dengan menetapkan properti pada Aktivitas, yang digunakan untuk menentukan apakah akan menawarkan login Sekali Ketuk kepada pengguna; namun, Anda juga dapat menyimpan nilai ke SharedPreferences atau menggunakan metode lain.

Penting untuk menerapkan pembatasan kapasitas Anda sendiri untuk perintah login Sekali Ketuk. Jika tidak, dan pengguna membatalkan beberapa perintah berturut-turut, klien Sekali Ketuk tidak akan meminta pengguna selama 24 jam ke depan.

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})")
                          }
                      }
                  }
              }
          }
      }
      // ...
  }

Langkah berikutnya

Saat pengguna menyelesaikan alur pendaftaran Sekali Ketuk, Anda akan mendapatkan token ID Google, yang mencakup beberapa informasi profil dasar: alamat email, nama lengkap, dan URL foto profil pengguna. Untuk banyak aplikasi, informasi ini sudah cukup bagi Anda untuk mengautentikasi pengguna di backend dan membuat akun baru.

Jika Anda memerlukan informasi tambahan untuk menyelesaikan pembuatan akun—misalnya, tanggal lahir pengguna—tampilkan alur detail pendaftaran kepada pengguna, tempat Anda meminta info tambahan ini. Kemudian, kirimkan ke backend Anda untuk menyelesaikan pembuatan akun.