গুগল হেলথ এপিআই ব্যবহার করে ভাইটালস এবং হেলথ মেট্রিক্স অভিজ্ঞতা তৈরি করুন

গুগল হেলথ এপিআই ব্যবহারকারীর অত্যাবশ্যকীয় এবং শারীরবৃত্তীয় স্বাস্থ্য সূচক, যেমন—হৃদস্পন্দন, অক্সিজেন স্যাচুরেশন, রক্তে গ্লুকোজ, শরীরের মূল তাপমাত্রা এবং দৈনিক ঘুমের তাপমাত্রার পরিমাপ ট্র্যাক করে।

আপনার ব্যবহারকারীদের সর্বোত্তম অভিজ্ঞতা প্রদানের জন্য, আপনার অ্যাপ্লিকেশনে ভাইটালস ডেটা কীভাবে পড়তে হয় এবং এর জন্য ব্যবহারকারীর অনুমোদন চাইতে হয়, তা বুঝুন।

সমর্থিত ডেটা প্রকার

গুরুত্বপূর্ণ শারীরিক লক্ষণ এবং স্বাস্থ্য মেট্রিক্স ট্র্যাক করার জন্য এপিআই নিম্নলিখিত ডেটা টাইপগুলি সমর্থন করে:

সারণি: গুগল হেলথ এপিআই ভাইটালস ডেটার প্রকারভেদ
ডেটা টাইপ উপলব্ধ
অপারেশন		 পরিধি
রক্তে গ্লুকোজ
ডেটার ধরণ: blood-glucose
ফিল্টার প্যারামিটার: blood_glucose
রেকর্ডের ধরণ: নমুনা
 তালিকা, পাওয়া, সমন্বয় করা, একত্রিতকরণ, দৈনিক একত্রিতকরণ .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
শরীরের মূল তাপমাত্রা
ডেটাটাইপ: core-body-temperature
ফিল্টার প্যারামিটার: core_body_temperature
রেকর্ডের ধরণ: নমুনা
 তালিকা, পাওয়া, সমন্বয় করা, একত্রিতকরণ, দৈনিক একত্রিতকরণ .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
দৈনিক হৃদস্পন্দন পরিবর্তনশীলতা
ডেটাটাইপ: daily-heart-rate-variability
ফিল্টার প্যারামিটার: daily_heart_rate_variability
রেকর্ডের ধরণ: দৈনিক

সামঞ্জস্যপূর্ণ ডিভাইস

 তালিকা করুন, সমন্বয় করুন .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
দৈনিক হৃদস্পন্দন অঞ্চল
ডেটার ধরণ: daily-heart-rate-zones
ফিল্টার প্যারামিটার: daily_heart_rate_zones
রেকর্ডের ধরণ: দৈনিক
 তালিকা করুন, সমন্বয় করুন .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
দৈনিক অক্সিজেন স্যাচুরেশন
ডেটাটাইপ: daily-oxygen-saturation
ফিল্টার প্যারামিটার: daily_oxygen_saturation
রেকর্ডের ধরণ: দৈনিক

সামঞ্জস্যপূর্ণ ডিভাইস

 তালিকা করুন, সমন্বয় করুন .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
দৈনিক শ্বাস-প্রশ্বাসের হার
ডেটাটাইপ: daily-respiratory-rate
ফিল্টার প্যারামিটার: daily_respiratory_rate
রেকর্ডের ধরণ: দৈনিক

সামঞ্জস্যপূর্ণ ডিভাইস

 তালিকা করুন, সমন্বয় করুন .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
দৈনিক বিশ্রামকালীন হৃদস্পন্দন
ডেটার ধরণ: daily-resting-heart-rate
ফিল্টার প্যারামিটার: daily_resting_heart_rate
রেকর্ডের ধরণ: দৈনিক

সামঞ্জস্যপূর্ণ ডিভাইস

 তালিকা করুন, সমন্বয় করুন .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
দৈনিক ঘুমের তাপমাত্রা নির্ণয়
ডেটাটাইপ: daily-sleep-temperature-derivations
ফিল্টার প্যারামিটার: daily_sleep_temperature_derivations তাপমাত্রা নির্ণয়
রেকর্ডের ধরণ: দৈনিক

সামঞ্জস্যপূর্ণ ডিভাইস

 তালিকা করুন, সমন্বয় করুন .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
ইলেক্ট্রোকার্ডিওগ্রাম (ইসিজি)
ডেটার ধরণ: electrocardiogram
ফিল্টার প্যারামিটার: electrocardiogram
রেকর্ডের ধরণ: সেশন

সামঞ্জস্যপূর্ণ ডিভাইস

 তালিকা .ecg.readonly
হৃদস্পন্দন
ডেটার ধরণ: heart-rate
ফিল্টার প্যারামিটার: heart_rate
রেকর্ডের ধরণ: নমুনা

সামঞ্জস্যপূর্ণ ডিভাইস

 তালিকা, সমন্বয়, একত্রীকরণ, দৈনিক একত্রীকরণ .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
হৃদস্পন্দন পরিবর্তনশীলতা
ডেটাটাইপ: heart-rate-variability
ফিল্টার প্যারামিটার: heart_rate_variability
রেকর্ডের ধরণ: নমুনা

সামঞ্জস্যপূর্ণ ডিভাইস

 তালিকা করুন, সমন্বয় করুন .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
অনিয়মিত ছন্দ বিজ্ঞপ্তি
ডেটাটাইপ: irregular-rhythm-notification
ফিল্টার প্যারামিটার: irregular_rhythm_notification
রেকর্ডের ধরণ: সেশন
 তালিকা .irn.readonly
অক্সিজেন স্যাচুরেশন
ডেটাটাইপ: oxygen-saturation
ফিল্টার প্যারামিটার: oxygen_saturation
রেকর্ডের ধরণ: নমুনা

সামঞ্জস্যপূর্ণ ডিভাইস

 তালিকা করুন, সমন্বয় করুন .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
শ্বাস-প্রশ্বাসের হার ঘুমের সারাংশ
ডেটাটাইপ: respiratory-rate-sleep-summary
ফিল্টার প্যারামিটার: respiratory_rate_sleep_summary
রেকর্ডের ধরণ: নমুনা

সামঞ্জস্যপূর্ণ ডিভাইস

 তালিকা করুন, সমন্বয় করুন .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly

শুধুমাত্র পঠনযোগ্য প্রয়োজনীয়তা

শারীরিক গুরুত্বপূর্ণ তথ্যের প্রকারগুলি ডিভাইস সিঙ্ক অথবা ফিটবিট মোবাইল বা ওয়েব অ্যাপে ম্যানুয়াল লগ এন্ট্রির মাধ্যমে পূরণ করা হয়, এবং REST API-এর মাধ্যমে এগুলি শুধুমাত্র পঠনযোগ্য (এগুলিতে সরাসরি Google Health API এন্ডপয়েন্টের মাধ্যমে লেখা বা পরিবর্তন করা যায় না)।

নিম্নলিখিত বিভাগগুলিতে ভাইটালস ডেটার প্রযুক্তিগত বিবরণ এবং REST উপস্থাপনার ফরম্যাট প্রদান করা হয়েছে।

হৃদস্পন্দন এবং হৃদপিণ্ডের স্বাস্থ্য

এপিআইটি হার্ট রেট মেট্রিক্সের জন্য দিনের মধ্যেকার বিস্তারিত পরিমাপ এবং দৈনিক সারসংক্ষেপ প্রদান করে:

  • হৃদস্পন্দন ( heart-rate ) : একটি নির্দিষ্ট সময়ের হৃদস্পন্দনের পরিমাপ, যাতে প্রতি মিনিটে স্পন্দনের সংখ্যা beatsPerMinute গণনার পাশাপাশি ব্যবহারকারীর motionContext (motionContext) (যেমন SEDENTARY বা ACTIVE ) এবং sensorLocation ) (যেমন WRIST বা CHEST ) অন্তর্ভুক্ত থাকে।
  • দৈনিক বিশ্রামকালীন হৃদস্পন্দন ( daily-resting-heart-rate ) : বিশ্রামকালীন হৃদস্পন্দনের একটি দৈনিক ভিত্তি মান।
  • হার্ট রেট ভ্যারিয়েবিলিটি ( heart-rate-variability এবং daily-heart-rate-variability ) : HRV উপস্থাপন করার জন্য পরপর পার্থক্যের রুট মিন স্কোয়ার ( rmssd ) মিলিসেকেন্ডে রেকর্ড করে।

REST উপস্থাপনার উদাহরণ

হৃদস্পন্দনের পরিমাপ জানতে, list এন্ডপয়েন্টে একটি GET রিকোয়েস্ট পাঠান।

নিম্নলিখিত উদাহরণটি ফেরত আসা তালিকা থেকে একটি একক heart-rate ডেটা পয়েন্ট দেখাচ্ছে:

অনুরোধ 

GET https://health.googleapis.com/v4/users/me/dataTypes/heart-rate/dataPoints?startTime=2026-04-20T08:00:00Z&endTime=2026-04-20T08:05:00Z
Authorization: Bearer access-token
Accept: application/json

প্রতিক্রিয়া 

{
  "dataPoints": [
    {
      "name": "users/me/dataTypes/heart-rate/dataPoints/hr-123456789",
      "dataSource": {
        "recordingMethod": "ACTIVELY_MEASURED"
      },
      "heartRate": {
        "sampleTime": {
          "physicalTime": "2026-04-20T08:00:00Z",
          "utcOffset": "0s"
        },
        "beatsPerMinute": "72",
        "metadata": {
          "motionContext": "SEDENTARY",
          "sensorLocation": "WRIST"
        }
      }
    }
  ]
}

রক্তে গ্লুকোজ

blood-glucose ডেটা টাইপটি ব্যবহারকারীর রক্তে শর্করার মাত্রা নির্দেশ করে। ব্লাড গ্লুকোজ পয়েন্টগুলোতে মিলিগ্রাম প্রতি ডেসিলিটার ( mg/dL ) এককে ঘনত্ব, খাবার বা সময়ের প্রেক্ষাপট এবং নমুনার তথ্য থাকে।

REST উপস্থাপনার উদাহরণ

রক্তের গ্লুকোজ পরিমাপ সম্পর্কে জানতে, list এন্ডপয়েন্টে একটি GET রিকোয়েস্ট পাঠান। নিম্নলিখিত উদাহরণটি ফেরত আসা তালিকা থেকে blood-glucose একটি ডেটা পয়েন্ট দেখাচ্ছে:

অনুরোধ 

GET https://health.googleapis.com/v4/users/me/dataTypes/blood-glucose/dataPoints?startTime=2026-04-20T08:00:00Z&endTime=2026-04-20T09:00:00Z
Authorization: Bearer access-token
Accept: application/json

প্রতিক্রিয়া 

{
  "dataPoints": [
    {
      "name": "users/me/dataTypes/blood-glucose/dataPoints/bg-987654321",
      "dataSource": {
        "recordingMethod": "MANUALLY_ENTERED"
      },
      "bloodGlucose": {
        "sampleTime": {
          "physicalTime": "2026-04-20T08:30:00Z",
          "utcOffset": "-25200s"
        },
        "bloodGlucoseMilligramsPerDeciliter": 95.0,
        "measurementSource": "SELF_MONITORING_BLOOD_GLUCOSE",
        "mealType": "BREAKFAST",
        "measurementTiming": "AFTER_MEAL",
        "specimen": "CAPILLARY_BLOOD",
        "notes": "Post-breakfast fingerstick reading"
      }
    }
  ]
}

অক্সিজেন স্যাচুরেশন (SpO2)

এপিআই oxygen-saturation (একই দিনের নমুনার মান) এবং daily-oxygen-saturation (দৈনিক সারসংক্ষেপ পরিসংখ্যান) ব্যবহার করে অক্সিজেনের মাত্রা ট্র্যাক করে। শতাংশ ঘনত্বকে 0 থেকে 100 পর্যন্ত একটি সংখ্যা হিসাবে প্রকাশ করা হয়।

REST উপস্থাপনার উদাহরণ

অক্সিজেন স্যাচুরেশন পরিমাপের তথ্য জানতে, list এন্ডপয়েন্টে একটি GET রিকোয়েস্ট পাঠান। নিম্নলিখিত উদাহরণটি ফেরত আসা তালিকা থেকে একটি একক oxygen-saturation ডেটা পয়েন্ট দেখাচ্ছে:

অনুরোধ 

GET https://health.googleapis.com/v4/users/me/dataTypes/oxygen-saturation/dataPoints?startTime=2026-04-20T03:00:00Z&endTime=2026-04-20T03:05:00Z
Authorization: Bearer access-token
Accept: application/json

প্রতিক্রিয়া 

{
  "dataPoints": [
    {
      "name": "users/me/dataTypes/oxygen-saturation/dataPoints/spo2-555555",
      "dataSource": {
        "recordingMethod": "ACTIVELY_MEASURED"
      },
      "oxygenSaturation": {
        "sampleTime": {
          "physicalTime": "2026-04-20T03:00:00Z",
          "utcOffset": "0s"
        },
        "percentage": 98.2
      }
    }
  ]
}

তাপমাত্রা

তাপমাত্রা পর্যবেক্ষণের মধ্যে অন্তর্ভুক্ত রয়েছে শরীরের মূল তাপমাত্রার পরিমাপ এবং সারারাত ঘুমের মধ্যে ত্বকের তাপমাত্রার প্রবণতা:

  • শরীরের মূল তাপমাত্রা ( core-body-temperature ) : অভ্যন্তরীণ অঙ্গের তাপমাত্রা সেলসিয়াস এককে রেকর্ড করে, এবং এর জন্য নির্দিষ্ট পরিমাপ স্থান (যেমন ARMPIT , EAR বা FOREHEAD ) উল্লেখ করতে হয়।
  • ঘুমের তাপমাত্রার নির্ণয় ( daily-sleep-temperature-derivations ) : সারারাত ধরে রেকর্ড করা ত্বকের তাপমাত্রার উচ্চ-ফ্রিকোয়েন্সির পরিবর্তন।

REST উপস্থাপনার উদাহরণ

শরীরের মূল তাপমাত্রার পরিমাপ জানতে, list এন্ডপয়েন্টে একটি GET রিকোয়েস্ট পাঠান। নিম্নলিখিত উদাহরণটি ফেরত আসা তালিকা থেকে core-body-temperature একটি একক ডেটা পয়েন্ট দেখাচ্ছে:

অনুরোধ 

GET https://health.googleapis.com/v4/users/me/dataTypes/core-body-temperature/dataPoints?startTime=2026-04-20T22:00:00Z&endTime=2026-04-20T23:00:00Z
Authorization: Bearer access-token
Accept: application/json

প্রতিক্রিয়া 

{
  "dataPoints": [
    {
      "name": "users/me/dataTypes/core-body-temperature/dataPoints/cbt-666666",
      "dataSource": {
        "recordingMethod": "ACTIVELY_MEASURED"
      },
      "coreBodyTemperature": {
        "sampleTime": {
          "physicalTime": "2026-04-20T22:30:00Z",
          "utcOffset": "-18000s"
        },
        "temperatureCelsius": 36.8,
        "measurementLocation": "FOREHEAD"
      }
    }
  ]
}

ইলেক্ট্রোকার্ডিওগ্রাম (ইসিজি) এবং বিজ্ঞপ্তি

মেডিকেল-গ্রেড সেন্সরযুক্ত ডিভাইসগুলির জন্য, এপিআই উন্নত হৃদস্বাস্থ্য ডেটা টাইপগুলি প্রকাশ করে:

  • ইলেকট্রোকার্ডিওগ্রাম ( electrocardiogram ) : একক-লিড ইসিজি সেশনের ফলাফল, যাতে একটি শ্রেণীবিভাগ ( SINUS_RHYTHM , ATRIAL_FIBRILLATION , INCONCLUSIVE ), গড় হৃদস্পন্দন, স্যাম্পলিং ফ্রিকোয়েন্সি এবং কাঁচা ওয়েভফর্ম ভোল্টেজ স্যাম্পল অন্তর্ভুক্ত থাকে।
  • অনিয়মিত ছন্দের বিজ্ঞপ্তি ( irregular-rhythm-notification ) : প্যাসিভ মনিটরিং চলাকালীন সনাক্ত হওয়া সম্ভাব্য AFib-এর লক্ষণ নির্দেশকারী প্রাসঙ্গিক সতর্কতা ইভেন্ট।

REST উপস্থাপনার উদাহরণ

ইলেকট্রোকার্ডিওগ্রাম সেশন ডেটা জানতে, list এন্ডপয়েন্টে একটি GET রিকোয়েস্ট পাঠান। নিচের উদাহরণটিতে ফেরত আসা তালিকা থেকে একটিমাত্র electrocardiogram ডেটা পয়েন্ট দেখানো হয়েছে:

অনুরোধ 

GET https://health.googleapis.com/v4/users/me/dataTypes/electrocardiogram/dataPoints?startTime=2026-04-20T10:00:00Z&endTime=2026-04-20T10:05:00Z
Authorization: Bearer access-token
Accept: application/json

প্রতিক্রিয়া 

{
  "dataPoints": [
    {
      "name": "users/me/dataTypes/electrocardiogram/dataPoints/ecg-777777",
      "dataSource": {
        "recordingMethod": "ACTIVELY_MEASURED"
      },
      "electrocardiogram": {
        "interval": {
          "startTime": "2026-04-20T10:00:00Z",
          "startUtcOffset": "0s",
          "endTime": "2026-04-20T10:00:30Z",
          "endUtcOffset": "0s"
        },
        "resultClassification": "SINUS_RHYTHM",
        "beatsPerMinuteAvg": "70",
        "samplingFrequencyHertz": 250,
        "millivoltsScalingFactor": 1000,
        "leadNumber": 1,
        "waveformSamples": [
          -12, -8, 4, 18, 30, 42, 50, 48, 32, 10
        ]
      }
    }
  ]
}

পরিধি এবং অনুমোদন

ভাইটালস এবং হার্ট হেলথ ডেটা ফিচারটি ব্যবহার করতে, আপনার অ্যাপকে অবশ্যই নিম্নলিখিত OAuth স্কোপগুলির জন্য অনুরোধ করতে হবে:

  • পড়ুন : https://www.googleapis.com/auth/googlehealth.ecg.readonly
  • পড়ুন : https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonly
  • লিখুন : https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.writeonly
  • পড়ুন : https://www.googleapis.com/auth/googlehealth.irn.readonly

নির্দেশিকা

ভাইটাল ও হেলথ মেট্রিক্স সহ ফিচার ডিজাইন করার সময় এই নির্দেশিকাগুলো ব্যবহার করুন:

  • একক রূপান্তর পরিচালনা করুন : তাপমাত্রার মান সেলসিয়াসে দেওয়া আছে। ব্যবহারকারীর স্থানীয় পছন্দের উপর ভিত্তি করে আপনার ফ্রন্টএন্ড কোডে এটিকে ফারেনহাইটে রূপান্তর করুন।
  • ওয়েবহুক নোটিফিকেশন পরিচালনা করুন : কোনো ব্যবহারকারী নতুন রিডিং (যেমন হার্ট রেট বা ব্লাড গ্লুকোজ) সিঙ্ক করার সাথে সাথেই ব্যাকএন্ড বিশ্লেষণ চালু করার জন্য ভাইটালস-এর ওয়েবহুক অ্যালার্টে সাবস্ক্রাইব করুন।
  • ডেটার সংবেদনশীলতার প্রতি সম্মান দেখান : নিশ্চিত করুন যে আপনার পণ্যটি ব্যবহারকারীদের কাছে উচ্চ-ফ্রিকোয়েন্সির শারীরবৃত্তীয় ভাইটালস পড়ার ক্লিনিক্যাল বা ওয়েলনেস প্রেক্ষাপট স্পষ্টভাবে ব্যাখ্যা করে। অথরাইজেশন প্রম্পট কল করার আগে health_metrics_and_measurements বা ecg মতো স্কোপগুলো কেন প্রয়োজন, তা ব্যাখ্যা করুন।
পূর্ববর্তী
ক্যালোরি এবং শক্তি
পরবর্তী
ওয়ার্কআউট