تم تحسين وتحديث Fitbit Web API لتوفير أساس أكثر توحيدًا واتساقًا وقابلية للتوسّع لعمليات الدمج التي يجريها المطوّرون، وأصبح اسمها الآن Google Health API. تمثّل واجهة Google Health API التطوّر الاستراتيجي لواجهة Fitbit Web API القديمة، وقد تمت إعادة إنشائها بالكامل على بنية Google الأساسية الحديثة.
تتيح هذه المنصة للمطوّرين الاستفادة من الإمكانات الكاملة لأدوات المطوّرين في Google Cloud، وتوفّر للمستخدمين طريقة مألوفة ومبسّطة لإدارة أذوناتهم من خلال Google OAuth 2.0.
ما هي مزايا Google Health API؟
- مصدر موحّد للمعلومات: يتولّى "مصدر البيانات المُطابَقة" الجديد المهمة المعقّدة المتمثّلة في مطابقة نقاط البيانات المتداخلة من مصادر متعددة. يضمن ذلك أن تعرض التطبيقات البيانات المتسقة نفسها التي يراها المستخدمون في تطبيق Fitbit. سيتم توفير هذا التدفق بالإضافة إلى تدفق الطرف الأول الذي يتضمن بيانات من أجهزة Fitbit وPixel، بالإضافة إلى الإدخالات اليدوية.
- التحديث الفني والأداء: لقد دمجنا أكثر من 100 نقطة نهاية قديمة في مجموعة مبسّطة من حِزم أنواع البيانات، وأزلنا التناقضات في تنسيقات البيانات والمناطق الزمنية ووحدات القياس ومعالجة الأخطاء. بالإضافة إلى ذلك، أصبحنا نتيح الآن استخدام بروتوكول HTTP/REST لاسترداد البيانات العالية الأداء. بالإضافة إلى ذلك، أصبحت البيانات خلال اليوم وخطافات الويب متاحة الآن لجميع أنواع البيانات ذات الصلة من خلال نقطة نهاية مخصّصة للقائمة.
- تحسين الويب هوك وقابلية التوسّع: يمكنك الاستفادة من الدعم الموسّع للويب هوك، بما في ذلك الاشتراكات التلقائية والإدارة التفصيلية لجميع أنواع البيانات ذات الصلة، والمصمّمة للتوسّع مع الجيل التالي من التطبيقات الصحية المستندة إلى الذكاء الاصطناعي.
- الهوية والأمان المبسّطان: استبدال رمز التفويض القديم في Fitbit (FOT) ببروتوكول Google OAuth 2.0. يتيح ذلك للمطوّرين استخدام مكتبات المصادقة العادية من Google، ما يسهّل قواعد الرموز البرمجية ويوفّر للمستخدمين طريقة مألوفة ومركزية لإدارة أذوناتهم. يتم تصنيف جميع نطاقات Google Health API على أنّها محدودة، ما يتطلّب إجراء مراجعة للخصوصية والأمان من أجل الوصول إليها.
هل تُعجبك هذه الاقتراحات؟ البدء الآن
إصدارات واجهة برمجة التطبيقات والقناة التجريبية المتاحة للجميع
تستخدم Google Health API الإصدارات المستندة إلى القنوات وفقًا لمقترحات تحسين واجهة برمجة التطبيقات (AIP) من Google، وتحديدًا AIP-185: إصدار واجهة برمجة التطبيقات وAIP-181: مستويات الثبات. تتوفّر واجهة برمجة التطبيقات
عبر قناتَين علنيتَين: قناة v4 الثابتة والقناة التجريبية
v4beta المتاحة للجميع. توفّر Google الدعم لكلتا القناتَين من خلال قنوات الدعم العادية.
مقارنة بين القناة الثابتة والقناة التجريبية
وفقًا لـ AIP-185، تعمل قناة v4beta كمجموعة شاملة من قناة v4 الثابتة. وتتضمّن جميع وظائف v4 الثابتة، بالإضافة إلى أنواع البيانات والحقول والطُرق التي يمكن استخدامها قبل إطلاقها والتي تخضع لاختبارات الشركاء.
في المستندات، تظهر علامة التصنيف v4beta على عناصر واجهة برمجة التطبيقات التي لا تتوفّر إلا في القناة التجريبية.
| الميزة | القناة الثابتة (v4) |
القناة التجريبية المتاحة للجميع (v4beta) |
|---|---|---|
| عنوان URI الأساسي لـ REST | https://health.googleapis.com/v4 |
https://health.googleapis.com/v4beta |
| حزمة gRPC | google.devicesandservices.health.v4 |
google.devicesandservices.health.v4beta |
| المستندات المرجعية | الإصدار 4 من REST والإصدار 4 من RPC | v4beta REST وv4beta RPC |
| مستوى الثبات | جاهزة للإنتاج وتخضع لقواعد التوافق مع الأنظمة القديمة AIP-180. | هذه نسخة معاينة غير مستقرة قد تخضع لتغييرات غير متوافقة أو قد تتم إزالتها في أي وقت بدون إشعار. |
| الغرض من الاستخدام | تطبيقات الإنتاج المباشرة الموجّهة للمستخدمين | الاختبار المبكر، وإنشاء النماذج الأولية، والتحقّق من صحة المخطط، وملاحظات المطوّرين. |
| الدعم | تتوفّر من خلال قنوات الدعم العادية. | تتوفّر من خلال قنوات الدعم العادية لتقارير الأخطاء وتحديد المشاكل وحلّها والملاحظات حول التصميم. |
كيفية التعامل مع قناة v4beta
عند استكشاف الإمكانات التي تم وضع علامة v4beta عليها، اتّبِع الإرشادات التالية:
- استخدِم
v4betaبشكل أساسي في بيئات التطوير والتقييم والاختبار غير الإنتاجية. لا ننصح بإطلاق ميزات إنتاجية تعتمد على نقاط نهايةv4betaأو أنواع بيانات تجريبية فقط. - يُرجى توقُّع تغيير المخططات وأسماء الحقول وسلوكيات نقاط النهاية وتمثيلات البيانات في
v4betaبدون سابق إنذار. ويمكن أيضًا إزالة الميزات وأنواع البيانات التجريبية بالكامل إذا لم تستوفِ أهداف التحقّق من الصحة. - اعزل الرمز البرمجي التجريبي لبرنامج
v4betaعن علامات الميزات أو الوحدات المنفصلة، وذلك لكي لا تؤدي التغييرات التي قد تؤدي إلى عطل في القناة التجريبية إلى تعطيل عملية دمجv4الأساسية. - يمكنك الحصول على الدعم والإبلاغ عن المشاكل ومشاركة الملاحظات حول عملية تنفيذ
v4betaمن خلال قنوات الدعم العادية للمساعدة في تشكيل التصميم النهائي لواجهة برمجة التطبيقات.
الترقية من الإصدار التجريبي v4 إلى الإصدار الثابت v4
تتم إضافة أنواع بيانات وميزات جديدة إلى v4beta لإتاحة اختبار الشركاء والتحقّق من السوق قبل الانتقال إلى القناة الثابتة v4.
تقيّم Google الميزات التجريبية وفقًا للمعايير التالية قبل ترقيتها إلى v4:
- يؤكّد اختبار الشركاء أنّ نموذج البيانات ودلالات الحقول وأنماط الطلبات تستوفي متطلبات التطبيق الواقعية.
- اكتملت مراجعات التصميم وملاحظات المطوّرين، وأصبح المخطّط جاهزًا للقفل بموجب ضمانات التوافق مع الأنظمة القديمة في AIP-180.
- تستوفي مسارات البيانات الشاملة ومزامنة الأجهزة وموثوقية الخدمة معايير جودة الإنتاج.
- وفقًا لقواعد الإيقاف النهائي في AIP-185، تتم إزالة أي حقول أو سلوكيات تم إيقافها نهائيًا أثناء الاستخدام التجريبي بدلاً من ترقيتها إلى
v4.
على الرغم من أنّ AIP-181
يوفّر قاعدة عامة تقريبية تبلغ 90 يومًا لتقييم الإصدار التجريبي، فإنّ
التوقيت الفعلي لترقية ميزة من v4beta إلى v4 يعتمد على مدى تعقيد الميزة
وتوفّر الأجهزة وملاحظات التحقّق. قد يتم طرح بعض الميزات في وقت أقرب، بينما قد يظل بعضها الآخر في "v4beta" لفترة أطول أو يتم إيقافه نهائيًا.
عند ترقية نوع بيانات أو ميزة إلى قناة v4 الثابتة، تعلن Google عن الترقية في ملاحظات الإصدار. عندئذٍ، عليك تعديل طلباتك من https://health.googleapis.com/v4beta إلى https://health.googleapis.com/v4 قبل إتاحة عملية الدمج لمستخدمي الإصدار العلني.
ماذا عن Fitbit Web API؟
تم إيقاف الإصدار القديم من Fitbit Web API نهائيًا وفقًا للمخطط الزمني التالي:
- 30 سبتمبر 2026 (تاريخ إيقاف الدعم): تم إيقاف دعم Fitbit Web API، وتوقّفت Google عن إصلاح الأخطاء أو تقديم الدعم لواجهة برمجة التطبيقات.
- 2 نوفمبر 2026 (إيقاف واجهة برمجة التطبيقات): تم إيقاف Fitbit Web API ونقاط نهاية Fitbit OAuth، ولم تعُد تعمل أو تتم مزامنة البيانات من مستخدمي Google Health أو إليهم. ستتعذّر الطلبات المُرسَلة إلى نقاط النهاية هذه وستعرض رمز حالة HTTP
410 Gone.
على المطوّرين الذين يستخدمون الإصدار القديم من Fitbit Web API وFitbit Authorization نقل تطبيقاتهم ومستخدميهم إلى Google Health API وGoogle OAuth 2.0.
يُرجى الاطّلاع على دليل نقل البيانات للبدء.
ما الأجهزة المتوافقة؟
ستجمع جميع أجهزة Fitbit وساعات Google Pixel Watch، الحالية والسابقة، البيانات التي يتم عرضها من خلال Google Health API. ويعتمد نوع البيانات المتاحة على الوظائف التي تتيحها الأجهزة.
يمكن العثور على قائمة الأجهزة الحالية على Google Store.
كيف يمكنني تقديم الملاحظات؟
نحن نقدّر ملاحظاتك كثيرًا. نشجّعك على مشاركة أفكارك من خلال قنوات الدعم المدرَجة في صفحة الدعم.
على الرغم من أنّنا بذلنا قصارى جهدنا لضمان أن توفّر واجهات برمجة التطبيقات هذه الدعم اللازم لك، فإنّ واجهة برمجة التطبيقات Google Health API تتطوّر باستمرار. يُرجى العِلم أنّه استنادًا إلى ملاحظاتك، قد نُجري تغييرات من الآن وحتى نهاية شهر مايو، ما يتطلّب منك إجراء تعديلات مماثلة.
خريطة الطريق
في ما يلي قائمة بالميزات التي ستتوفّر في عام 2026.
الربع الرابع من 2026
أنواع البيانات (القراءة والكتابة)
- بيانات دقيقة عن درجة حرارة الجلد
- معدّل الأيض الأساسي
- سنضيف أنواع بيانات لتحقيق التكافؤ مع Health Connect. ومن المتوقّع إضافة المزيد من أنواع بيانات Health Connect في الربع الرابع من عام 2026 والربع الأول من عام 2027.
الميزات
- قناة تجريبية متاحة للجميع لاستخدام أنواع البيانات الجديدة قبل إطلاقها
- نقطة نهاية الإحصاءات لمراقبة بيانات القياس عن بُعد لخطافات الويب