البدء

مرحبًا بك في Google Health API!

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

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

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

  • التوافق مع التغييرات المستقبلية

    • قابلية التوسّع: تم تصميم واجهة برمجة التطبيقات الجديدة لتكون قابلة للتوسّع من أجل تلبية الطلبات المستقبلية، وهي تتيح استيعاب عدد متزايد من المستخدمين وأنواع البيانات.
    • سهولة الصيانة: يسهّل اتّباع أسلوب موحّد صيانة التطبيقات وتحديثها، ما يقلّل من المشاكل الفنية.
    • الوصول إلى الميزات الجديدة: يتيح نقل البيانات إلى واجهة برمجة التطبيقات الجديدة الوصول إلى الميزات والوظائف الجديدة فور إطلاقها، ما يضمن بقاء التطبيقات محدّثة والاستفادة من أحدث التحسينات.
    • الامتثال: يتم تحديث واجهة برمجة التطبيقات الجديدة باستمرار لتتوافق مع أحدث معايير الأمان والخصوصية في Google، ما يقلّل من الجهد المطلوب للحفاظ على امتثال التطبيقات.
    • خصوصية البيانات: تم تصميم نظام Google OAuth للامتثال للعديد من لوائح خصوصية البيانات (مثل اللائحة العامة لحماية البيانات وقانون نقل التأمين الصحي والمسؤولية)، ما يسهّل على المطوّرين عملية الامتثال.

كيف أبدأ في إنشاء الإعلان؟

قبل البدء في عملية التطوير، يُرجى الاطّلاع على قائمة التحقّق الخاصة بالمطوّرين التي تتضمّن قائمة بالخطوات التي تساعدك في إطلاق عملية الدمج مع Google Health API.

تعتمد طريقة البدء أيضًا على نوع المطوِّر.

مطوّر جديد

إذا لم تكن لديك خبرة في استخدام Google APIs أو Google Cloud، أو كنت بحاجة إلى تذكير، فإنّ أسهل وأسرع طريقة للبدء هي الانتقال إلى إحدى ورشات الترميز. نقدّم دروسًا تطبيقية حول REST باستخدام Visual Studio Code أو أداة OAuth 2.0 Playground، بالإضافة إلى درس تطبيقي حول Python خاص بـ gRPC يمكنك من خلاله التعرّف على كيفية استرداد نماذج التعليمات البرمجية للعميل وتجميع تعريفات مخازن البروتوكولات المؤقتة.

REST Codelab (في VS Code) REST Codelab (في OAuth 2.0 Playground) gRPC Codelab (في Python)

مطوّر Fitbit

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

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

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

قراءة "دليل نقل البيانات" إكمال عملية إعداد Google Cloud

اختيار بروتوكول

تتوافق Google Health API مع بروتوكولَي REST وRPC لتزويد المطوّرين بأساس قابل للتطوير وعالي الأداء لدمج بيانات الصحة.

REST

‫REST هو أسلوب لتصميم واجهات برمجة التطبيقات يستند إلى مفاهيم الويب العادية وتنسيقات يمكن للمستخدم قراءتها، مثل JSON. وهي مناسبة بشكل خاص لإنشاء واجهات برمجة تطبيقات عامة وتطبيقات ويب لأنّها متوافقة مع المتصفحات وتتوفّر على نطاق واسع. وتكمن نقطة قوته الأساسية في بساطته وسهولة استخدامه من قِبل المطوّرين الخارجيين.

gRPC

‫RPC هو نظام عالي الأداء يستخدم تنسيقًا ثنائيًا مضغوطًا يُعرف باسم "مخازن البروتوكولات المؤقتة" لتسهيل التواصل بين الأجهزة. وهو مثالي للخدمات المصغّرة الداخلية، والتواصل بين الأجهزة الجوّالة والخادم الخلفي، والتحديثات في الوقت الفعلي، وذلك بفضل كفاءته وتوافقه مع الميزات المتقدّمة، مثل البث. يُعدّ RPC الخيار المفضّل في سيناريوهات الأداء العالي أو عند الحاجة إلى عقود واجهة صارمة.

لمزيد من المعلومات، يُرجى الاطّلاع على gRPC مقابل REST: فهم gRPC وOpenAPI وREST ومتى يتم استخدامها في تصميم واجهات برمجة التطبيقات.

الدعم الذكي وأدوات المطوّرين

يمكنك استخدام Gemini، وهو مساعد الذكاء الاصطناعي من Google، وأدوات المطوّرين المضمّنة في هذا الموقع الإلكتروني لتسريع عملية استخدام Google Health API. أثناء التصفّح، استخدِم ميزة "الدردشة مع Gemini" و"شرح الرمز البرمجي" في لوحة المعلومات لتلخيص الأدلة المعقّدة، توضيح أنواع البيانات ونطاقاتها، أو تعديل نماذج الرموز البرمجية لتناسب لغتك. يمكنك أيضًا اختبار الطلبات المباشرة في "مستكشف واجهات برمجة التطبيقات" واستخدام ردود JSON كسياق للطلب من أجل إنشاء منطق التحليل.

إذا كنت تستخدم أدوات مستندة إلى الذكاء الاصطناعي، مثل Antigravity أو Cursor أو Claude Code أو وكلاء مخصّصين، يمكنك تصدير أي صفحة بتنسيق Markdown أو دمج خادم Developer Knowledge MCP لمنح بيئتك إذن الوصول المباشر إلى مستندات Google Health API. استخدِم مسارات العمل هذه لإنشاء رمز برمجي للعميل أو تحديد المشاكل وحلّها. لمزيد من المعلومات، يُرجى الاطّلاع على المساعدة المستندة إلى الذكاء الاصطناعي وأدوات المطوّرين.

الموارد

بالإضافة إلى معلومات البدء، يوفّر هذا الموقع الإلكتروني موارد شاملة للمساعدة في عمليات التطوير ونقل البيانات.

  • الدعم: هل أنت بحاجة إلى مساعدة؟ يمكنك الوصول إلى منتديات Google Workspace وأداة تتبُّع المشاكل العامة على صفحة الدعم.
  • أداة التكافؤ بين واجهتَي Google Health API وFitbit Web API: استخدِم هذه الأداة لمقارنة نقاط النهاية والوظائف بين واجهتَي Fitbit Web API وGoogle Health API. يتضمّن أيضًا ملف سياق يمكنك استخدامه مباشرةً مع نموذج لغوي كبير، أو كجزء من ملف Agents.md في أداة الذكاء الاصطناعي المفضّلة لديك.
  • مرجع واجهة برمجة التطبيقات: مستندات مرجعية كاملة حول REST