ال جوجل الصحة API هو الوريث الرسمي لـ Fitbit Web API. إنه يستهدف Google Health API v4 وينقل المطورين إلى Google OAuth 2.0. الآن تسمى أداة سطر أوامر CLI مفتوحة المصدر ghealth يلتف واجهة برمجة التطبيقات هذه للمحطات الطرفية ووكلاء الذكاء الاصطناعي.
الأداة عبارة عن برنامج Go ثنائي واحد بموجب ترخيص Apache 2.0. يعرض 40 نوعًا من البيانات التي تم التحقق منها على أنها JSON منظمة. يتيح لك هذا التصميم توجيه النوم ومعدل ضربات القلب ونقل البيانات إلى سياق الوكيل.
ما هي الصحة؟
ghealth عبارة عن غلاف فوق Google Health API v4. يمكنك بنائه من المصدر مع go build -o ghealth .. يتم شحنه كثنائي واحد قائم بذاته.
الأداة هي الوكيل أولاً بشكل صريح. يُرجع كل أمر JSON مبسطًا بشكل ثابت. كما يوفر رموز الخروج الحتمية، أ --dry-run العلم، و أ --raw علَم.
يقوم المستودع بشحن اثنين من مهارات الوكيل مثل SKILL.md ملفات. يغطي أحدهما المصادقة والإعداد والأعلام العالمية. ويوثق الآخر جميع أنواع البيانات والعمليات والأنماط والمشاكل الأربعين. وكلاء تثبيتها مع npx skills add.
يعيش CLI تحت Google-Health-API منظمة جيثب. تستضيف هذه المنظمة أيضًا مستودعات Fitbit مفتوحة المصدر طويلة الأمد.
سطح البيانات: 40 نوعًا تم التحقق منه
تغطي الأنواع الأربعون معظم إشارات Fitbit وPixel Watch. تشمل الأمثلة steps, heart-rate, sleep, weight, oxygen-saturation، و heart-rate-variability. الأنواع السريرية مثل electrocardiogram تتطلب ecg.readonly نِطَاق.
يدعم كل نوع مجموعة فرعية من العمليات. تلك الشائعة هي list, rollup, daily-rollup، و reconcile. أنواع قابلة للكتابة (exercise, sleep, weight, body-fat, height) يضيف create, update، و delete.
ال reconcile تقوم العملية بدمج نقاط البيانات المتداخلة من مصادر متعددة. وهذا يعكس الدفق المُصالح في واجهة برمجة التطبيقات v4.
النوم هو مثال جيد لتحليل الأنماط. الافتراضي list إرجاع ملخص. إضافة --detail إرجاع البيانات خطوة بخطوة (مستيقظ، عميق، حركة العين السريعة). يساعدك ذلك على اكتشاف الأنماط أسبوعًا بعد أسبوع.
الإعداد: ما يحدث بالفعل
يتم تشغيل الإعداد من خلال أمر واحد: ghealth setup. يرشدك المعالج خلال مشروع Google Cloud Platform وOAuth. يمكنك إنشاء عميل OAuth من نوع سطح المكتب في Google Cloud Console.
يمكنك إحضار بيانات اعتماد OAuth الخاصة بك. لا تحتوي الأداة على مفتاح مشترك. الملفات مكتوبة تحت ~/.config/ghealth/ مع وضع الملف 0600. يتم تحديث الرموز المميزة تلقائيًا.
يتم تصنيف جميع نطاقات Google Health API على أنها مقيدة. تتطلب Google مراجعة الخصوصية والأمان للوصول إلى الإنتاج. للاستخدام الشخصي، فإنك تأذن بمشروعك الخاص مقابل حسابك الخاص. تقوم واجهة برمجة التطبيقات (API) بإرجاع البيانات من Fitbit وPixel Watch ومصادر خارجية متصلة.
يستخدم التدفق مقطوع الرأس PKCE مع تحدي S256. كما أنه يتحقق من صحة عشوائي state المعلمة عند الانتهاء
التدريب العملي: الأوامر والإخراج
قراءة البيانات متسقة عبر الأنواع. تقوم كل قراءة بإرجاع كائن به صفوف أسفله dataPoints.
# Recent heart rate readings
ghealth data heart-rate list --from today --limit 10
# Daily step totals for a week
ghealth data steps daily-rollup --from 2026-03-22 --to 2026-03-29
# Sleep stages for the last five nights
ghealth data sleep list --limit 5 --detailتُرجع إجماليات الخطوات JSON المجمعة:
{
"dataPoints": [
{"date": "2026-03-28", "countSum": "9037"},
{"date": "2026-03-27", "countSum": "2408"}
]
}يتم تبسيط الإخراج بشكل افتراضي. يستخدم --raw لاستجابة API الأصلية. يستخدم --format csv أو --format table لأشكال أخرى. ال -o العلم يكتب ملفًا ويطبع معاينة المخطط.
ترقيم الصفحات بلا فقدان. كبير list يعود أ nextPageToken. يمكنك تمريره مرة أخرى مع --page-token لجلب الصفحة التالية.
استخدام الحالات مع الأمثلة
- تغذية أنماط النوم إلى وكيل: سحب عدة ليال مع
--detail. قم بتوجيه JSON إلى جلسة Claude Code أو Codex. اطلب من الوكيل تلخيص اتجاهات النوم العميق خلال الأسبوع. - تحميل التدريبات في الباندا: يجري
ghealth data exercise export-tcx --id <id> --output ride.csv --as csv. كل صف عبارة عن نقطة تتبع واحدة مع معدل ضربات القلب ونظام تحديد المواقع العالمي (GPS). ثم اركضpd.read_csvعلى الملف. - بناء عرض معدل ضربات القلب أثناء الراحة: استفسار
daily-resting-heart-rateأكثر من 30 يومًا. قم بإصدار ملف CSV مع--format csv. قم برسمها في دفتر ملاحظات أو لوحة معلومات.
كيف يقارن ghealth
الجدول أدناه يحدد ghealth مقابل API الخام واثنين من CLIs الآخرين. كلا مؤشري CLI الآخرين يعرفان أنفسهما على أنهما غير رسميين.
| يصف | ghealth (هذا CLI) | Google Health API v4 (REST المباشر) | rudrankriyam/Google-Health-CLI | جوجل هيلث-CLI (NPM) |
|---|---|---|---|---|
| ثَبَّتَ | git clone + go build |
لا أحد؛ اتصل بـ HTTP/gRPC بنفسك | البناء من مصدر Go | npm i -g googlehealth-cli |
| لغة | اذهب، ثنائي واحد | أي | يذهب | Node.js |
| مصادقة | عميل OAuth الخاص بك، PKCE S256 | جوجل أوث 2.0 | عميل OAuth الخاص بك | عميل OAuth الخاص بك |
| مخرج الوكيل | JSON المبسطة، رموز الخروج، SKILL.md |
خام JSON/gRPC | JSON يمكن التنبؤ به | مستقر --json ظرف |
| أنواع البيانات | تم التحقق من 40 مقابل واجهة برمجة التطبيقات المباشرة | سطح v4 كامل | المسارات الموثقة لسطح v4 | مجموعة فرعية من الأنواع |
| الوضع الرسمي | لا؛ المجتمع، في منظمة Google-Health-API | نعم؛ جوجل | لا؛ الدول غير رسمية | لا؛ الدول غير المنتسبة |
للتحكم الأولي، فإن واجهة REST API المباشرة هي الحقيقة الأساسية. للاستخدام الطرفي والوكيل، ghealth يقلل من المصادقة والتنسيق النموذجي.
الشرح التفاعلي
تحقق من الريبو. أيضا، لا تتردد في متابعتنا على تغريد ولا تنسى الانضمام إلينا 150 ألف + مل والاشتراك في النشرة الإخبارية لدينا. انتظر! هل أنت على برقية؟ الآن يمكنك الانضمام إلينا على التليجرام أيضًا.
هل تحتاج إلى الشراكة معنا للترويج لصفحة GitHub Repo أو صفحة الوجه المعانقة أو إصدار المنتج أو الندوة عبر الويب وما إلى ذلك؟ تواصل معنا
ميشال سوتر متخصص في علوم البيانات وحاصل على درجة الماجستير في علوم البيانات من جامعة بادوفا. بفضل أساس متين في التحليل الإحصائي والتعلم الآلي وهندسة البيانات، تتفوق ميشال في تحويل مجموعات البيانات المعقدة إلى رؤى قابلة للتنفيذ.
اكتشاف المزيد من كحيل | أخبار التقنية
اشترك للحصول على أحدث التدوينات المرسلة إلى بريدك الإلكتروني.
