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"
    }
  }
}

স্লিপ সেশন তৈরি করুন

স্লিপ সেশন এন্ট্রি তৈরি করতে, sleep ডেটা পয়েন্ট এন্ডপয়েন্টে POST অনুরোধ পাঠান। উত্তরে 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"
        }
      ]
    }
  }
}

ঘুমানোর সেশন কোয়েরি ও রিকনসাইল করুন

ব্যবহারকারীর ঘুমের ইতিহাস ফিরে পেতে, list এন্ডপয়েন্ট-এর পরিবর্তে reconcile এন্ডপয়েন্ট কোয়েরি করুন। ব্যবহারকারী একাধিক সোর্স থেকে ঘুমের ডেটা ট্র্যাক করলে, যেমন হালকা ও ছোট ডিভাইস ট্র্যাকার এবং Health Connect, list প্রতিটি ওভারল্যাপ করা রেকর্ড রিটার্ন করে। র list ফলাফল যোগ করলে দৈনিক স্লিপ ডিউরেশন ডাবল-কাউন্ট হতে পারে। reconcile এন্ডপয়েন্ট ওভারল্যাপ করা লগগুলিকে একটি স্ট্রিমে ডিডুপ্লিকেট করে এবং sleep.metadata.mainSleep থেকে true সেট করে প্রতিটি দিনের প্রাথমিক ঘুমের সেশন শনাক্ত করে। দুটি এন্ডপয়েন্টের তুলনা করতে, এন্ডপয়েন্ট তালিকা তুলনা ও রিকনসাইল করুন দেখুন।

list বা reconcile-এর সাথে sleep কোয়েরি করার সময়, নিম্নলিখিত ফিল্টারিং ও পৃষ্ঠা সংখ্যা সংক্রান্ত সীমাবদ্ধতা মনে রাখবেন:

  1. sleep.interval.end_time (UTC-তে ফিজিক্যাল টাইম) বা sleep.interval.civil_end_time (স্থানীয় সিভিল টাইম) ব্যবহার করে সেশনের শেষ হওয়ার সময় অনুযায়ী শুধুমাত্র sleep কোয়েরি ফিল্টার করুন। AND-এর সাথে >= এবং < তুলনাকারী অপারেটর ব্যবহার করে নিম্ন ও ঊর্ধ্ব সীমা একত্রিত করুন।
  2. শুরুর সময় বা OR দিয়ে sleep কোয়েরি ফিল্টার করবেন না। sleep.interval.start_time বা sleep.interval.civil_start_time-এ ফিল্টার করলে 400 Bad Request (INVALID_ARGUMENT) সমস্যা দেখায়, যার কারণ INVALID_DATA_POINT_FILTER_DATA_TYPE_MEMBER। OR ব্যবহার করলে 400 Bad Request (INVALID_ARGUMENT) সমস্যা দেখায়, যার কারণ INVALID_DATA_POINT_FILTER_EXPRESSION_STRUCTURE। সিনট্যাক্স সংক্রান্ত বিবরণের জন্য, ডেটা ফিল্টার করার নির্দেশিকা দেখুন।
  3. list এবং reconcile, দুটিই sleep-এর জন্য ডিফল্ট এবং সর্বাধিক pageSize 25 প্রয়োগ করে। আপনি 25-এর থেকে বেশি pageSize পাস করলে, API ভ্যালুটিকে 25-এ ক্ল্যাম্প করে এবং ভ্যালুটি নেগেটিভ হলে 400 Bad Request সমস্যা রিটার্ন করে। একাধিক সপ্তাহের ঘুমের ইতিহাস সিঙ্ক করতে, টোকেন খালি না হওয়া পর্যন্ত nextPageToken ব্যবহার করে পেজিনেট করুন। আরও জানতে, পুরনো ডেটা কোয়েরি করা দেখুন।

যেমন, নিম্নলিখিত অনুরোধটি দুই সপ্তাহের সিভিল তারিখের রেঞ্জের মধ্যে শেষ হওয়া রিকনসাইল করা ঘুমের সেশন কোয়েরি করে:

অনুরোধ করুন

GET https://health.googleapis.com/v4/users/me/dataTypes/sleep/dataPoints:reconcile
  ?filter=sleep.interval.civil_end_time >= "2026-03-01"
  AND sleep.interval.civil_end_time < "2026-03-15"
  &pageSize=25
Authorization: Bearer access-token
Accept: application/json

রেসপন্স

{
  "dataPoints": [
    {
      "dataPointName": "users/user-id/dataTypes/sleep/dataPoints/data-point-id",
      "sleep": {
        "interval": {
          "startTime": "2026-03-03T20:57:30Z",
          "startUtcOffset": "0s",
          "endTime": "2026-03-04T04:41:30Z",
          "endUtcOffset": "0s"
        },
        "type": "STAGES",
        "stages": [
          {
            "startTime": "2026-03-03T20:57:30Z",
            "startUtcOffset": "0s",
            "endTime": "2026-03-03T20:59:30Z",
            "endUtcOffset": "0s",
            "type": "AWAKE"
          },
          {
            "startTime": "2026-03-04T04:07:30Z",
            "startUtcOffset": "0s",
            "endTime": "2026-03-04T04:41:30Z",
            "endUtcOffset": "0s",
            "type": "AWAKE"
          }
        ],
        "metadata": {
          "stagesStatus": "SUCCEEDED",
          "processed": true,
          "mainSleep": true
        },
        "summary": {
          "minutesInSleepPeriod": "464",
          "minutesAfterWakeUp": "0",
          "minutesToFallAsleep": "0",
          "minutesAsleep": "407",
          "minutesAwake": "57",
          "stagesSummary": [
            {
              "type": "AWAKE",
              "minutes": "56",
              "count": "12"
            },
            {
              "type": "LIGHT",
              "minutes": "198",
              "count": "19"
            },
            {
              "type": "DEEP",
              "minutes": "114",
              "count": "10"
            },
            {
              "type": "REM",
              "minutes": "94",
              "count": "4"
            }
          ]
        }
      }
    }
  ],
  "nextPageToken": "Xm5h-6L0viZxIlRuWjx5bmvy98zj85uG34tuMn16mu2pntsnZI32iqhq"
}

ঘুমের দক্ষতা ও লেটেন্সি মেট্রিক

ঘুমের বিভিন্ন পর্যায় ও শারীরবৃত্তীয় মেট্রিক্স ছাড়াও, 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 আবার গণনা করা হয়।

দৈনিক ঘুমের তাপমাত্রার পরিবর্তন

'দৈনিক ঘুমের তাপমাত্রার পরিবর্তন' ফিচার, ব্যবহারকারীর বেসলাইনের তুলনায় ঘুমের সময় তার ত্বকের তাপমাত্রার পরিবর্তন পরিমাপ করে। এই ডেটা সাধারণত একটি প্রধান স্লিপ সেশনের পরে দিনে একবার রিপোর্ট করা হয়।

শ্বাস-প্রশ্বাসের হার সংক্রান্ত ডেটা

শ্বাস-প্রশ্বাসের হার ব্যবহারকারীর প্রতি মিনিটে শ্বাস-প্রশ্বাসের সংখ্যা পরিমাপ করে। ঘুমের সময়, এটি ঘুমের কোয়ালিটি ও সম্ভাব্য সমস্যা মনিটর করার জন্য একটি গুরুত্বপূর্ণ মেট্রিক। API স্যাম্পেল শ্বাস-প্রশ্বাসের হার (respiratory-rate), দৈনিক সারসংক্ষেপ (daily-respiratory-rate) এবং সেশন-লেভেল স্লিপ সামারি (respiratory-rate-sleep-summary) সাপোর্ট করে।

হার্ট রেটের তারতম্য (HRV)

HRV প্রতিটি হার্টবিটের মধ্যে সময়ের তারতম্য পরিমাপ করে। এটি অটোনমিক নার্ভাস সিস্টেমের অবস্থার একটি মূল সূচক; ঘুমের সময় উচ্চ HRV সাধারণত আরও ভালভাবে সেরে ওঠা এবং প্রস্তুতির ইঙ্গিত দেয়, যেখানে কম HRV স্ট্রেস বা অতিরিক্ত ট্রেনিংয়ের ইঙ্গিত দিতে পারে। API স্যাম্পেল HRV (heart-rate-variability) এবং দৈনিক সারসংক্ষেপ (daily-heart-rate-variability) সাপোর্ট করে।

অক্সিজেন স্যাচুরেশনের মাত্রার ডেটা

ব্লাড অক্সিজেন স্যাচুরেশনের মাত্রা (SpO2) রক্তে মোট হিমোগ্লোবিনের তুলনায় অক্সিজেন-স্যাচুরেটেড হিমোগ্লোবিনের শতাংশকে বোঝায়। ঘুমের সময় SpO2 মনিটর করলে, সম্ভাব্য শ্বাসকষ্ট শনাক্ত করতে সাহায্য করে এবং ব্যবহারকারী সারা রাত পর্যাপ্ত অক্সিজেনের লেভেল বজায় রাখছেন কিনা তা কনফার্ম করে। API-তে স্যাম্পেল SpO2 (oxygen-saturation) এবং দৈনিক সারসংক্ষেপ (daily-oxygen-saturation) কাজ করে।

আপনি মিনিট-লেভেল oxygen-saturation কোয়েরি করলে, Google Health API শুধুমাত্র যাচাই করা ডেটা পয়েন্ট রিটার্ন করে এবং হাত নাড়ানো, রিস্টব্যান্ড ঢিলে থাকা বা সেন্সর কনফিডেন্স কম (৫০%-এর কম) থাকার কারণে হওয়া ভুল পরিমাপ এবং মোশন নয়েজের কাছাকাছি রিডিং ফিল্টার করে বাদ দেয়। ভুল মিনিট বাদ দেওয়া হয় বলে, মিনিট-লেভেল কভারেজ কম হতে পারে এবং টাইমস্ট্যাম্পে গ্যাপ থাকতে পারে। 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।

ডিপ স্লিপে মোট সময় গণনা করো

কোনও নির্দিষ্ট রাতে একজন ব্যবহারকারী রিস্টোরেটিভ গভীর ঘুমের পর্যায়ে মোট কত সময় কাটিয়েছেন তা গণনা করতে:

  1. নির্দিষ্ট সময়সীমার জন্য sleep ডেটার ধরন কোয়েরি করুন।
  2. স্টেজের তালিকা বারবার দেখুন এবং সেইসব ইন্টারভ্যাল শনাক্ত করুন যেখানে type হল DEEP।
  3. প্রতিটি গভীর ঘুমের বিরতির জন্য সময়সীমা (শেষের সময় - শুরুর সময়) গণনা করুন এবং সেগুলি যোগ করুন।

ফলাফল হিসেবে পাওয়া যোগফল সেই সেশনের জন্য গভীর ঘুমের মোট শারীরিক সময়কাল প্রদান করে।