栄養データの種類

Google Health API には、ユーザーの食品摂取量と栄養情報を追跡するためのデータ型が用意されています。これらの型を使用すると、食事を記録したり、食品データベースから食品を参照したり、栄養素の量を追跡したりできます。

サポートされるデータ型

表: Google Health API の栄養データ型
データの種類
  dataType
  filter パラメータ		 記録
タイプ		 使用可能な
オペレーション		 スコープ Webhook
のサポート		 True zeros
のサポート
食品
  food
  food 		食品 list、get .nutrition.readonly
.nutrition.writeonly
食品の測定単位
  food-measurement-unit
  food_measurement_unit 		食品 list、get .nutrition.readonly
.nutrition.writeonly
栄養摂取量の記録
  nutrition-log
  nutrition_log 		サンプル list、get、reconcile、rollup、dailyRollup、create、update、batchDelete .nutrition.readonly
.nutrition.writeonly

栄養摂取量の記録

栄養摂取量の記録は、ユーザーが記録した食品を表します。食品の種類に応じて、栄養摂取量の記録を作成する方法は 2 つあります。

  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 フィールドを設定して 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
    }
  }
}

栄養摂取量の記録を削除する

1 つ以上の栄養摂取量の記録エントリを削除するには、削除するエントリのリソース名を使用して 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 をご覧ください。

{
  "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 Measurement Unit は、食品の提供に使用される測定単位（「カップ」、「大さじ」、「個」など）を表す読み取り専用のデータ型です。

使用可能な測定単位を一覧表示する

使用可能な測定単位を一覧表示するには:

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）を使用します。
前へ
ワークアウト