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

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

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

टेबल: Google Health API के पोषण से जुड़े डेटा टाइप
डेटा टाइप
  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 डेटा पॉइंट के एंडपॉइंट पर 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 फ़ील्ड को सेट करके, खाने-पीने की चीज़ के संसाधन का रेफ़रंस दें. API, पोषण से जुड़े फ़ील्ड को अपने-आप भर देता है.

अनुरोध:

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

NutritionLog फ़ील्ड

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

EnergyQuantity

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

{
  "kcal": 165
}

WeightQuantity

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

{
  "grams": 27.3
}

NutrientQuantity

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

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

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

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

Serving

यह पोषण से जुड़े लॉग की एंट्री के लिए, सर्विंग की जानकारी दिखाता है. ज़्यादा जानकारी के लिए, Serving देखें.

{
  "amount": 1.5
}

MealType की वैल्यू

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

खाना

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

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

खाने-पीने की चीज़ों की सूची बनाने के लिए, 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

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

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