بعد تنفيذ OAuth 2.0، يمكنك اختياريًا ضبط App Flip المستند إلى OAuth، ما يسمح لمستخدمي 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.
- إنشاء عملية دمج من السحابة الإلكترونية إلى السحابة الإلكترونية: لإنشاء عملية دمج، اتّبِع التعليمات الواردة في مقالة إنشاء عملية دمج من السحابة الإلكترونية إلى السحابة الإلكترونية.
ضبط ميزة "قلب التطبيق" في "وحدة تحكّم المطوّر"
يوضّح القسم التالي كيفية ضبط ميزة "قلب التطبيق" في وحدة تحكّم المطوّر.
- املأ جميع الحقول ضمن معلومات عميل 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).
- انقر على الزر +.
- انقر على إعداد الجهاز.
- انقر على هل لديك أجهزة سبق وتمّ إعدادها؟
- اختَر عملية الدمج من السحابة الإلكترونية إلى السحابة الإلكترونية من قائمة مقدّمي الخدمات. سيتم إضافة البادئة “[test]” إلى القيمة في القائمة. عند اختيار عملية الدمج [test] من القائمة، من المفترض أن يفتح تطبيقك.
- تأكَّد من إطلاق تطبيقك وابدأ باختبار عملية التفويض.