تقليب التطبيقات

بعد تنفيذ بروتوكول OAuth 2.0، يمكنك اختياريًا ضبط App Flip المستنِد إلى المصادقة، ما يسمح للمستخدمين بربط حساباتهم في نظام المصادقة بحساباتهم على Google بسرعة أكبر. توضّح الأقسام التالية طريقة تصميم وتنفيذ App Flip لإجراء smart home.

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

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

المتطلّبات

  1. يجب أن يتوفّر لديك بيان تفويض من Google، مثلاً "بعد الربط، ستحصل Google على الإذن للتحكّم في أجهزتك".
  2. يجب الإشارة إلى أنّ حساب المستخدم مرتبط بحساب Google، وليس بمنتج معيّن من Google، مثل Google Home أو "مساعد Google".
  3. يجب إدراج عبارة واضحة تحث المستخدم على اتخاذ إجراء على شاشة طلب الموافقة واستخدام عبارة "الموافقة والربط" لإجراء الربط. ويرجع ذلك إلى أنّ المستخدمين يحتاجون إلى معرفة البيانات التي يجب عليهم مشاركتها مع Google لربط حساباتهم.
  4. وعليك أيضًا توفير طريقة تتيح للمستخدمين العودة أو إلغاء الاشتراك إذا اختاروا عدم الربط. استخدِم عبارة "إلغاء" لإجراء الإلغاء.
  5. يجب تنفيذ سير العمل هذا: بعد النقر على "الموافقة والربط"، عليك إثبات نجاح عملية الربط وإعادة توجيه المستخدم إلى تطبيق Google Home تلقائيًا. من المفترض أن يظهر الآن الجهاز المرتبط في تطبيق Google Home مع الإجراء الذي ستنفّذه. بعد النقر على "إلغاء"، يجب إعادة توجيه المستخدم إلى تطبيق Google Home.

اقتراحات

ننصحك بإجراء ما يلي:

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

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

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

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

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

يوضِّح هذا الشكل مثالاً لشاشة طلب موافقة تتضمّن وسائل شرح للمتطلبات الفردية
            والاقتراحات التي يجب اتّباعها عند
            تصميم شاشة طلب موافقة المستخدم.
الشكل 1: إرشادات تصميم شاشة الموافقة على ربط الحساب.

تم ضبط الإعدادات لـ App Flip المستندة إلى بروتوكول OAuth.

توضّح الأقسام التالية المتطلبات الأساسية لاستخدام App Flip المستند إلى بروتوكول OAuth وكيفية ضبط مشروع App Flip في وحدة تحكّم المهام.

إنشاء إجراء للمنزل المزوّد بأجهزة ذكية وإعداد خادم OAuth 2.0

قبل أن تتمكن من ضبط App Flip، عليك تنفيذ ما يلي:

ضبط App Flip في "وحدة تحكّم المهام"

يوضّح القسم التالي طريقة ضبط App Flip في وحدة تحكّم الإجراءات.

  1. املأ جميع الحقول ضمن معلومات عميل OAuth. (إذا لم يكن App Flip متوافقًا، يتم استخدام بروتوكول OAuth العادي كعنصر احتياطي.)
  2. ضمن استخدام تطبيقك لربط الحساب(اختياري)، ضَع علامة في المربّع تفعيل لنظام التشغيل iOS.
  3. املأ حقل الرابط العام. لمزيد من المعلومات حول الروابط العامة، يمكنك الاطّلاع على السماح للتطبيقات والمواقع الإلكترونية بالربط بالمحتوى الخاص بك.
  4. في حال كنت تريد ضبط برنامجك اختياريًا، أضِف نطاقات وانقر على إضافة نطاق ضمن إعداد برنامجك (اختياري).
  5. انقر على حفظ.

يمكنك الآن المتابعة إلى القسم التالي لتنفيذ App Flip في تطبيق iOS أو تطبيق Android.

تنفيذ App Flip في تطبيقاتك المحلية

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

اختبار App Flip على جهازك

بعد الانتهاء من إنشاء إجراء وضبط App Flip على وحدة التحكّم وفي التطبيق، يمكنك اختبار App Flip على جهازك الجوّال. يمكنك استخدام Google Assistant app أو Google Home app (GHA) لاختبار "App Flip".

لاختبار App Flip من Google Assistant app، اتّبِع الخطوات التالية:

  1. انتقِل إلى وحدة تحكُّم الإجراءات واختَر مشروعك.
  2. انقر على اختبار في شريط التنقّل بأعلى الصفحة.
  3. لتشغيل عملية ربط الحساب من تطبيق "Google Assistant":
    1. افتح Google Assistant app.
    2. انقر على الإعدادات.
    3. ضمن علامة التبويب Assistant، انقر على الإدارة الآلية للمنزل.
    4. انقر على إضافة(+).
    5. اختَر الإجراء الخاص بك من قائمة مقدّمي الخدمة. ستتم إضافة البادئة "[test]" في القائمة. عند اختيار الإجراء [test] من القائمة، من المفترض أن يتم فتح تطبيقك.
    6. تأكّد من إطلاق تطبيقك وابدأ في اختبار تدفق التفويض.

لاختبار App Flip من تطبيق Google Home، اتّبِع الخطوات التالية:

  1. انتقِل إلى وحدة تحكُّم الإجراءات واختَر مشروعك.
  2. انقر على اختبار في شريط التنقّل بأعلى الصفحة.
  3. لتشغيل عملية ربط الحساب من تطبيق "Home":
    1. افتح Google Home app (GHA).
    2. النقر على الزر +
    3. انقر على إعداد جهاز.
    4. انقر على هل لديك جهاز تم إعداده من قبل؟
    5. اختَر إجراء smart home من قائمة مقدّمي الخدمة. ستتم إضافة البادئة "[test]" في القائمة. عند اختيار الإجراء [test] من القائمة، من المفترض أن يتم فتح تطبيقك.
    6. تأكّد من إطلاق تطبيقك وابدأ في اختبار تدفق التفويض.