פיתוח חוויות שינה באמצעות Google Health API

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

מדדים פיזיולוגיים כמו שונות קצב הלב (HRV), רמת החמצן בדם (SpO2) וקצב הנשימה מתועדים במיוחד במהלך השינה, כי הגוף נמצא במצב יציב של מנוחה. כך ה-API יכול לתעד את המצב הבסיסי של מערכת העצבים האוטונומית ומערכת הנשימה של המשתמש, בלי הפרעות של גורמי לחץ במהלך היום, פעילות גופנית או תנאי סביבה משתנים.

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

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

ה-API תומך בסוגי הנתונים הבאים למדידת שינה:

טבלה: סוגי נתוני השינה ב-Google Health API
סוג הנתונים פעולות
זמינות
היקף
שונות קצב הלב היומית
dataType: daily-heart-rate-variability
filter parameter: daily_heart_rate_variability
סוג הרשומה: יומי

מכשירים תואמים

רשימה, התאמה .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
רמת החמצן בדם ביום
dataType: daily-oxygen-saturation
filter parameter: daily_oxygen_saturation
סוג הרשומה: יומי

מכשירים תואמים

רשימה, התאמה .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
קצב הנשימה היומי
dataType: daily-respiratory-rate
filter parameter: daily_respiratory_rate
סוג הרשומה: יומי

מכשירים תואמים

רשימה, התאמה .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
סטיות יומיות בטמפרטורת השינה
dataType: daily-sleep-temperature-derivations
filter parameter: daily_sleep_temperature_derivations
סוג הרשומה: יומי

מכשירים תואמים

רשימה, התאמה .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
שונות קצב הלב
dataType: heart-rate-variability
filter parameter: heart_rate_variability
סוג הרשומה: דוגמה

מכשירים תואמים

רשימה, התאמה .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
רמת החמצן בדם
dataType: oxygen-saturation
filter parameter: oxygen_saturation
סוג הרשומה: דוגמה
רזולוציית אחסון: דקה אחת

מכשירים תואמים

רשימה, התאמה .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
סיכום השינה – קצב הנשימה
dataType: respiratory-rate-sleep-summary
filter parameter: respiratory_rate_sleep_summary
סוג הרשומה: דוגמה

מכשירים תואמים

רשימה, התאמה .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
שינה
dataType: sleep
filter parameter: sleep
סוג הרשומה: סשן

מכשירים תואמים

‫list, ‏ get, ‏ reconcile, ‏ create, ‏ update, ‏ batchDelete .sleep.readonly
.sleep.writeonly

רשומות שינה ויקיצות קצרות

רשומת שינה (Sleep) מייצגת אירוע שינה נפרד, כמו שינה לילית אחת או תנומה במהלך היום. הוא כולל פירוט של שלבי השינה שלא חופפים, לצד מרווחי מעבר קצרים למצב ערות, שנקראים "התעוררויות קצרות".

  • רשומת שינה (Sleep): מייצגת אירוע שינה נפרד (מרווחי שלבים LIGHT,‏ DEEP,‏ REM,‏ AWAKE) שמחלק את ציר הזמן הרציף של המנוחה העיקרית.
  • התעוררויות קצרות (shortAwakenings): מעברים קצרים למצב ערות או התעוררויות שמתרחשות במהלך המנוחה. בניגוד למרווחי הזמן הרגילים של שלבי AWAKE (שמחלקים את ההתקדמות הרציפה של שלבי השינה שלא חופפים), התעוררויות קצרות הן מקטעים נפרדים שיכולים לחפוף לשלבי השינה שמסביב. הם מספקים תצוגה מפורטת של חוסר מנוחה ויקיצות קצרות בלי לשבש את המבנה העיקרי של שלבי השינה.
  • התעוררויות בלילה: התעוררויות באמצע הלילה (למשל, כדי לשתות מים) מזוהות באמצעות שילוב של חיישנים במכשיר (מד תאוצה, ג'ירוסקופ וספירת צעדים). אפליקציות יכולות לזהות התעוררויות בלילה על ידי סינון של stages למרווחים עם type: "AWAKE" (בשימוש גם ברשומות של נתוני שינה של CLASSIC וגם של STAGES) או על ידי בדיקה של outOfBedSegments.

דוגמה

{
  "name": "users/user-id/dataTypes/sleep/dataPoints/data-point-id",
  "sleep": {
    "interval": {
      "startTime": "2026-04-20T22:30:00Z",
      "startUtcOffset": "-14400s",
      "endTime": "2026-04-21T06:30:00Z",
      "endUtcOffset": "-14400s"
    },
    "type": "STAGES",
    "stages": [
      {
        "startTime": "2026-04-20T22:30:00Z",
        "startUtcOffset": "-14400s",
        "endTime": "2026-04-20T23:45:00Z",
        "endUtcOffset": "-14400s",
        "type": "LIGHT"
      },
      {
        "startTime": "2026-04-20T23:45:00Z",
        "startUtcOffset": "-14400s",
        "endTime": "2026-04-21T01:15:00Z",
        "endUtcOffset": "-14400s",
        "type": "DEEP"
      }
    ],
    "shortAwakenings": [
      {
        "startTime": "2026-04-20T23:10:00Z",
        "startUtcOffset": "-14400s",
        "endTime": "2026-04-20T23:11:30Z",
        "endUtcOffset": "-14400s",
        "type": "AWAKE"
      }
    ],
    "summary": {
      "minutesInSleepPeriod": "480",
      "minutesAsleep": "455",
      "minutesAwake": "25",
      "minutesToFallAsleep": "15",
      "minutesAfterWakeUp": "10"
    }
  }
}

יצירת רשומת שינה

כדי ליצור רשומת שינה, שולחים בקשת POST לנקודת הקצה (endpoint) של נקודות הנתונים sleep. התשובה כוללת את השדה name שמכיל את data-point-id, שאפשר להשתמש בו בבקשת עדכון (תיקון) או מחיקה.

בקשה

POST https://health.googleapis.com/v4/users/me/dataTypes/sleep/dataPoints
Authorization: Bearer access-token
Content-Type: application/json

{
  "sleep": {
    "interval": {
      "startTime": "2026-06-07T22:00:00Z",
      "startUtcOffset": "-14400s",
      "endTime": "2026-06-08T06:00:00Z",
      "endUtcOffset": "-14400s"
    },
    "type": "STAGES",
    "stages": [
      {
        "startTime": "2026-06-07T22:00:00Z",
        "startUtcOffset": "-14400s",
        "endTime": "2026-06-07T22:30:00Z",
        "endUtcOffset": "-14400s",
        "type": "LIGHT"
      },
      {
        "startTime": "2026-06-07T22:30:00Z",
        "startUtcOffset": "-14400s",
        "endTime": "2026-06-07T23:45:00Z",
        "endUtcOffset": "-14400s",
        "type": "DEEP"
      },
      {
        "startTime": "2026-06-07T23:45:00Z",
        "startUtcOffset": "-14400s",
        "endTime": "2026-06-08T02:15:00Z",
        "endUtcOffset": "-14400s",
        "type": "LIGHT"
      },
      {
        "startTime": "2026-06-08T02:15:00Z",
        "startUtcOffset": "-14400s",
        "endTime": "2026-06-08T02:45:00Z",
        "endUtcOffset": "-14400s",
        "type": "REM"
      },
      {
        "startTime": "2026-06-08T02:45:00Z",
        "startUtcOffset": "-14400s",
        "endTime": "2026-06-08T05:15:00Z",
        "endUtcOffset": "-14400s",
        "type": "LIGHT"
      },
      {
        "startTime": "2026-06-08T05:15:00Z",
        "startUtcOffset": "-14400s",
        "endTime": "2026-06-08T06:00:00Z",
        "endUtcOffset": "-14400s",
        "type": "REM"
      }
    ]
  }
}

תשובה

{
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.devicesandservices.health.v4.DataPoint",
    "name": "users/user-id/dataTypes/sleep/dataPoints/data-point-id",
    "sleep": {
      "interval": {
        "startTime": "2026-06-07T22:00:00Z",
        "startUtcOffset": "-14400s",
        "endTime": "2026-06-08T06:00:00Z",
        "endUtcOffset": "-14400s"
      },
      "type": "STAGES",
      "stages": [
        {
          "startTime": "2026-06-07T22:00:00Z",
          "startUtcOffset": "-14400s",
          "endTime": "2026-06-07T22:30:00Z",
          "endUtcOffset": "-14400s",
          "type": "LIGHT"
        },
        {
          "startTime": "2026-06-07T22:30:00Z",
          "startUtcOffset": "-14400s",
          "endTime": "2026-06-07T23:45:00Z",
          "endUtcOffset": "-14400s",
          "type": "DEEP"
        },
        {
          "startTime": "2026-06-07T23:45:00Z",
          "startUtcOffset": "-14400s",
          "endTime": "2026-06-08T02:15:00Z",
          "endUtcOffset": "-14400s",
          "type": "LIGHT"
        },
        {
          "startTime": "2026-06-08T02:15:00Z",
          "startUtcOffset": "-14400s",
          "endTime": "2026-06-08T02:45:00Z",
          "endUtcOffset": "-14400s",
          "type": "REM"
        },
        {
          "startTime": "2026-06-08T02:45:00Z",
          "startUtcOffset": "-14400s",
          "endTime": "2026-06-08T05:15:00Z",
          "endUtcOffset": "-14400s",
          "type": "LIGHT"
        },
        {
          "startTime": "2026-06-08T05:15:00Z",
          "startUtcOffset": "-14400s",
          "endTime": "2026-06-08T06:00:00Z",
          "endUtcOffset": "-14400s",
          "type": "REM"
        }
      ]
    }
  }
}

מדדי יעילות השינה וזמן האחזור

בנוסף לשלבי השינה ולמדדים הפיזיולוגיים, ה-API מספק מדדים חשובים שמאפשרים לכמת את איכות השינה ואת תחילת השינה. יעילות השינה וזמן ההירדמות הם מדדים קליניים סטנדרטיים שמתארים את יעילות המנוחה של המשתמש ביחס לזמן הכולל במיטה, ומספקים תובנות לגבי היגיינת השינה ואיכות המנוחה.

ציון יעילות השינה

יעילות השינה היא מדד סטנדרטי שמוגדר כשיעור הזמן שבו ישנים ביחס לזמן הכולל שמבלים במיטה. ה-API מחשב את יעילות השינה באמצעות הנוסחה הבאה:

Sleep Efficiency Score = round( (Total Minutes Asleep / Total Minutes In Bed) * 100 )

ציון היעילות מחושב רגע לפני החלוקה לרמות (שלבי) השינה. מספר הדקות הכולל של השינה שמוחזר בתגובה מה-API (בשדה summary.minutesAsleep) משקף את התוצאה הסופית אחרי חישוב רמות השינה.

אם משתמש או חוקר משנה באופן ידני את שעת ההתחלה או הסיום של רשומת נתוני השינה, ה-API מחשב מחדש את ציון יעילות השינה ומתאים את חלוקת השלבים בהתאם לנתוני החיישנים שתועדו בטווח החדש של שעת השינה ושעת היקיצה.

זמן ההירדמות

הזמן עד ההירדמות מודד את משך הזמן שחולף מהרגע שבו המשתמש מתכוון להירדם (תחילת הזמן "במיטה" או "כיבוי אורות") ועד שהוא נרדם.

ביומנים שנוצרים באופן אוטומטי (metadata.manuallyEdited הוא false), הערך של summary.minutesToFallAsleep הוא "0" כברירת מחדל, כי לא תועדה כוונה מפורשת להירדם. כששעת ההתחלה של השהייה במיטה מתועדת או נערכת באופן ידני (metadata.manuallyEdited הוא true), ה-API מחשב ומאכלס את summary.minutesToFallAsleep יחד עם summary.minutesAfterWakeUp.

הנחיות למחקר ולרישום ידני

כשהמשתתפים מתעדים או משנים באופן ידני את שעות ההתחלה והסיום של השהייה במיטה:

  1. עדכון גבולות השהייה במיטה משנה את interval (וגם את summary.minutesInSleepPeriod) של השינה.
  2. רמות השינה והחלוקה לשלבים משתנות באופן אוטומטי כדי להעריך את נתוני החיישנים בחלון החדש.
  3. ציון יעילות השינה, summary.minutesToFallAsleep ו-summary.minutesAfterWakeUp מחושבים מחדש על סמך חלון הזמן המעודכן.

סטיות יומיות בטמפרטורת השינה

התכונה "שינויים יומיים בטמפרטורת השינה" מודדת את השינויים בטמפרטורת העור של המשתמש במהלך השינה בהשוואה לנתוני הבסיס שלו. בדרך כלל הנתונים האלה מדווחים פעם ביום אחרי רשומת שינה ארוכה.

קצב הנשימה

קצב הנשימה מודד את נשימות המשתמש בדקה (bpm). בזמן השינה, זהו מדד חשוב למעקב אחרי איכות השינה והפרעות אפשריות. ה-API תומך בדגימות של קצב הנשימה (respiratory-rate), בסיכומים יומיים (daily-respiratory-rate) ובסיכומי שינה ברמת הסשן (respiratory-rate-sleep-summary).

שונות קצב הלב (HRV)

HRV מודדת את השונות בזמן בין כל פעימת לב. זהו מדד מרכזי למצב של מערכת העצבים האוטונומית. ערך HRV גבוה במהלך השינה מעיד בדרך כלל על התאוששות ומוכנות טובות יותר, ואילו ערך HRV נמוך יכול להעיד על מתח או על אימון יתר. ה-API תומך בדגימות של HRV (heart-rate-variability) ובסיכומים יומיים (daily-heart-rate-variability).

רמת החמצן בדם

רמת החמצן בדם (סטורציה) מייצגת את אחוז ההמוגלובין הרווי בחמצן ביחס לסך כל ההמוגלובין בדם. מעקב אחרי הסטורציה בזמן השינה עוזר לזהות הפרעות פוטנציאליות בנשימה ולוודא שרמות החמצן של המשתמש תקינות במהלך הלילה. ה-API תומך בדגימות של SpO2‏ (oxygen-saturation) ובסיכומים יומיים (daily-oxygen-saturation).

כששולחים שאילתה לגבי oxygen-saturation ברמת הדקה, Google Health API מחזיר רק נקודות על הגרף מאומתות ומסנן מדידות לא חוקיות שנגרמו מתנועת הזרוע, מהתאמה רופפת של פרק כף היד או מרמת סמך נמוכה של החיישן (מתחת ל-50%), וגם קריאות שסמוכות לרעש תנועה. דקות לא חוקיות לא נכללות, ולכן יכול להיות שהכיסוי ברמת הדקה יהיה דליל ויהיו פערים בחותמות הזמן. גם oxygen-saturation וגם daily-oxygen-saturation מסתמכים על אותן קריאות מאומתות. לפרטים על הקריטריונים לאימות, ראו סינון SpO2 ברמת הדקה ותוקף הנתונים.

תמונה מקיפה של בריאות השינה וההתאוששות

כל מדד מספק תובנות ספציפיות, אבל הם קשורים זה לזה באופן הדוק ומספקים תמונה כוללת של ההתאוששות של המשתמש. שלבי השינה (קלה, עמוקה, REM) מספקים את הבסיס המבני למנוחה, וסמנים פיזיולוגיים כמו HRV ו-SpO2 מצביעים על האופן שבו הגוף מגיב פיזית למנוחה הזו. לדוגמה, רשומת שינה באיכות גבוהה עם שינה עמוקה אופטימלית קשורה בדרך כלל ל-HRV גבוה יותר, מה שמעיד על התאוששות יעילה של מערכת העצבים האוטונומית.

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

הנחיות

כשמשלבים מדדי שינה באפליקציה, צריך לפעול לפי ההנחיות הבאות:

  • פרטי הסשן: כדי להציג את שלבי השינה של המשתמש (שינה קלה, שינה עמוקה, שנת REM, ערות) ויקיצות קצרות, שולחים שאילתה לסוג הנתונים sleep.
  • התעוררויות בלילה: כדי לעקוב אחרי אירועי התעוררות באמצע הלילה בלי זרמי נתונים גולמיים מחיישנים, בודקים את המרווחים של השלב sleep ומסננים פריטים עם type: "AWAKE" (גם לרשומות של נתוני שינה STAGES וגם CLASSIC) או בודקים את outOfBedSegments.
  • זמן אחזור ויעילות: השתמשו ב-summary.minutesToFallAsleep ובנוסחת יעילות השינה כדי לנתח את זמן האחזור של השינה. חשוב לדעת שהשדה summary.minutesToFallAsleep מאוכלס כשעורכים באופן ידני את רשומות נתוני השינה (metadata.manuallyEdited הוא true) או כשהן נרשמות באופן מפורש.
  • מעקב פיזיולוגי: כדי לעקוב אחרי הבריאות בצורה מתקדמת, אפשר לשלב את נתוני רשומת השינה עם מדדים פיזיולוגיים ומדדי התאוששות כמו respiratory-rate-sleep-summary, daily-sleep-temperature-derivations, daily-heart-rate-variability ו-daily-oxygen-saturation.
  • התאמה: משתמשים בפעולה reconcile כדי לוודא שרשומות חופפות של נתוני שינה ממכשירים שונים (לדוגמה, מכשיר לביש וחיישן במזרן) ימוזגו לרשומה "ראשית" אחת של נתוני שינה.

חשבו את משך הזמן הכולל של השינה העמוקה

כדי לחשב את משך הזמן הכולל שבו המשתמש היה בשלב של שינה עמוקה ומרעננת בלילה מסוים:

  1. שליחת שאילתה לגבי סוג הנתונים sleep בטווח התאריכים שצוין.
  2. עוברים על רשימת השלבים ומזהים את המרווחים שבהם הערך של type הוא DEEP.
  3. מחשבים את משך הזמן (שעת סיום פחות שעת התחלה) של כל מרווח זמן של שינה עמוקה ומסכמים אותם.

הסכום שמתקבל הוא משך הזמן הפיזי הכולל של השינה העמוקה באותו סשן.