ربط حساب Google باستخدام ميزة "قلب التطبيق" المستندة إلى بروتوكول OAuth

借助基于 OAuth 的应用快速关联 (App Flip)，您的用户可以轻松快速地将其在您的身份验证系统中的账号与其 Google 账号相关联。如果用户在发起账号关联流程时您的应用已安装在其手机上，系统会将用户顺畅地转到您的应用以获取用户授权。

这种方法可简化关联流程，因为用户无需重新输入用户名和密码即可进行身份验证；相反，App Flip 会利用用户在您应用中的账号凭据。用户将其 Google 账号与您的应用相关联后，便可使用您开发的任何集成。

您可以为 iOS 和 Android 应用设置应用快速关联。

图 1. 在用户手机上使用 App Flip 进行账号关联。

要求

如需实现应用翻转，您必须满足以下要求：

• 您必须拥有 Android 或 iOS 应用。
• 您必须拥有、管理和维护一个支持 OAuth 2.0 授权代码流程的 OAuth 2.0 服务器。

注意 ：如我们的指南中所述，请确认您的 OAuth2 实现或提供方支持授权代码流程以及 app flip 重定向网址和 client_ids。

إرشادات التصميم

يصف هذا القسم متطلبات التصميم والاقتراحات لشاشة الموافقة على ربط الحساب باستخدام App Flip. بعد استدعاء Google لتطبيقك، يعرض تطبيقك شاشة الموافقة للمستخدم.

المتطلبات

1. يجب إبلاغ المستخدم بأنّه سيتم ربط حسابه بمنصّة Google، وليس بمنتج معيّن من Google، مثل Google Home أو مساعد Google.

اقتراحات

ننصحك باتّباع الخطوات التالية:

1. عرض سياسة خصوصية Google: أدرِج رابطًا يؤدي إلى سياسة خصوصية Google على شاشة الموافقة.

2. البيانات التي ستتم مشاركتها: استخدِم لغة واضحة وموجزة لإعلام المستخدم بال data التي تطلبها Google منه والغرض من ذلك.

3. عبارة واضحة تحثّ على اتّخاذ إجراء: يجب تضمين عبارة واضحة للحث على اتّخاذ إجراء على شاشة طلب الموافقة، مثل "أوافق وأريد الربط". ويعود سبب ذلك إلى أنّ المستخدمين يحتاجون إلى معرفة البيانات التي سيُطلب منهم مشاركتها مع Google لربط حساباتهم.

4. إمكانية إلغاء الاشتراك: احرص على توفير طريقة للمستخدمين للعودة أو الإلغاء، إذا اختاروا عدم الربط.

5. إمكانية إلغاء الربط: قدِّم آلية للمستخدمين لإلغاء الربط، مثل عنوان URL لإعدادات الحساب على منصتك. بدلاً من ذلك، يمكنك تضمين رابط يؤدي إلى حساب Google حيث يمكن للمستخدمين إدارة حساباتهم المرتبطة.

6. إمكانية تغيير حساب المستخدم: اقتراح طريقة للمستخدمين لتبديل حساباتهم. ويُعدّ ذلك مفيدًا بشكل خاص إذا كان المستخدمون يميلون إلى استخدام حسابات متعدّدة.

   • إذا كان على المستخدم إغلاق شاشة الموافقة لتبديل الحسابات، أرسِل خطأً قابلاً للاسترداد إلى Google حتى يتمكّن المستخدم من تسجيل الدخول إلى الحساب المطلوب باستخدام ربط OAuth ومسار الموافقة الضمنية.

7. أدرِج شعارك. عرض شعار شركتك على شاشة الموافقة استخدِم إرشادات الأنماط لوضع شعارك. إذا كنت ترغب أيضًا في عرض شعار Google، يمكنك الاطّلاع على الشعارات والعلامات التجارية.

الشكل 2. إرشادات تصميم شاشة الموافقة على ربط الحسابات

تنفيذ ميزة "قلب التطبيقات" في تطبيقاتك المحلية

لتنفيذ هذه الميزة، عليك تعديل رمز تفويض المستخدِم في تطبيقك لقبول رابط لصفحة معيّنة من Google.

لتفعيل ميزة "قلب التطبيق" في تطبيق Android، اتّبِع التعليمات الواردة في دليل التنفيذ على Android.

لإتاحة ميزة App Flip في تطبيق iOS، عليك اتّباع التعليمات الواردة في دليل تنفيذ نظام التشغيل iOS.

قلب التطبيق التجريبي

يمكن محاكاة ميزة "قلب التطبيق" باستخدام التطبيقات النموذجية والاختبارية قبل توفُّر تطبيقات مثبَّتة في قناة الإصدار العلني تم التحقّق منها وخادم OAuth 2.0 يعمل بشكل صحيح.

أثناء استخدام ميزة "قلب التطبيق"، سيفتح تطبيق Google تطبيقك أولاً، ثم يطلب استجابة رمز التفويض من خادم OAuth 2.0. وفي الخطوة الأخيرة، يتم إرسال الاستجابة إلى تطبيق Google.

المتطلبات الأساسية

لمحاكاة تطبيق Google وتحقيق هدف يؤدي إلى إطلاق تطبيقك، عليك تنزيل أداة اختبار قلب التطبيق وتثبيتها على أجهزة Android وiOS.

نزِّل نموذج App Flip Sample وثبتْه على Android و iOS لمحاكاة تطبيقك واختيار نوع استجابة OAuth 2.0.

تسلسل الاختبار

1. افتح "أداة اختبار ميزة "قلب التطبيق".
2. اضغط على Try Flip! لتشغيل تطبيق "نموذج تطبيق Flip".
3. اختَر ردًا من أزرار الاختيار في تطبيق Sample.
4. اضغط على Send لعرض استجابة OAuth 2.0 تحاكي الواقع إلى أداة الاختبار.
5. راجِع رسائل سجلّ "أداة الاختبار" بحثًا عن auth_code أو تفاصيل الخطأ.

اختبار الإصدار العلني

يمكن اختبار ميزة "قلب التطبيق" في قناة الإصدار العلني بعد إكمال عملية التسجيل وتنفيذ خادم OAuth 2.0.

ننصحك باستخدام حساب Google واحد وعنوان بريد إلكتروني خاص بالمهمة للقيام بالاختبار المبرمَج.

يمكن الاطّلاع على حالة ربط الحسابات باستخدام الحسابات المرتبطة عند تسجيل الدخول بصفتك مالك حساب Google. يمكن أيضًا إلغاء ربط الحسابات بين الاختبارات المتكررة من هنا.

يمكنك اختياريًا تنفيذ RISC لإلغاء الربط آليًا وإرسال إشعار إلى Google بذلك التغيير.