שיפרנו ועדכנו את 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 נקודות קצה (endpoint) מדור קודם לקבוצה יעילה של חבילות פשוטות של סוגי נתונים, וביטלנו חוסר עקביות בפורמטים של נתונים, באזורי זמן, ביחידות מדידה ובטיפול בשגיאות. בנוסף, אנחנו תומכים עכשיו בפרוטוקול HTTP/REST לאחזור נתונים עם ביצועים גבוהים. בנוסף, נתונים תוך-יומיים ו-webhooks זמינים עכשיו לכל סוגי הנתונים הרלוונטיים דרך נקודת קצה ייעודית של רשימה.
- תמיכה משופרת ב-webhooks וביכולת התאמה לעומס: תמיכה מורחבת ב-webhooks, כולל מינויים אוטומטיים וניהול מפורט של כל סוגי הנתונים הרלוונטיים, שנועדה להתאים לעומס של הדור הבא של אפליקציות הבריאות מבוססות ה-AI.
- זהות ואבטחה יעילות: החלפת פרוטוקול ההרשאה הקודם של Fitbit (FOT) ב-Google OAuth 2.0. כך המפתחים יכולים להשתמש בספריות אימות סטנדרטיות של Google, לפשט את בסיסי הקוד ולספק למשתמשים דרך מוכרת ומרכזית לנהל את ההרשאות שלהם. כל היקפי ההרשאות של Google Health API מסווגים כמוגבלים, ולכן נדרשת בדיקת פרטיות ואבטחה כדי לקבל גישה.
אהבת את מה שראית? שנתחיל?
גרסאות API וערוץ הבטא לציבור הרחב
ב-Google Health API נעשה שימוש בניהול גרסאות מבוסס-ערוצים בהתאם להצעות לשיפור API (AIP) של Google, ובמיוחד AIP-185: ניהול גרסאות API ו-AIP-181: רמות יציבות. ה-API זמין בשני ערוצים ציבוריים: הערוץ היציב v4 וערוץ הבטא הציבורי v4beta. Google תומכת בשני הערוצים דרך ערוצי התמיכה של Google הרגילים.
השוואה בין ערוץ יציב לערוץ בטא
בהתאם ל-AIP-185, הערוץ v4beta פועל כקבוצת-על של הערוץ היציב v4. הוא כולל את כל הפונקציונליות היציבה של v4, לצד סוגי נתונים, שדות ושיטות בגישה מוקדמת שנמצאים בבדיקה של שותפים.
במסמכי התיעוד, רכיבי API שזמינים רק בערוץ הבטא מוצגים עם התווית v4beta.
| תכונה | ערוץ יציב (v4) |
ערוץ בטא לציבור הרחב (v4beta) |
|---|---|---|
| URI בסיסי של REST | https://health.googleapis.com/v4 |
https://health.googleapis.com/v4beta |
| חבילת gRPC | google.devicesandservices.health.v4 |
google.devicesandservices.health.v4beta |
| מסמכי עזר | v4 REST ו-v4 RPC | v4beta REST ו-v4beta RPC |
| רמת היציבות | מוכנה לייצור וכפופה לכללי התאימות לדורות קודמים של AIP-180. | גרסת טרום-השקה (Preview) לא יציבה, שעלולה להשתנות או להיות מוסרת בכל שלב ללא הודעה מוקדמת. |
| למה ישמש אותך ה-API? | אפליקציות פעילות בסביבת ייצור שגלויות למשתמשים. | בדיקות מוקדמות, יצירת אב טיפוס, אימות סכימה ומשוב ממפתחים. |
| תמיכה | נתמך דרך ערוצי התמיכה הרגילים. | תמיכה באמצעות ערוצי התמיכה הרגילים לדיווח על באגים, פתרון בעיות ומשוב על העיצוב. |
איך להתייחס לערוץ v4beta
כשאתם בודקים יכולות שמתויגות ב-v4beta, חשוב לפעול לפי ההנחיות הבאות:
- כדאי להשתמש ב-
v4betaבעיקר בסביבות פיתוח, Staging ובדיקות שאינן בסביבת הייצור. לא מומלץ להשיק תכונות בסביבת הייצור שמסתמכות על נקודות קצה (endpoint) שלv4betaאו על סוגי נתונים שזמינים רק בגרסת בטא. - סכמות, שמות של שדות, התנהגויות של נקודות קצה וייצוגי נתונים ב-
v4betaעשויים להשתנות בלי התרעה. יכול להיות גם שנסיר לגמרי תכונות וסוגי נתונים בגרסת בטא אם הם לא יעמדו ביעדי האימות. - כדאי לבודד את קוד הלקוח הניסיוני של
v4betaמאחורי feature flags או מודולים נפרדים, כדי ששינויי תוכנה שעלולים לגרום לכשל בערוץ הבטא לא ישבשו את השילוב שלv4. - כדי לעזור לנו לעצב את ה-API הסופי של
v4beta, אתם יכולים לקבל תמיכה, לדווח על בעיות ולשלוח משוב על ההטמעה דרך ערוצי התמיכה הרגילים שלנו.
שדרוג מגרסת בטא 4 לגרסה יציבה 4
סוגי נתונים ותכונות חדשים נכנסים ל-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 הפסיקה לתקן באגים או לספק תמיכה ב-API.
- 2 בנובמבר 2026 (השבתת ה-API): נקודות הקצה של Fitbit Web API ו-Fitbit OAuth הושבתו, והן לא פועלות יותר ולא מסנכרנות נתונים אל משתמשי Google Health או מהם. בקשות לנקודות הקצה האלה נכשלות ומוחזר קוד סטטוס HTTP
410 Gone.
מפתחים שמשתמשים ב-Fitbit Web API הקודם ובהרשאה של Fitbit צריכים להעביר את האפליקציות והמשתמשים שלהם ל-Google Health API ול-Google OAuth 2.0.
כדי להתחיל, כדאי לעיין במדריך להעברת נתונים (מיגרציה).
אילו מכשירים נתמכים?
כל המכשירים של Fitbit ושעוני Google Pixel, הנוכחיים והקודמים, יאספו נתונים שיוחזרו דרך Google Health API. סוג הנתונים שיהיו זמינים תלוי בפונקציונליות שהמכשירים תומכים בה.
רשימת המכשירים הנוכחיים מופיעה ב-Google Store.
איך שולחים משוב?
המשוב שלכם חשוב לנו מאוד. נשמח לקבל מכם משוב בערוצי התמיכה שלנו, שמפורטים בדף תמיכה.
למרות שהשקענו מאמצים רבים כדי לוודא שממשקי ה-API האלה תומכים בכם היטב, Google Health API מתפתח באופן פעיל. חשוב לדעת שעל סמך המשוב שלכם, יכול להיות שנערוך שינויים בין עכשיו לסוף מאי, שידרשו עדכונים תואמים מצידכם.
תוכנית אימונים
הנה רשימה של תכונות שיתווספו ב-2026.
רבעון 4, 2026
סוגי נתונים (קריאה וכתיבה)
- טמפרטורת העור ברזולוציה גבוהה
- קצב חילוף החומרים הבסיסי (BMR)
- אנחנו נוסיף סוגי נתונים כדי להגיע להתאמה מלאה ל-Health Connect. אנחנו מתכננים להוסיף עוד הרבה סוגי נתונים של Health Connect ברבעון הרביעי של 2026 וברבעון הראשון של 2027.
תכונות
- ערוץ בטא לציבור הרחב שמאפשר גישה מוקדמת לסוגי נתונים חדשים
- נקודת קצה של נתונים סטטיסטיים למעקב אחרי טלמטריה של תגובות לפעולה מאתר אחר (webhook)