نظرة عامة

‫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، عليك إدارة فترة "الربط" التي تتضمّن كلتا المكتبتَين في قاعدة الرموز البرمجية.

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

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

عملية إعادة منح الإذن "التصاعدية"

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

1. رصد رمز Fitbit المميّز المفتوح المصدر: عندما يفتح مستخدم Fitbit Web API التطبيق، فعِّل إشعار "تحديث الخدمة".
2. بدء عملية Google OAuth: عندما ينقر المستخدم على "تحديث"، ابدأ عملية مكتبة Google OAuth2.
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 اتصالاتهم بالجهات الخارجية على الفور، ولكن تغيير إصدار واجهة برمجة التطبيقات هو شرط من جانب المطوّر.

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