पोषण से जुड़े डेटा के टाइप

Google Health API, उपयोगकर्ता के खाने-पीने की आदतों और पोषण से जुड़ी जानकारी को ट्रैक करने के लिए, डेटा टाइप उपलब्ध कराता है. इन टाइप की मदद से, खाने-पीने की चीज़ों को लॉग किया जा सकता है. साथ ही, फ़ूड डेटाबेस से खाने-पीने की चीज़ों का रेफ़रंस लिया जा सकता है और पोषक तत्वों की मात्रा को ट्रैक किया जा सकता है.

डेटा टाइप, जो इस्तेमाल किए जा सकते हैं

टेबल: Google Health API के पोषण से जुड़े डेटा टाइप

डेटा टाइप   dataType   filter पैरामीटर	Record type	उपलब्ध कार्रवाइयां	दायरा	वेबबुक support	ट्रू ज़ीरो की सुविधा
खाना   food   food	खाना	सूची, पाएं	.nutrition.readonly .nutrition.writeonly
खाने की चीज़ों के मेज़रमेंट की यूनिट   food-measurement-unit   food_measurement_unit	खाना	सूची, पाएं	.nutrition.readonly .nutrition.writeonly
पोषण से जुड़ा डेटा लॉग करें   nutrition-log   nutrition_log	नमूना	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	.nutrition.readonly .nutrition.writeonly

पोषण से जुड़ा डेटा लॉग करना

पोषण से जुड़े डेटा लॉग में, उपयोगकर्ता के लॉग किए गए भोजन की जानकारी होती है. खाने-पीने की चीज़ों के हिसाब से, न्यूट्रिशन लॉग बनाने के दो तरीके हैं:

1. पहचाना गया खाना: food फ़ील्ड को सेट करके, मौजूदा Food संसाधन का रेफ़रंस दें. nutrients, energy, energyFromFat, totalCarbohydrate, totalFat, और foodDisplayName फ़ील्ड में, रेफ़र किए गए खाने-पीने के आइटम की जानकारी अपने-आप भर जाती है. यह सबसे सही तरीका है.

2. बिना नाम वाला खाना: foodDisplayName फ़ील्ड को मैन्युअल तरीके से सेट करें. साथ ही, nutrients, energy, energyFromFat, totalCarbohydrate, और totalFat के लिए वैल्यू दें. बिना पहचान बताए जोड़े गए खाने-पीने के आइटम के न्यूट्रिशन लॉग में बदलाव नहीं किया जा सकता.

गुमनाम फ़ूड के साथ पोषण लॉग बनाना

पोषण से जुड़ी जानकारी को लॉग करने के लिए, nutrition-log डेटा पॉइंट एंडपॉइंट को 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
    }
  }
}

ध्यान दें: खाने के मान्य आईडी पाने के लिए, nutrition.readonly स्कोप के साथ food डेटा टाइप पर list ऑपरेशन का इस्तेमाल करें.

पोषण से जुड़े लॉग मिटाना

पोषण से जुड़ी एक या उससे ज़्यादा लॉग एंट्री मिटाने के लिए, POST अनुरोध को batchDelete एंडपॉइंट पर भेजें. इसमें उन एंट्री के संसाधन के नाम शामिल करें जिन्हें मिटाना है.

अनुरोध:

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

NutritionLog फ़ील्ड

फ़ील्ड और उनके ब्यौरे की पूरी सूची देखने के लिए, रेफ़रंस दस्तावेज़ देखें.

EnergyQuantity

यह एनर्जी मेज़रमेंट को दिखाता है, जिसे किलोकैलोरी (kcal) में मापा जाता है. ज़्यादा जानकारी के लिए, EnergyQuantity देखें.

{
  "kcal": 165
}

WeightQuantity

यह वज़न की जानकारी दिखाता है, जिसे ग्राम में मेज़र किया जाता है. ज़्यादा जानकारी के लिए, WeightQuantity देखें.

{
  "grams": 27.3
}

NutrientQuantity

यह किसी खास पोषक तत्व और उसकी मात्रा को दिखाता है. ज़्यादा जानकारी के लिए, NutrientQuantity देखें.

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

पोषक तत्वों की वैल्यू

पोषक तत्वों के टाइप की पूरी सूची देखने के लिए, पोषक तत्व देखें.

सेवा में है

यह न्यूट्रिशन लॉग एंट्री के लिए, एक बार में परोसे जाने वाले खाने की जानकारी दिखाता है. ज़्यादा जानकारी के लिए, विज्ञापन दिखाना लेख पढ़ें.

{
  "amount": 1.5
}

MealType वैल्यू

इस्तेमाल किए जा सकने वाले खाने के टाइप की पूरी सूची देखने के लिए, MealType देखें.

खाना

Food, सिर्फ़ पढ़ने के लिए उपलब्ध डेटा टाइप है. यह फ़ूड डेटाबेस में मौजूद किसी खाने की चीज़ को दिखाता है. उपलब्ध खाद्य पदार्थों को ब्राउज़ करने और उनकी पोषण से जुड़ी जानकारी पाने के लिए, list और get कार्रवाइयों का इस्तेमाल करें.

खाने की चीज़ों की सूची

भोजन की सूची बनाने के लिए, food डेटा पॉइंट एंडपॉइंट पर GET अनुरोध भेजें:

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

ध्यान दें: food डेटा टाइप, रीड-ओनली होता है. एपीआई के ज़रिए, खाने-पीने के सामान को न तो बनाया जा सकता है और न ही उनमें बदलाव किया जा सकता है.

खाने की मेज़रमेंट यूनिट

फ़ूड मेज़रमेंट यूनिट, सिर्फ़ पढ़ने के लिए उपलब्ध डेटा टाइप है. यह खाने की मात्रा के लिए इस्तेमाल की जाने वाली मेज़रमेंट यूनिट को दिखाता है. उदाहरण के लिए, "कप", "चम्मच" या "टुकड़ा".

माप की उपलब्ध इकाइयों की सूची

माप की उपलब्ध इकाइयों की सूची देखने के लिए:

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

दिशा-निर्देश

• जब हो सके, तब पहचाने गए खाने-पीने के सामान का इस्तेमाल करें. यह एपीआई, पोषण से जुड़े फ़ील्ड में अपने-आप जानकारी भरता है. इससे गड़बड़ियां कम होती हैं और फ़ूड डेटाबेस के साथ जानकारी में एकरूपता बनी रहती है.
• बिना नाम वाले खाने-पीने के आइटम से बनाए गए पोषण के लॉग में, लॉग बनाने के बाद बदलाव नहीं किया जा सकता. अगर आपको नाम छिपाकर बनाए गए फ़ूड लॉग में बदलाव करना है, तो उसे मिटाकर नया फ़ूड लॉग बनाएं.
• nutrients ऐरे में मौजूद सभी पोषक तत्वों की मात्रा को ग्राम में मेज़र किया जाता है.
• energy और energyFromFat फ़ील्ड में, मेज़रमेंट की इकाई के तौर पर किलोकैलोरी (kcal) का इस्तेमाल किया जाता है.