পুষ্টি তথ্য প্রকার

গুগল হেলথ এপিআই একজন ব্যবহারকারীর খাদ্য গ্রহণ এবং পুষ্টি সংক্রান্ত তথ্য ট্র্যাক করার জন্য বিভিন্ন ডেটা টাইপ প্রদান করে। এই টাইপগুলোর মাধ্যমে আপনি খাবারের বিবরণ লগ করতে, ফুড ডেটাবেস থেকে খাবার উল্লেখ করতে এবং পুষ্টি উপাদানের পরিমাণ ট্র্যাক করতে পারেন।

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

সারণি: গুগল হেলথ এপিআই পুষ্টি ডেটার প্রকারভেদ
ডেটা টাইপ
dataType
filter প্যারামিটার
রেকর্ড
প্রকার
উপলব্ধ
অপারেশন
পরিধি ওয়েবহুক
সমর্থন
প্রকৃত শূন্য
সমর্থন
খাবার
food
food
খাবার তালিকা, পেতে .nutrition.readonly
.nutrition.writeonly
খাদ্য পরিমাপের একক
food-measurement-unit
food_measurement_unit
খাবার তালিকা, পেতে .nutrition.readonly
.nutrition.writeonly
পুষ্টি লগ
nutrition-log
nutrition_log
নমুনা তালিকা, প্রাপ্তি, সমন্বয়, একত্রীকরণ, দৈনিক একত্রীকরণ, তৈরি, হালনাগাদ, ব্যাচ ডিলিট .nutrition.readonly
.nutrition.writeonly

পুষ্টি লগ

পুষ্টি লগ হলো ব্যবহারকারীর দ্বারা লিপিবদ্ধ করা খাবারের বিবরণ। খাবারের ধরনের ওপর নির্ভর করে পুষ্টি লগ তৈরি করার দুটি উপায় রয়েছে:

  1. শনাক্তকৃত খাদ্য : একটি বিদ্যমান খাদ্য উৎসকে নির্দেশ করতে food ক্ষেত্রটি সেট করুন। nutrients , energy , energyFromFat , totalCarbohydrate , totalFat এবং foodDisplayName ক্ষেত্রগুলি নির্দেশিত খাদ্য থেকে স্বয়ংক্রিয়ভাবে পূরণ হয়ে যায়। এটিই পছন্দনীয় পদ্ধতি।

  2. বেনামী খাবার : foodDisplayName ফিল্ডটি ম্যানুয়ালি সেট করুন এবং nutrients , energy , energyFromFat , totalCarbohydrate , ও totalFat এর জন্য মান প্রদান করুন। বেনামী খাবার থেকে তৈরি পুষ্টি লগ একবার তৈরি হয়ে গেলে আর সম্পাদনাযোগ্য থাকে না।

বেনামী খাবার দিয়ে পুষ্টির লগ তৈরি করুন

পুষ্টি সংক্রান্ত লগ এন্ট্রি তৈরি করতে, nutrition-log data points এন্ডপয়েন্টে একটি POST অনুরোধ পাঠান।

অনুরোধ

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

{
  "nutritionLog": {
    "interval": {
      "startTime": "2026-06-16T18:00:00Z",
      "endTime": "2026-06-16T18:30:00Z"
    },
    "foodDisplayName": "Grilled Chicken Breast",
    "mealType": "DINNER",
    "energy": {
      "kcal": 165
    },
    "totalCarbohydrate": {
      "grams": 0
    },
    "totalFat": {
      "grams": 3.6
    },
    "nutrients": [
      {
        "nutrient": "PROTEIN",
        "quantity": {
          "grams": 31
        }
      },
      {
        "nutrient": "SODIUM",
        "quantity": {
          "grams": 0.074
        }
      }
    ],
    "serving": {
      "amount": 1.0
    }
  }
}

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

{
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.devicesandservices.health.v4.DataPoint",
    "name": "users/user-id/dataTypes/nutrition-log/dataPoints/data-point-id",
    "dataSource": {
      "recordingMethod": "UNKNOWN",
      "application": {
        "googleWebClientId": "google-web-client-id"
      },
      "platform": "GOOGLE_WEB_API"
    },
    "nutritionLog": {
      "interval": {
        "startTime": "2026-06-16T18:00:00Z",
        "startUtcOffset": "0s",
        "endTime": "2026-06-16T18:30:00Z",
        "endUtcOffset": "0s",
        "civilStartTime": {
          "date": {
            "year": 2026,
            "month": 6,
            "day": 16
          },
          "time": {
            "hours": 18
          }
        },
        "civilEndTime": {
          "date": {
            "year": 2026,
            "month": 6,
            "day": 16
          },
          "time": {
            "hours": 18,
            "minutes": 30
          }
        }
      },
      "energy": {
        "kcal": 165
      },
      "totalCarbohydrate": {
        "grams": 0
      },
      "totalFat": {
        "grams": 3.6
      },
      "nutrients": [
        {
          "quantity": {
            "grams": 31
          },
          "nutrient": "PROTEIN"
        },
        {
          "quantity": {
            "grams": 0.074
          },
          "nutrient": "SODIUM"
        }
      ],
      "mealType": "DINNER",
      "serving": {
        "amount": 1
      },
      "foodDisplayName": "Grilled Chicken Breast"
    }
  }
}

চিহ্নিত খাবার দিয়ে পুষ্টির তালিকা তৈরি করুন

খাদ্য ডাটাবেস থেকে কোনো খাদ্যদ্রব্য লগ করতে, food ফিল্ডটিকে একটি ফুড রিসোর্স রেফারেন্স করার জন্য সেট করুন। এপিআই স্বয়ংক্রিয়ভাবে পুষ্টি সংক্রান্ত ফিল্ডগুলি পূরণ করে দেয়।

অনুরোধ:

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

{
  "nutritionLog": {
    "interval": {
      "startTime": "2026-06-16T12:00:00Z",
      "endTime": "2026-06-16T12:30:00Z"
    },
    "food": "users/me/dataTypes/food/dataPoints/food-id",
    "mealType": "LUNCH",
    "serving": {
      "amount": 1.0
    }
  }
}

পুষ্টি লগগুলি মুছে ফেলুন

এক বা একাধিক পুষ্টি লগ এন্ট্রি মুছে ফেলার জন্য, যে এন্ট্রিগুলো মুছতে চান সেগুলোর রিসোর্স নামসহ batchDelete এন্ডপয়েন্টে একটি POST অনুরোধ পাঠান।

অনুরোধ:

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

{
  "names": [
    "users/me/dataTypes/nutrition-log/dataPoints/data-point-id"
  ]
}

নিউট্রিশনলগ ক্ষেত্রগুলি

ফিল্ড ও সেগুলোর বিবরণের সম্পূর্ণ তালিকার জন্য রেফারেন্স ডকুমেন্টেশন দেখুন।

শক্তির পরিমাণ

এটি শক্তির একটি পরিমাপ, যা কিলোক্যালরি ( kcal ) এককে পরিমাপ করা হয়। বিস্তারিত জানতে, EnergyQuantity দেখুন।

{
  "kcal": 165
}

ওজন পরিমাণ

এটি ওজনের একটি পরিমাপ, যা গ্রামে পরিমাপ করা হয়। বিস্তারিত জানতে, ওজন-পরিমাণ দেখুন।

{
  "grams": 27.3
}

পুষ্টির পরিমাণ

একটি নির্দিষ্ট পুষ্টি উপাদান এবং তার পরিমাপকৃত পরিমাণকে বোঝায়। বিস্তারিত জানতে, পুষ্টি উপাদানের পরিমাণ (NutrientQuantity ) দেখুন।

{
  "nutrient": "PROTEIN",
  "quantity": {
    "grams": 31
  }
}

পুষ্টির মান

সমর্থিত পুষ্টি উপাদানের সম্পূর্ণ তালিকার জন্য, পুষ্টি উপাদান দেখুন।

পরিবেশন করা

পুষ্টি লগ এন্ট্রির জন্য পরিবেশন সংক্রান্ত তথ্য উপস্থাপন করে। বিস্তারিত জানতে, পরিবেশন (Serving) দেখুন।

{
  "amount": 1.5
}

খাবারের ধরণের মান

সমর্থিত খাবারের প্রকারের সম্পূর্ণ তালিকার জন্য, খাবারের প্রকার (MealType ) দেখুন।

খাবার

Food হলো একটি রিড-অনলি ডেটা টাইপ যা ফুড ডাটাবেসের একটি খাদ্যদ্রব্যকে উপস্থাপন করে। উপলব্ধ খাবারগুলো ব্রাউজ করতে এবং সেগুলোর পুষ্টিগত তথ্য পেতে listget অপারেশন ব্যবহার করুন।

খাবারের তালিকা

খাবারের তালিকা পেতে, food ডেটা পয়েন্টস এন্ডপয়েন্টে একটি GET রিকোয়েস্ট পাঠান:

GET https://health.googleapis.com/v4/users/me/dataTypes/food/dataPoints
Authorization: Bearer access-token
Accept: application/json

খাদ্য পরিমাপের একক

খাদ্য পরিমাপ একক হলো একটি পঠনযোগ্য ডেটা টাইপ যা খাদ্য পরিবেশনে ব্যবহৃত পরিমাপের একককে বোঝায় (উদাহরণস্বরূপ, 'কাপ', 'টেবিল চামচ', বা 'পিস')।

উপলব্ধ পরিমাপের এককগুলির তালিকা

উপলব্ধ পরিমাপের এককগুলির তালিকা করতে:

GET https://health.googleapis.com/v4/users/me/dataTypes/food-measurement-unit/dataPoints
Authorization: Bearer access-token
Accept: application/json

নির্দেশিকা

  • সম্ভব হলে চিহ্নিত খাবার ব্যবহার করুন। এপিআই স্বয়ংক্রিয়ভাবে পুষ্টি সংক্রান্ত ক্ষেত্রগুলি পূরণ করে, যা ত্রুটি কমায় এবং খাদ্য ডেটাবেসের সাথে সামঞ্জস্য নিশ্চিত করে।
  • বেনামী খাবার থেকে তৈরি করা পুষ্টির লগ একবার তৈরি হয়ে গেলে আর আপডেট করা যায় না। যদি কোনো বেনামী খাবারের লগ সংশোধন করার প্রয়োজন হয়, তবে সেটি মুছে ফেলুন এবং একটি নতুন লগ তৈরি করুন।
  • nutrients তালিকায় থাকা সমস্ত পুষ্টি উপাদানের পরিমাণ পরিমাপের একক হিসেবে গ্রাম ব্যবহার করে।
  • energy এবং energyFromFat ক্ষেত্রগুলিতে পরিমাপের একক হিসাবে কিলোক্যালরি ( kcal ) ব্যবহার করা হয়।