نظرة عامة

‫Google Health API هي واجهة برمجة تطبيقات جديدة تم إنشاؤها من البداية وتتيح للمطوّرين البحث عن بيانات مستخدمي Fitbit. هذا ليس مجرد تحديث، بل هو خطوة استراتيجية لضمان أمان تطبيقاتك وموثوقيتها وجاهزيتها للتطوّرات المستقبلية في التكنولوجيا الصحية. تتيح واجهة برمجة التطبيقات وحدة تحكّم جديدة لتسجيل تطبيقاتك، وتتوافق مع بروتوكول Google OAuth 2.0، وتوفّر أنواع بيانات جديدة ومخططًا جديدًا لنقطة النهاية وتنسيقًا جديدًا للردود.

تم تصميم الدليل لمساعدة المطوّرين في نقل تطبيقاتهم الحالية التي تستخدم Fitbit Web API إلى Google Health API الجديدة.

لماذا يجب نقل البيانات؟

في ما يلي مزايا استخدام Google Health API:

• الأمان المحسَّن: الامتثال لأفضل ممارسات الأمان في Google، بما يتوافق مع معايير الأمان والخصوصية والهوية في Google
• التطابق: يزيل هذا الإصدار عدم التطابق القديم في تنسيقات البيانات والمناطق الزمنية ووحدات القياس ومعالجة الأخطاء، ما يوفّر تجربة أكثر سلاسة للمطوّرين.
• قابلية التوسّع ومواكبة التغييرات المستقبلية: تم تصميمها لتتوسّع بما يتناسب مع المتطلبات المستقبلية، وتتوافق مع البروتوكولات الحديثة مثل gRPC.

نقل المستخدمين

إنّ نقل البيانات من Fitbit Web API إلى Google Health API ليس مجرّد تحديث فني. على المستخدمين إعادة تقديم موافقتهم على عملية الدمج الجديدة بسبب تغيير مكتبة OAuth. لا يمكن نقل رموز الدخول ورموز إعادة التحميل إلى Google Health API واستخدامها. للمساعدة في الحفاظ على المستخدمين أثناء عملية نقل البيانات، إليك بعض الاقتراحات الفنية والاستراتيجية لضمان نجاح عملية نقل البيانات.

استراتيجية المكتبة المزدوجة

بما أنّ Fitbit Web API وGoogle Health API يستخدمان مكتبات مختلفة من OAuth2، عليك إدارة فترة "ربط" تتضمّن المكتبتَين في قاعدة الرموز البرمجية.

إدارة التفويض المتزامن

• تغليف العملاء: أنشئ طبقة تجريد أو واجهة لـ "خدمة الصحة". يتيح ذلك لبقية تطبيقك طلب البيانات بدون معرفة المكتبة النشطة (بروتوكول OAuth من Fitbit أو بروتوكول OAuth من Google) لهذا المستخدم المحدّد.
• تعديل مخطط قاعدة البيانات: عدِّل جدول المستخدمين ليشمل علامة oauth_type. على سبيل المثال، استخدِم fitbit لبروتوكول OAuth من Fitbit وgoogle لبروتوكول OAuth من Google.
  • المستخدمون الجدد: يتم تلقائيًا استخدام Google Health API ومكتبة Google OAuth. اضبط oauth_type على google.
  • المستخدمون الحاليون: سيتم الاحتفاظ بهم على Fitbit Web API إلى أن يكملوا عملية إعادة الموافقة. اضبط oauth_type على fitbit.

مسار إعادة الحصول على الموافقة "Step-Up"

بدلاً من فرض تسجيل الخروج، استخدِم أسلوب التفويض المتزايد:

1. رصد الرمز المميز المفتوح المصدر في Fitbit: عندما يفتح مستخدم Fitbit Web API التطبيق، يتم إرسال إشعار "تحديث الخدمة".
2. بدء عملية Google OAuth: عندما ينقر المستخدم على "تعديل"، ابدأ عملية مكتبة OAuth2 من Google.
3. الاستبدال والإبطال: بعد تلقّي رمز Google OAuth المميّز بنجاح، احفظه في الملف الشخصي للمستخدم، وعدِّل oauth_type من fitbit إلى google، ثم أبطل (إذا أمكن) رمز fitbit القديم آليًا للحفاظ على أمان الملف الشخصي للمستخدم.

زيادة معدّل الاحتفاظ بالمستخدمين إلى أقصى حد

تُعد إعادة الحصول على الموافقة "منطقة الخطر" بالنسبة إلى معدّل التوقّف عن استخدام الخدمة. لمنع المستخدمين من التوقّف عن استخدام التطبيق، اتّبِع أفضل ممارسات تجربة المستخدم التالية:

التواصل الذي يركّز على القيمة

لا تبدأ رسالتك بعبارة "عدّلنا واجهة برمجة التطبيقات". إليك المزايا الرئيسية للنظام الجديد الذي تدعمه Google:

• الأمان المحسّن: أدرِج إشارة إلى ميزة حماية الحساب الرائدة في المجال من Google وميزة المصادقة الثنائية.
• الموثوقية: أوقات مزامنة أسرع واتصالات بيانات أكثر استقرارًا
• حظر الميزات: إبلاغ المستخدمين بلطف بأنّ الميزات الجديدة وأنواع البيانات تتطلّب التحديث.

التوقيت الذكي

• عدم مقاطعة المهام المهمة: لا تعرض أبدًا شاشة طلب الموافقة أثناء ممارسة المستخدم للتمرين أو تسجيل الوجبات.
• مرحلة "التذكير": خلال أول 30 يومًا، استخدِم بانر يمكن إغلاقه.
• مرحلة "الإيقاف النهائي": لن يصبح الحصول على الموافقة مجددًا إلزاميًا إلا بعد عدة أسابيع من التحذيرات، وذلك بالتزامن مع المواعيد النهائية الرسمية لإيقاف واجهة Fitbit Web API نهائيًا.

مقارنة مسار النقل

يساعد التمييز المرئي الواضح بين المسارين القديم والجديد المطوّرين على فهم موضع تفرّع المنطق.

الميزة	Fitbit Web API (الإصدار القديم)	Google Health API (Google-Identity)
مكتبة المصادقة	البرامج المفتوحة المصدر العادية	خدمات Google Identity Services (GIS) / Google Auth
حسابات المستخدمين	بيانات اعتماد Fitbit القديمة	حساب Google
نوع الرمز المميز	الوصول إلى بيانات Fitbit وتحديثها	رموز الدخول/إعادة التحميل الصادرة عن Google
إدارة النطاق	الأذونات الواسعة	أذونات دقيقة / تدريجية

التعامل مع الفروق الدقيقة في عملية نقل الحساب

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

• التحقّق من صلاحية الرمز المميّز: استخدِم backgroundworker للتحقّق مما إذا كانت الرموز المميّزة الخاصة بـ Fitbit تتسبّب في ظهور أخطاء "غير مصرّح به". قد يشير ذلك إلى أنّ المستخدم نقل بيانات حسابه ولكن تطبيقك لم يلحق بذلك.
• التعامل السلس مع الأخطاء: في حال تعذُّر تنفيذ طلب Fitbit OAuth، عليك إعادة توجيه المستخدم إلى صفحة مخصّصة بعنوان "إعادة ربط حساب Fitbit" تستخدم تحديدًا مسار Google OAuth الجديد.