栄養データの種類

Google Health API は、ユーザーの食事摂取量と栄養情報をトラッキングするためのデータ型を提供します。これらのタイプを使用すると、食事の記録、食品データベースからの食品の参照、栄養素量の追跡を行うことができます。

サポートされるデータタイプ

表: Google Health API の栄養データ型
データ型
  dataType
  filter パラメータ		 Record
type		 利用可能な
オペレーション		 スコープ Webhook
サポート		 真のゼロの
サポート
食べ物
  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
  }
}

栄養素の値

サポートされている栄養素の種類の完全なリストについては、栄養素をご覧ください。

サービス提供

栄養ログエントリのサービング情報を表します。詳細については、サービングをご覧ください。

{
  "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）が使用されます。
前へ
ワークアウト
次へ
手順