נתוני גרסה

‫26 במאי 2026

היקפים חדשים

  • ‫.ecg.readonly לקריאת נתוני אק"ג.
  • ‫.irn.readonly לקריאת נתוני IRN.

שינויים בשם של היקף ההרשאות

החלפת היקפי קריאה/כתיבה ב-writeonly. המפתחים צריכים לציין במפורש את הרשאות הקריאה והכתיבה.

  • האפשרות .activity_and_fitness נקראת .activity_and_fitness.writeonly עכשיו
  • האפשרות .health_metrics_and_measurements נקראת .health_metrics_and_measurements.writeonly עכשיו
  • האפשרות .nutrition נקראת .nutrition.writeonly עכשיו
  • האפשרות .profile נקראת .profile.writeonly עכשיו
  • האפשרות .settings נקראת .settings.writeonly עכשיו
  • האפשרות .sleep נקראת .sleep.writeonly עכשיו

סוגי נתונים חדשים

הוספנו תמיכה בסוגי הנתונים הבאים:

  • פעילות וכושר: active-energy-burned
  • ECG: electrocardiogram
  • מדדי הבריאות ומדידות: core-body-temperature, blood-glucose
  • IRN: irregular-rhythm-notification
  • ערכים תזונתיים: food, food-measurement-unit, nutrition-log

נקודות קצה חדשות

  • project.subscribers.subscriptions: create, delete, list ו-patch שיטות לניהול ידני של המינוי.
  • ‫users: getIrnProfile מחזירה את רמת המעורבות הנוכחית של המשתמש עם התכונה IRN
  • ‫users.pairedDevices: ‫get ו-list המכשירים שמזווגים לחשבון של משתמש.

תגובות לפעולה מאתר אחר (webhook)

הוספנו תמיכה בפונקציונליות הבאה של webhook:

  • תמיכה במינויים ידניים כשנרשם מנוי.
  • תמיכה בהתראות לסוגי הנתונים activityLevel, bloodGlucose, dailyRespiratoryRate, heartRateVariability, height, hydrationLog, nutritionLog, respiratoryRateSleepSummary, runVo2Max, sedentaryPeriod, timeInHeartRateZone.
  • תמיכה במדדים מותאמים אישית, בהתראות ובשגיאות של מנויים במסוף Google Cloud.
  • אם התקשורת עם המנוי נקטעת, המערכת מנסה לשלוח שוב באופן אוטומטי התראות על אירועים ב-webhook שנכשלו, למשך עד 7 ימים.

עדכונים חשובים במסמכים

‫14 באפריל 2026

סוגי נתונים חדשים

  • פעילות וכושר: swim-lengths-data
  • מדדי בריאות ומדידות: height

נקודות קצה חדשות

  • ‫project.subscribers: שיטות delete,‏ get,‏ list ו-patch לניהול מינויים באופן ידני.
  • ‫users.dataTypes.dataPoints: ‫get מחזירה נקודה על הגרף אחת על סמך המזהה.

תמיכה ב-webhook

  • יצירת מינוי אוטומטית כשנרשם מנוי.
  • ניהול ידני של המינויים באמצעות נקודות הקצה של project.subscribers
  • התראות נתמכות לסוגי הנתונים activeZoneMinutes,‏ altitude,‏ bodyFat,‏ caloriesInHeartRateZone,‏ dailyHeartRateVariability,‏ dailyHeartRateZones,‏ dailyOxygenSaturation,‏ dailyRestingHeartRate,‏ dailySleepTemperatureDerivations,‏ distance,‏ exercise,‏ floors,‏ heartRate,‏ sleep,‏ steps,‏ totalCalories ו-weight.

תכונות נוספות

  • ספריות REST ב-GitHub: ספריות ה-REST של Google Health API זמינות לכל ספריות הלקוח הנתמכות שכלולות בפרויקט Google APIs ב-GitHub.
  • תמיכה ב-API Explorer: אפשר לקרוא לנקודות הקצה באמצעות API Explorer שמוטמע במאמרי העזרה.
  • תמיכה ב-OAuth Playground: Google Health API גרסה 4 מופיע ב-OAuth 2.0 Playground, כלי שמאפשר לכם לקרוא לנקודות הקצה שתומכות בספריית OAuth של Google.

‫24 במרץ 2026

השקת Google Health API

‫Google Health API הוא הדור הבא של Fitbit Web API. הוא נבנה מאפס ומיועד לקהילת המפתחים המוערכת שלנו. הגרסה הראשונית הזו מתמקדת בהשגת שוויון עם Fitbit Web API בכל סוגי הנתונים המבוקשים ביותר, וגם בהוספת פונקציונליות שהקהילה של המפתחים ביקשה. אלה התכונות שזמינות היום.

תכונות עיקריות

  • הגדרה פשוטה יותר: אפשר לרשום את הפרויקטים ולנהל את מזהי לקוח OAuth ישירות דרך מסוף Google Cloud המוכר.
  • תמיכה רחבה בפלטפורמות: אפשר לבנות על ספריות Google OAuth2 לשילוב חלק בכל שפות התכנות והפלטפורמות העיקריות.
  • גישה פשוטה יותר לנתונים: אפשר להשתמש בהגדרות חדשות של היקף הגישה שמאחדות כמה סוגי נתונים להיקף גישה יחיד וקל לניהול.
  • נקודות קצה עקביות בכל סוגי הנתונים: תהליך קידוד פשוט יותר עם נקודות קצה חדשות ואחידות ותמיכה במסננים שנועדו לייעל את הפונקציונליות בכל סוגי הנתונים.
  • כיסוי נתונים מקיף: גישה לתמיכה בקריאה ובכתיבה של סוגים שונים של נתונים.
  • התראות בזמן אמת: קבלת עדכונים באופן מיידי עם תמיכה משופרת ב-Webhook, כולל יצירה אוטומטית של מינויים ותוכן עשיר יותר בהודעות ההתראה.
  • תמיכה בנתונים יומיים כברירת מחדל: שליפת נתונים מפורטים יומיים כברירת מחדל באמצעות נקודת הקצה של הרשימה, בלי צורך לבצע שלבים נוספים.
  • חבילת מסמכים מלאה: אפשר להתחיל לעבוד במהירות עם המסמכים המקיפים החדשים שלנו, כולל:
    • מדריכים לתחילת העבודה, ל-API, להעברה ולפתרון בעיות
    • מדריך עזר מלא ל-REST
    • כלי חדש להשוואה בין Google Health API, קוד לדוגמה ושיעור Codelab מודרך

סוגי נתונים נתמכים

ההשקה הזו מספקת גישה לסוגי נתונים חיוניים, כדי שיהיה לכם את המידע הבסיסי שנדרש ליצירת פתרונות בריאות חדשניים.

סוגי נתונים שתומכים בקריאה:

  • פעילות וכושר: דקות פעילות, דקות טווח פעילות, רמת פעילות, גובה, קלוריות בטווח דופק, צריכת חמצן מרבית (VO2 max) יומית, מרחק, פעילות גופנית, קומות, צריכת חמצן מרבית (VO2 max) בריצה, תקופה של חוסר פעילות, צעדים, זמן בטווח דופק, סך הקלוריות, צריכת חמצן מרבית (VO2 max)
  • מדדי בריאות ומדידות: אחוז השומן בגוף, שונות קצב הלב היומית, טווחי הדופק היומיים, רמת החמצן היומית בדם, קצב הנשימה היומי, הדופק היומי במנוחה, נתוני טמפרטורת הגוף היומיים במהלך השינה, דופק, שונות קצב הלב, רמת החמצן בדם, סיכום השינה של קצב הנשימה, משקל
  • זהות: מחזירה את מזהה המשתמש ב-Fitbit ואת מזהה המשתמש ב-Google
  • מיקום: נתוני GPS שמבוססים על אימון כושר מתועד בפורמט TCX
  • תזונה: יומן מעקב אחר מאזן הנוזלים
  • פרופיל: פרטי הפרופיל הבסיסיים של המשתמשים
  • הגדרות: משתמשים שהגדירו את ההגדרות של המכשיר ואת ההגדרות של האפליקציה לנייד
  • שינה: יומני שינה קלאסיים ויומני שינה לפי שלבים

סוגי נתונים שתומכים בכתיבה:

אפשר לכתוב ולשנות נתונים עבור סוגי הנתונים הבאים:

  • פעילות וכושר: פעילות גופנית
  • מדדי בריאות ומדידות: אחוז השומן בגוף, משקל
  • פרופיל
  • הגדרות
  • שינה

נקודות קצה (endpoints) מרכזיות לאינטראקציה

נקודות הקצה הבאות זמינות לניהול מינויים, משתמשים ונתונים של אימוני כושר:

  • ‫users: השיטות getIdentity,‏ getProfile,‏ getSettings,‏ updateProfile ו-updateSettings לניהול זהויות ופרופילים.
  • ‫users.dataTypes.dataPoints: השיטות batchDelete,‏ dailyRollUp,‏ list,‏ patch,‏ reconcile ו-rollUp מאפשרות ניהול מקיף של סוגי נתונים.