بعد إعداد عملية تنفيذ OAuth 2.0، يمكنك اختياريًا ضبط ميزة "التبديل إلى التطبيق" المستندة إلى OAuth App Flip، ما يسمح لمستخدمي Android بربط حساباتهم في نظام المصادقة الخاص بك بحساباتهم على Google بسرعة أكبر. توضّح الأقسام التالية كيفية تصميم ميزة App Flip وتنفيذها لعملية الدمج Cloud-to-cloud.
إرشادات التصميم
يوضّح هذا القسم متطلبات التصميم واقتراحات بشأن شاشة الموافقة على ربط الحساب في App Flip. بعد أن يتصل Google بتطبيقك، يعرض تطبيقك شاشة الموافقة للمستخدم.
المتطلبات
- يجب أن يتضمّن التطبيق بيانًا بشأن تخويل Google، مثل "بعد الربط، سيصبح بإمكان Google التحكّم في أجهزتك".
- عليك توضيح أنّه سيتم ربط حساب المستخدم بحساب على Google، وليس بمنتج معيّن من Google، مثل Google Home أو "مساعد Google".
- يجب تضمين عبارة واضحة تحثّ المستخدم على اتّخاذ إجراء في شاشة الموافقة، واستخدام عبارة "الموافقة والربط" لإجراء الربط. ويرجع ذلك إلى أنّ المستخدمين بحاجة إلى معرفة البيانات التي يُطلب منهم مشاركتها مع Google لربط حساباتهم.
- يجب توفير طريقة للمستخدمين تتيح لهم الرجوع أو الرفض أو الإلغاء إذا اختاروا عدم الربط. استخدِم كلمة "إلغاء" للإشارة إلى إجراء الإلغاء.
- يجب تنفيذ سير العمل التالي: بعد النقر على "الموافقة والربط"، يجب عرض رسالة تفيد بنجاح عملية الربط وإعادة توجيه المستخدم تلقائيًا إلى تطبيق Google Home. من المفترض أن يظهر للمستخدم الآن الجهاز المرتبط في تطبيق Google Home مع الإجراء الذي اتّخذته. بعد النقر على "إلغاء"، عليك إعادة توجيه المستخدم إلى تطبيق Google Home.
الاقتراحات
ننصحك باتّخاذ الإجراءات التالية:
عرض سياسة خصوصية Google تضمين رابط يؤدي إلى سياسة خصوصية Google في شاشة طلب الموافقة
البيانات التي ستتم مشاركتها استخدِم لغة واضحة وموجزة لتوضيح البيانات التي تطلبها Google من المستخدمين وسبب طلبها.
إمكانية إلغاء الربط: توفير آلية للمستخدمين لإلغاء الربط، مثل عنوان URL يؤدي إلى إعدادات حساباتهم على منصتك بدلاً من ذلك، يمكنك تضمين رابط يؤدي إلى حساب Google حيث يمكن للمستخدمين إدارة حساباتهم المرتبطة.
إمكانية تغيير حساب المستخدم اقترِح طريقة تتيح للمستخدمين التبديل بين حساباتهم. ويكون ذلك مفيدًا بشكل خاص إذا كان المستخدمون يميلون إلى امتلاك حسابات متعدّدة.
- إذا كان على المستخدم إغلاق شاشة الموافقة للتبديل بين الحسابات، أرسِل خطأ قابلاً للاسترداد إلى Google ليتمكّن المستخدم من تسجيل الدخول إلى الحساب المطلوب باستخدام ربط الحسابات عبر OAuth ومسار الربط الضمني.
تضمين شعارك: عرض شعار شركتك على شاشة الموافقة استخدِم إرشادات الأسلوب لتحديد موضع شعارك. إذا كنت تريد عرض شعار Google أيضًا، يُرجى الاطّلاع على الشعارات والعلامات التجارية.
إعداد ميزة App Flip المستندة إلى OAuth
توضّح الأقسام التالية المتطلبات الأساسية لميزة "التبديل إلى التطبيق" المستندة إلى OAuth وكيفية ضبط مشروع "التبديل إلى التطبيق" في Google Home Developer Console.
إنشاء عملية دمج من السحابة الإلكترونية إلى السحابة الإلكترونية وإعداد خادم OAuth 2.0
قبل أن تتمكّن من ضبط App Flip، عليك تنفيذ ما يلي:
- إعداد خادم OAuth 2.0 : لمزيد من المعلومات حول إعداد خادم OAuth ، يُرجى الاطّلاع على مقالة تنفيذ خادم OAuth 2.0.
- إنشاء عملية دمج من السحابة الإلكترونية إلى السحابة الإلكترونية : لإنشاء عملية دمج، اتّبِع التعليمات الواردة في مقالة إنشاء عملية دمج من السحابة الإلكترونية إلى السحابة الإلكترونية.
ضبط ميزة "التبديل إلى التطبيق" في Developer Console
يوضّح القسم التالي كيفية ضبط ميزة "التبديل إلى التطبيق" في Developer Console.
- املأ جميع الحقول ضمن معلومات عميل OAuth. (إذا لم تكن ميزة App Flip متاحة، يتم استخدام بروتوكول OAuth العادي كحل بديل).
- ضمن استخدام تطبيقك لربط الحساب(اختياري)، ضَع علامة في المربّع تفعيل لنظام التشغيل iOS.
- املأ حقل الرابط العام. لمزيد من المعلومات عن الروابط العامة، يُرجى الاطّلاع على مقالة السماح للتطبيقات والمواقع الإلكترونية بالربط بمحتواك.
- إذا أردت ضبط عميلك بشكل اختياري، أضِف النطاقات وانقر على إضافة نطاق ضمن ضبط عميلك (اختياري).
- انقر على حفظ.
يمكنك الآن الانتقال إلى القسم التالي لتنفيذ App Flip في تطبيق iOS أو Android.
تنفيذ App Flip في تطبيقاتك الأصلية
لتنفيذ App Flip، عليك تعديل رمز تفويض المستخدم في تطبيقك لقبول رابط لصفحة معيّنة من Google.
اختبار App Flip على جهازك
بعد إنشاء عملية دمج من السحابة الإلكترونية إلى السحابة الإلكترونية وضبط ميزة "التبديل إلى التطبيق" على وحدة التحكّم و في تطبيقك، يمكنك اختبار ميزة "التبديل إلى التطبيق" على جهازك الجوّال. يمكنك استخدام تطبيق Google Home لاختبار ميزة "التبديل إلى التطبيق" .
لاختبار App Flip من تطبيق Google Home، اتّبِع الخطوات التالية:
- انتقِل إلى Developer Console واختَر مشروعك.
- انتقِل إلى من السحابة الإلكترونية إلى السحابة الإلكترونية > اختبار.
- ابدأ مسار ربط الحساب من تطبيق Home:
- افتح الـ Google Home app (GHA).
- انقر على الزر +.
- انقر على إعداد جهاز.
- انقر على هل لديك أجهزة سبق وتمّ إعدادها؟
- اختَر عملية الدمج من السحابة الإلكترونية إلى السحابة الإلكترونية من قائمة مقدّمي الخدمات. ستسبقها العبارة " " "[اختبار]" في القائمة. عند اختيار عملية الدمج [اختبار] من القائمة، من المفترض أن يتم فتح تطبيقك.
- تأكَّد من تشغيل تطبيقك وابدأ اختبار مسار التفويض.