หากคุณรองรับการลงชื่อเข้าใช้ด้วยบัญชี Google คุณสามารถใช้ไคลเอ็นต์การลงชื่อเข้าใช้ด้วย One Tap เพื่อมอบประสบการณ์การสร้างบัญชีที่ราบรื่นให้แก่ผู้ใช้โดยไม่ต้องออกจากบริบทของแอป
เมื่อคุณแสดง UI ของ One Tap ระบบจะแจ้งให้ผู้ใช้สร้างบัญชีใหม่ด้วยแอปของคุณโดยใช้บัญชี Google บัญชีใดบัญชีหนึ่งในอุปกรณ์ หากผู้ใช้เลือกที่จะดำเนินการต่อ คุณจะได้รับโทเค็นระบุตัวตนพร้อมข้อมูลโปรไฟล์พื้นฐาน ซึ่งได้แก่ ชื่อ รูปโปรไฟล์ และอีเมลที่ยืนยันแล้ว ซึ่งคุณสามารถใช้เพื่อสร้างบัญชีใหม่ได้
การใช้การสร้างบัญชีด้วย One Tap มี 2 ส่วน ได้แก่
- การผสานรวมไคลเอ็นต์ One Tap เข้ากับแอป ซึ่งอธิบายไว้ในหน้านี้ ซึ่งส่วนใหญ่จะเหมือนกับการใช้การลงชื่อเข้าใช้ด้วย One Tap แต่มีการกำหนดค่าที่แตกต่างกันบางอย่าง
- การเพิ่มความสามารถในการสร้างบัญชีผู้ใช้จากโทเค็นรหัส Google ลงในแบ็กเอนด์ ซึ่งจะอธิบายไว้ในการใช้โทเค็นรหัสในแบ็กเอนด์
ฉันควรใช้การลงชื่อสมัครใช้ด้วย One Tap ที่ใด
ตำแหน่งที่มีประสิทธิภาพมากที่สุดในการเสนอการลงชื่อสมัครใช้ด้วย One Tap แก่ผู้ใช้คือในบริบทที่การลงชื่อเข้าใช้จะเปิดใช้ฟีเจอร์ใหม่ๆ ขั้นแรก ให้ลองลงชื่อเข้าใช้ให้ผู้ใช้ด้วยข้อมูลเข้าสู่ระบบที่บันทึกไว้ หากไม่พบข้อมูลเข้าสู่ระบบที่บันทึกไว้ ให้เสนอให้สร้างบัญชีใหม่สำหรับผู้ใช้
ก่อนเริ่มต้น
ตั้งค่าโปรเจ็กต์คอนโซล Google Cloud และโปรเจ็กต์ Android ตามที่อธิบายไว้ในเริ่มต้นใช้งานการลงชื่อเข้าใช้ด้วย One Tap
1. กำหนดค่าไคลเอ็นต์ One Tap
หากต้องการกำหนดค่าไคลเอ็นต์ One Tap สำหรับการสร้างบัญชี ให้ทำดังนี้
- อย่าเปิดใช้คำขอข้อมูลเข้าสู่ระบบด้วยรหัสผ่าน (การลงชื่อสมัครใช้ด้วย One Tap จะทำได้ก็ต่อเมื่อใช้การตรวจสอบสิทธิ์แบบใช้โทเค็นเท่านั้น)
เปิดใช้คำขอโทเค็นรหัส Google โดยใช้
setGoogleIdTokenRequestOptions()และการตั้งค่าต่อไปนี้- ตั้งค่ารหัสไคลเอ็นต์ของเซิร์ฟเวอร์เป็นรหัสที่คุณสร้างในคอนโซล Google Cloud โปรดทราบว่านี่คือรหัสไคลเอ็นต์ของเซิร์ฟเวอร์ ไม่ใช่รหัสไคลเอ็นต์ 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. ติดตามการยกเลิก UI ของ One Tap
คุณควรติดตามว่าผู้ใช้ปฏิเสธที่จะใช้การลงชื่อสมัครใช้ด้วย One Tap หรือไม่ โดยการปิดข้อความแจ้งหรือแตะนอกข้อความแจ้ง เช่น คุณสามารถใช้พร็อพเพอร์ตี้บูลีนของกิจกรรมได้ (ดูหยุดแสดง UI ของ One Tap ด้านล่าง)
3. แสดง UI การลงชื่อสมัครใช้ด้วย One Tap
หากผู้ใช้ไม่ได้ปฏิเสธที่จะใช้ One Tap เพื่อสร้างบัญชีใหม่ ให้เรียกใช้เมธอด beginSignIn() ของออบเจ็กต์ไคลเอ็นต์ และแนบ Listener กับ Task ที่แสดงผล โดยปกติแล้ว แอปจะทำขั้นตอนนี้เมื่อคำขอการลงชื่อเข้าใช้ด้วย One Tap ไม่พบข้อมูลเข้าสู่ระบบที่บันทึกไว้ ซึ่งก็คือใน Listener ของคำขอลงชื่อเข้าใช้ที่ดำเนินการไม่สำเร็จ
- Success listener: ไคลเอ็นต์ One Tap จะเรียกใช้ Success listener หากผู้ใช้ตั้งค่าบัญชี Google อย่างน้อย 1 บัญชีในอุปกรณ์ ใน Listener ที่ประสบความสำเร็จ ให้รับ Intent รอดำเนินการจากผลลัพธ์
Taskและส่งไปยังstartIntentSenderForResult()เพื่อเริ่ม UI ของ One Tap Failure listener: หากผู้ใช้ไม่มีบัญชี Google ในอุปกรณ์ ไคลเอ็นต์ One Tap จะเรียกใช้ Failure listener ในกรณีนี้ คุณไม่จำเป็นต้องดำเนินการใดๆ เพียงแสดงประสบการณ์การใช้งานแอปแบบออกจากระบบต่อไป และผู้ใช้จะลงชื่อสมัครใช้ด้วยขั้นตอนการสร้างบัญชีตามปกติได้
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 หากผู้ใช้ปฏิเสธที่จะลงชื่อสมัครใช้โดยการปิด UI ของ One Tap หรือแตะนอก UI ผลลัพธ์จะแสดงพร้อมรหัส RESULT_CANCELED แอปของคุณต้องจัดการทั้ง 2 กรณีที่เป็นไปได้
สร้างบัญชีด้วยโทเค็นรหัส Google
หากผู้ใช้เลือกลงชื่อสมัครใช้ด้วยบัญชี Google คุณจะรับโทเค็นระบุตัวตนของผู้ใช้ได้โดยส่งข้อมูล Intent จาก onActivityResult() ไปยังเมธอด getSignInCredentialFromIntent() ของไคลเอ็นต์ One Tap ข้อมูลเข้าสู่ระบบจะมีพร็อพเพอร์ตี้ googleIdToken ที่ไม่ใช่ค่า Null
ใช้โทเค็นระบุตัวตนเพื่อสร้างบัญชีในแบ็กเอนด์ (ดูหัวข้อตรวจสอบสิทธิ์ด้วยแบ็กเอนด์โดยใช้โทเค็นระบุตัวตน) และลงชื่อเข้าใช้ให้ผู้ใช้
นอกจากนี้ ข้อมูลเข้าสู่ระบบยังมีรายละเอียดเพิ่มเติมที่คุณขอ เช่น หมายเลขโทรศัพท์ที่ยืนยันแล้วของบัญชี (หากมี)
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) {
// ...
}
}
}
// ...
}
หยุดแสดง UI ของ One Tap
หากผู้ใช้ปฏิเสธที่จะลงชื่อเข้าใช้ การเรียกใช้ getSignInCredentialFromIntent() จะแสดง ApiException พร้อมรหัสสถานะ CommonStatusCodes.CANCELED
เมื่อเกิดกรณีนี้ขึ้น คุณควรหยุดแสดง UI การลงชื่อเข้าใช้ด้วย 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 ซึ่งมีข้อมูลโปรไฟล์พื้นฐานบางอย่าง เช่น อีเมล ชื่อเต็ม และ URL รูปโปรไฟล์ของผู้ใช้ สำหรับแอปจำนวนมาก ข้อมูลนี้เพียงพอที่จะตรวจสอบสิทธิ์ผู้ใช้ในแบ็กเอนด์และสร้างบัญชีใหม่
หากต้องการข้อมูลเพิ่มเติมเพื่อสร้างบัญชีให้เสร็จสมบูรณ์ เช่น วันเกิดของผู้ใช้ ให้แสดงขั้นตอนรายละเอียดการลงชื่อสมัครใช้แก่ผู้ใช้ ซึ่งคุณจะขอข้อมูลเพิ่มเติมนี้ จากนั้นส่งข้อมูลไปยังแบ็กเอนด์เพื่อสร้างบัญชีให้เสร็จสมบูรณ์