قائمة التحقّق لمطوّري البرامج

تقدّم قائمة التحقّق هذه نظرة عامة على الخطوات المقترَحة لإطلاق تطبيقك بعد دمجه مع Google Health API.

1. قبل البدء

مراجعة مستندات المطوّرين: يمكنك التعرّف على أنواع البيانات ونطاقات ونقاط نهاية واجهة برمجة التطبيقات لتحديد العناصر المطلوبة لعملية الدمج.

مراجعة سياسات Google Health API: تأكَّد من أنّ حالة الاستخدام متوافقة مع أحكام وشروط المطوّرين في Google Health API و سياسة بيانات المطوّرين والمستخدمين في Google Health API.

التخطيط لتجربة المستخدم: إذا كنت بصدد نقل بيانات المستخدمين من Fitbit Web API، راجِع أفضل الممارسات الواردة في دليل نقل البيانات بشأن التعامل مع إعادة مصادقة المستخدمين.

‫2. إعداد عملية الدمج

إعداد Google Cloud: اتّبِع الخطوات الواردة في إعداد Google Cloud وOAuth لإنشاء مشروع على Google Cloud وتفعيل Google Health API وإعداد بيانات اعتماد OAuth 2.0. استخدِم مشاريع منفصلة لمرحلة العرض التجريبي ومرحلة الإنتاج حتى لا يؤثّر الاختبار في تطبيقك المنشور.

ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth: في Google Cloud Console، اضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth باستخدام معلومات تطبيقك وعلامته التجارية وروابط سياسة الخصوصية وبنود الخدمة الخاصة بتطبيقك.

إضافة نطاقات: في "وحدة تحكّم Google Cloud"، أضِف النطاقات المطلوبة لأنواع البيانات التي يحتاج تطبيقك إلى الوصول إليها. راجِع تنفيذ النطاق، مثل طلب النطاقات المطلوبة فقط، وضبط إذن الوصول للكتابة فقط عند إرسال البيانات، والتعامل مع الموافقة الجزئية بشكل سليم.

3- التطوير والاختبار

إجراء أول طلب بيانات من واجهة برمجة التطبيقات: إذا كنت جديدًا على Google Health API، اتّبِع الخطوات الواردة في Codelab لإجراء أول طلب بيانات من واجهة برمجة التطبيقات في غضون دقائق.

نقل البيانات من Fitbit Web API: إذا كنت تريد نقل البيانات من Fitbit Web API، راجِع دليل نقل البيانات واستخدِم أداة التكافؤ لمقارنة واجهات برمجة التطبيقات.

تنفيذ بروتوكول OAuth 2.0: نفِّذ عملية تفويض باستخدام بروتوكول OAuth 2.0 للحصول على موافقة المستخدمين ورموز API المميزة. استخدِم مكتبات العملاء لتبسيط عملية التنفيذ.

إضافة مستخدمين تجريبيين: أثناء وضع تطبيقك في "وضع الاختبار" على Google Cloud، أضِف مستخدمين تجريبيين لاختبار عملية الدمج مع الحسابات المدرَجة في القائمة المسموح بها.

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

التعامل مع الأخطاء: راجِع دليل تحديد المشاكل وحلّها للاطّلاع على الأخطاء الشائعة وكيفية التعامل معها.

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

4. الاستعداد للإطلاق

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

نقل البيانات من Fitbit Web API: في حال نقل البيانات، احرص على أن يكون سير عمل إعادة المصادقة لنقل بيانات المستخدمين سلسًا، وذلك باتّباع الاقتراحات الواردة في دليل نقل البيانات.

5- إطلاق العضويات والحفاظ على الأعضاء

نشر تطبيقك: بعد إكمال عملية التحقّق من OAuth، يمكنك نشر تطبيقك في "الإصدار العلني" في "وحدة تحكّم Google Cloud" لإزالة الحدّ الأقصى البالغ 100 مستخدم.

المراقبة: يمكنك مراقبة استخدام واجهة برمجة التطبيقات ومعدّلات الخطأ في "وحدة تحكّم Google Cloud".

البقاء على اطّلاع: يمكنك متابعة ملاحظات الإصدار لمعرفة التعديلات على واجهة برمجة التطبيقات وعمليات الإيقاف النهائي.