כתיבת נתוני שינה

האפליקציה שלך יכולה לקרוא ולכתוב נתוני שינה מפורטים. השלבים האלה כוללים שינה קלה, שינה עמוקה, REM ושלבי שינה לא ערה מהסוג הנקוב SleepStages. כדי לכתוב נתוני שינה, צריך ליצור סשן מסוג FitnessActivities.SLEEP. נתוני השינה צריכים להיות כלולים בסשן אם הם מופיעים ביומן של המשתמש באפליקציית Google Fit.

אפשר גם להוסיף פלחים מסוג SleepStages בתוך הסשן:

• SleepStages.SLEEP_LIGHT
• SleepStages.SLEEP_DEEP
• SleepStages.SLEEP_REM
• SleepStages.AWAKE
• SleepStages.OUT_OF_BED

דוגמה ללא רמת פירוט

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

Android

val fitnessOptions = FitnessOptions.builder()
    .accessSleepSessions(FitnessOptions.ACCESS_WRITE)
    .build()

// Create the sleep session
val session= Session.Builder()
    .setName(sessionName)
    .setIdentifier(identifier)
    .setDescription(description)
    .setStartTime(startTime, TimeUnit.MILLISECONDS)
    .setEndTime(endTime, TimeUnit.MILLISECONDS)
    .setActivity(FitnessActivities.SLEEP)
    .build()

// Build the request to insert the session.
val request = SessionInsertRequest.Builder()
    .setSession(session)
    .build()

// Insert the session into Fit platform
Log.i(TAG, "Inserting the session with the SessionsClient")
Fitness.getSessionsClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))
    .insertSession(request)
    .addOnSuccessListener {
        Log.i(TAG,"Session insert was successful!")
    }
    .addOnFailureListener { e ->
        Log.w(TAG, "There was a problem inserting the session", e)
    }

לפרטים נוספים על סשנים ב-Android.

REST

שיטת HTTP

PUT

כתובת ה-URL של הבקשה

https://www.googleapis.com/fitness/v1/users/me/sessions/identifier

גוף הבקשה

{
    "id": identifier,
    "name": sessionName,
    "description": description,
    "startTimeMillis": startTime,
    "endTimeMillis": endTime,
    "version": 1,
    "lastModifiedToken": "exampleToken",
    "application": {
        "detailsUrl": "http://example.com",
        "name": "Foo Example App",
        "version": "1.0"
    },
    "activityType": 72 // Sleep
}

דוגמה לרמת פירוט של שלבי השינה

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

כתיבה של פלחי שינה

בדוגמה הזו נכתוב כמה פלחים כדי לייצג את כמה שלבי השינה במהלך לילה אחד של שינה.

Android

val dataSource = DataSource.Builder()
    .setType(DataSource.TYPE_RAW)
    .setDataType(DataType.TYPE_SLEEP_SEGMENT)
    .setAppPackageName(context)
    // Optional but recommended for identifying the stream if you have multiple streams with the same dataType.
    .setStreamName(streamName)
    .build()

val dataPoints = listOf(
    DataPoint.builder(dataSource)
        .setTimeInterval(startTime1, endTime1, TimeUnit.MILLISECONDS)
        .setField(Field.FIELD_SLEEP_SEGMENT_TYPE, SleepStages.SLEEP_LIGHT)
        .build(),
    DataPoint.builder(dataSource)
        .setTimeInterval(startTime2, endTime2, TimeUnit.MILLISECONDS)
        .setField(Field.FIELD_SLEEP_SEGMENT_TYPE, SleepStages.SLEEP_DEEP)
        .build(),
    DataPoint.builder(dataSource)
        .setTimeInterval(startTime3, endTime3, TimeUnit.MILLISECONDS)
        .setField(Field.FIELD_SLEEP_SEGMENT_TYPE, SleepStages.SLEEP_LIGHT)
        .build(),
    DataPoint.builder(dataSource)
        .setTimeInterval(startTime4, endTime4, TimeUnit.MILLISECONDS)
        .setField(Field.FIELD_SLEEP_SEGMENT_TYPE, SleepStages.SLEEP_REM)
        .build(),
    DataPoint.builder(dataSource)
        .setTimeInterval(startTime5, endTime5, TimeUnit.MILLISECONDS)
        .setField(Field.FIELD_SLEEP_SEGMENT_TYPE, SleepStages.AWAKE)
        .build(),
    DataPoint.builder(dataSource)
        .setTimeInterval(startTime6, endTime6, TimeUnit.MILLISECONDS)
        .setField(Field.FIELD_SLEEP_SEGMENT_TYPE, SleepStages.SLEEP_LIGHT)
        .build()
)

val dataSet = DataSet.builder(dataSource)
    .addAll(dataPoints)
    .build()

REST

1. קודם כול יוצרים dataSource:

   שיטת HTTP

   POST
   

   כתובת ה-URL של הבקשה

   https://www.googleapis.com/fitness/v1/users/me/dataSources
   

   גוף הבקשה

   {
     "dataStreamName": streamName,
     "type": "raw",
     "application": {
       "detailsUrl": "http://example.com",
       "name": "Foo Example App",
       "version": "1"
     },
     "dataType": {
       "name": "com.google.sleep.segment"
     }
   }
   

2. לאחר מכן מאכלסים את dataSet:

   שיטת HTTP

   PATCH
   

   כתובת ה-URL של הבקשה

   https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId
   

   גוף הבקשה

   {
       "dataSourceId": dataSourceId,
       "point": [
           {
               "dataTypeName": "com.google.sleep.segment",
               "startTimeNanos": startTime1,
               "endTimeNanos": endTime1,
               "value": [
                   {
                       intVal: 4 // Light sleep
                   }
               ]
           },
           {
               "dataTypeName": "com.google.sleep.segment",
               "startTimeNanos": startTime2,
               "endTimeNanos": endTime2,
               "value": [
                   {
                       intVal: 5 // Deep sleep
                   }
               ]
           },
           {
               "dataTypeName": "com.google.sleep.segment",
               "startTimeNanos": startTime3,
               "endTimeNanos": endTime3,
               "value": [
                   {
                       intVal: 4 // Light sleep
                   }
               ]
           },
           {
               "dataTypeName": "com.google.sleep.segment",
               "startTimeNanos": startTime4,
               "endTimeNanos": endTime4,
               "value": [
                   {
                       intVal: 6 // REM sleep
                   }
               ]
           },
           {
               "dataTypeName": "com.google.sleep.segment",
               "startTimeNanos": startTime5,
               "endTimeNanos": endTime5,
               "value": [
                   {
                       intVal: 1 // Awake
                   }
               ]
           },
           {
               "dataTypeName": "com.google.sleep.segment",
               "startTimeNanos": startTime6,
               "endTimeNanos": endTime6,
               "value": [
                   {
                       intVal: 4 // Light sleep
                   }
               ]
           }
        ]
    }
   

כתיבת נתוני השינה

לבסוף, צריך לקבץ את הפלחים שלמעלה על ידי הוספת סשן שינה. מגדירים את שעת ההתחלה של הסשן לשעת ההתחלה של הקטע הראשון, ולשעת הסיום של הקטע האחרון.

Android

val fitnessOptions = FitnessOptions.builder()
    .accessSleepSessions(FitnessOptions.ACCESS_WRITE)
    .addDataType(DataType.TYPE_SLEEP_SEGMENT, FitnessOptions.ACCESS_WRITE)
    .build()

val session = Session.Builder()
    .setName(sessionName)
    .setIdentifier(identifier)
    .setDescription(description)
    .setStartTime(startTime1, TimeUnit.MILLISECONDS) // From first segment
    .setEndTime(endTime6, TimeUnit.MILLISECONDS) // From last segment
    .setActivity(FitnessActivities.SLEEP)
    .build()

// Build the request to insert the session.
val request = SessionInsertRequest.Builder()
    .setSession(session)
    .addDataSet(dataset)
    .build()

// Insert the session into Fit platform
Log.i(TAG, "Inserting the session in the Sessions API")
Fitness.getSessionsClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))
    .insertSession(request)
    .addOnSuccessListener {
        Log.i(TAG,"Session insert was successful!")
    }
    .addOnFailureListener { e ->
        Log.i(TAG, "There was a problem inserting the session", e)
    }

REST

שיטת HTTP

PUT

כתובת ה-URL של הבקשה

https://www.googleapis.com/fitness/v1/users/me/sessions/identifier

גוף הבקשה

{
    "id": identifier,
    "name": sessionName,
    "description": description,
    "startTimeMillis": startTime1,
    "endTimeMillis": endTime6,
    "version": 1,
    "lastModifiedToken": "exampleToken",
    "application": {
        "detailsUrl": "http://example.com",
        "name": "Foo Example App",
        "version": "1.0"
    },
    "activityType": 72 // Sleep
}