基于 OAuth 的应用快速关联 (App Flip) 关联功能可让用户快速将其在您的身份验证系统中的账号关联到其 Google 账号。 如果用户在发起账户关联过程时手机上已安装您的应用，系统会顺畅地将他们转到您的应用以获取用户授权。
这种方法可提供更快的账户关联过程，因为用户无需重新输入用户名和密码进行身份验证；相反，App Flip 会利用用户在您的应用中的账号凭据。用户将其 Google 账号与您的应用关联后，便可利用您开发的任何集成。
您可以为 iOS 和 Android 应用设置 App Flip。
要求
如需实现 App Flip，您必须满足以下要求：
- 您必须拥有 Android 或 iOS 应用。
- 您必须拥有、管理和维护支持 OAuth 2.0 授权代码流程的 OAuth 2.0 服务器。
基于 OAuth 的 App Flip 流程
以下序列图详细说明了用户、Google 应用、您的应用和您的授权服务器之间针对 App Flip 的交互。
角色和职责
下表定义了 App Flip 流程中执行者的角色和职责。
| 执行者 / 组件 | GAL 角色 | 职责 |
|---|---|---|
| Google 应用 / 服务器 | OAuth 客户端 | 发起账户关联过程，触发到您的移动应用深层链接，将授权代码交换为令牌，并安全地存储这些令牌以访问您服务的 API。 |
| 您的应用 | 授权代理 | 对用户进行身份验证（通常使用现有应用凭据）， 获取意见征求，并从您的服务器检索授权代码。 |
| 您的授权服务器 | 授权服务器 | 验证授权代码和刷新令牌，并向 Google 服务器颁发访问 令牌。 |
หลักเกณฑ์การออกแบบ
ส่วนนี้อธิบายข้อกำหนดและคำแนะนำในการออกแบบหน้าจอขอความยินยอมในการลิงก์บัญชี App Flip หลังจากที่ Google เรียกใช้แอปของคุณแล้ว แอปจะแสดงหน้าจอขอความยินยอมต่อผู้ใช้
ข้อกำหนด
- คุณต้องแจ้งว่าระบบกำลังลิงก์บัญชีของผู้ใช้กับ Google ไม่ใช่กับผลิตภัณฑ์ Google ใดผลิตภัณฑ์หนึ่ง เช่น Google Home หรือ Google Assistant
คำแนะนำ
เราขอแนะนำให้คุณทำดังนี้
แสดงนโยบายความเป็นส่วนตัวของ Google ระบุลิงก์ไปยังนโยบายความเป็นส่วนตัวของ Google ในหน้าจอขอความยินยอม
ข้อมูลที่จะแชร์ ใช้ภาษาที่ชัดเจนและกระชับเพื่อบอกผู้ใช้ว่า Google ต้องการข้อมูลใดของผู้ใช้และเพราะเหตุใด
คำกระตุ้นการตัดสินใจที่ชัดเจน ระบุคำกระตุ้นให้ดำเนินการที่ชัดเจนในหน้าจอความยินยอม เช่น "ยอมรับและลิงก์" เนื่องจากผู้ใช้จำเป็นต้องเข้าใจว่าต้องแชร์ข้อมูลใดกับ Google เพื่อลิงก์บัญชี
ความสามารถในการปฏิเสธหรือยกเลิก จัดให้ผู้ใช้มีตัวเลือกในการย้อนกลับ ปฏิเสธ หรือยกเลิก หากเลือกที่จะไม่ลิงก์
ความสามารถในการยกเลิกการลิงก์ มีกลไกให้ผู้ใช้ยกเลิกการลิงก์ เช่น URL ไปยังการตั้งค่าบัญชีในแพลตฟอร์มของคุณ หรือคุณจะใส่ลิงก์ไปยังบัญชี Google ที่ผู้ใช้ สามารถจัดการบัญชีที่ลิงก์ได้ก็ได้
ความสามารถในการเปลี่ยนบัญชีผู้ใช้ แนะนำวิธีให้ผู้ใช้เปลี่ยนบัญชี ซึ่งจะเป็นประโยชน์อย่างยิ่งหากผู้ใช้มีแนวโน้มที่จะมี หลายบัญชี
- หากผู้ใช้ต้องปิดหน้าจอขอความยินยอมเพื่อเปลี่ยนบัญชี ให้ส่งข้อผิดพลาดที่กู้คืนได้ไปยัง Google เพื่อให้ผู้ใช้ลงชื่อเข้าใช้บัญชีที่ต้องการได้ด้วยการลิงก์ OAuth และโฟลว์โดยนัย
ใส่โลโก้ของคุณ แสดงโลโก้บริษัทในหน้าจอขอความยินยอม ใช้หลักเกณฑ์ด้านสไตล์เพื่อวางโลโก้ หากต้องการแสดงโลโก้ของ Google ด้วย โปรดดูโลโก้และเครื่องหมายการค้า
ใช้ App Flip ในแอป
หากต้องการใช้ App Flip คุณต้องแก้ไขรหัสการให้สิทธิ์ผู้ใช้ในแอปเพื่อยอมรับ Deep Link จาก Google
หากต้องการรองรับ App Flip ในแอป Android ให้ทำตามวิธีการในคู่มือการติดตั้งใช้งาน Android
หากต้องการรองรับ App Flip ในแอป iOS ให้ทำตามวิธีการในคู่มือการติดตั้งใช้งาน iOS
ทดสอบ App Flip
คุณอาจจำลองการพลิกแอปโดยใช้แอปตัวอย่างและแอปทดสอบก่อนที่จะมีแอปเวอร์ชันที่ใช้งานจริงที่ผ่านการยืนยันและเซิร์ฟเวอร์ OAuth 2.0 ที่ใช้งานได้
ในระหว่าง App Flip แอป Google จะเปิดแอปของคุณก่อน จากนั้นจะขอการตอบกลับรหัสการให้สิทธิ์จากเซิร์ฟเวอร์ OAuth 2.0 ของคุณ ในขั้นตอนสุดท้าย ระบบจะส่งการตอบกลับไปยังแอป Google
ข้อกำหนดเบื้องต้น
หากต้องการจำลองแอป Google และทริกเกอร์ Intent ที่เปิดแอปของคุณ ให้ดาวน์โหลดและติดตั้ง App Flip Test Tool สำหรับ Android และ iOS
ดาวน์โหลดและติดตั้ง App Flip Sample สำหรับ Android และ iOS เพื่อจำลองแอปและเลือกประเภทการตอบกลับ OAuth 2.0
ลำดับการทดสอบ
- เปิดเครื่องมือทดสอบการสลับแอป
- กด
Try Flip!เพื่อเปิดแอปตัวอย่าง App Flip - เลือกคำตอบจากปุ่มตัวเลือกในแอปตัวอย่าง
- กด
Sendเพื่อส่งการตอบกลับ OAuth 2.0 ที่จำลองกลับไปยังเครื่องมือทดสอบ - ตรวจสอบข้อความบันทึกของเครื่องมือทดสอบเพื่อดูรายละเอียด auth_code หรือข้อผิดพลาด
การทดสอบเวอร์ชันที่ใช้งานจริง
คุณอาจทดสอบ App Flip ในเวอร์ชันที่ใช้งานจริงได้หลังจากทำการลงทะเบียนและการติดตั้งใช้งานเซิร์ฟเวอร์ OAuth 2.0 เสร็จสมบูรณ์
เราขอแนะนำให้ใช้บัญชี Google เดียวและ อีเมลเฉพาะงาน สำหรับการทดสอบอัตโนมัติ
คุณดูสถานะการลิงก์บัญชีได้โดยใช้บัญชีที่ลิงก์เมื่อลงชื่อเข้าใช้ในฐานะ ผู้ถือบัญชี Google นอกจากนี้ ระบบอาจยกเลิกการลิงก์บัญชีระหว่างการทดสอบซ้ำๆ จาก ที่นี่ด้วย
คุณอาจเลือกใช้ RISC เพื่อ ยกเลิกการลิงก์และแจ้งให้ Google ทราบถึงการเปลี่ยนแปลงโดยอัตโนมัติ