女性健康数据类型

Google Health API 提供用于跟踪生殖健康、症状和情绪的数据类型。借助这些类型，您可以记录经期、排卵检测结果以及相关的身体和情绪状态。

支持的数据类型

表格：Google Health API 女性健康数据类型
数据类型 可用的
操作		 范围
月经期
dataType： menstrual-period
过滤参数： menstrual_period
记录类型： 间隔
 create、update、batchDelete .reproductive_health.writeonly
情绪
dataType： moods
过滤参数： moods
记录类型： 示例
 create、update、batchDelete .mindfulness.writeonly
排卵检测
dataType： ovulation-test
过滤参数： ovulation_test
记录类型： 示例
 create、update、batchDelete .reproductive_health.writeonly
症状
dataType： symptoms
过滤参数： symptoms
记录类型： 示例
 create、update、batchDelete .logged_symptoms.writeonly

经期

经期表示用户记录的经期时间段。如需查看完整的字段列表和说明，请参阅 MenstrualPeriod。

记录时段准则

  • 必须提供结束日期：所有周期记录都必须包含结束日期或时间。结束日期绝不应为 null。
  • 处理持续性时段：如果您在创建记录时无法提供结束日期（例如，如果时段仍在持续），请将结束日期设置为与开始日期相同。每天更新记录，将结束日期设置为当前日期，直到周期结束并确认最终结束日期。
  • 已确认的经期：所有经期记录均视为已确认的经期。

创建经期

如需创建经期条目，请向 menstrual-period 数据点端点发送 POST 请求。响应中包含 name 字段，其中包含 data-point-id，该字段可用于批量删除或更新 (Patch) 请求。

请求

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

{
  "menstrualPeriod": {
    "interval": {
      "startTime": "2026-07-01T08:00:00Z",
      "endTime": "2026-07-05T20:00:00Z"
    },
    "notes": "Regular flow reported."
  }
}

响应

{
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.devicesandservices.health.v4.DataPoint",
    "name": "users/user-id/dataTypes/menstrual-period/dataPoints/data-point-id",
    "menstrualPeriod": {
      "interval": {
        "startTime": "2026-07-01T08:00:00Z",
        "startUtcOffset": "0s",
        "endTime": "2026-07-05T20:00:00Z",
        "endUtcOffset": "0s",
        "civilStartTime": {
          "date": { "year": 2026, "month": 7, "day": 1 },
          "time": { "hours": 8 }
        },
        "civilEndTime": {
          "date": { "year": 2026, "month": 7, "day": 5 },
          "time": { "hours": 20 }
        }
      },
      "notes": "Regular flow reported."
    }
  }
}

排卵检测

记录排卵检测观测结果。如需查看字段和说明的完整列表，请参阅 OvulationTest。

创建排卵检测

如需记录排卵检测结果，请向 ovulation-test 数据点端点发送 POST 请求。响应中包含 name 字段，其中包含 data-point-id，可用于批量删除或更新 (Patch) 请求。

请求

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

{
  "ovulationTest": {
    "sampleTime": {
      "physicalTime": "2026-07-14T07:30:00Z"
    },
    "result": "LUTEINIZING_HORMONE_SURGE"
  }
}

响应

{
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.devicesandservices.health.v4.DataPoint",
    "name": "users/user-id/dataTypes/ovulation-test/dataPoints/data-point-id",
    "ovulationTest": {
      "sampleTime": {
        "physicalTime": "2026-07-14T07:30:00Z",
        "utcOffset": "0s",
        "civilTime": {
          "date": { "year": 2026, "month": 7, "day": 14 },
          "time": { "hours": 7, "minutes": 30 }
        }
      },
      "result": "LUTEINIZING_HORMONE_SURGE"
    }
  }
}

表现

记录在给定时间戳出现的身体症状。如需查看完整的字段列表和说明，请参阅 Symptoms。

创建症状日志

如需记录身体症状，请向 symptoms 数据点端点发送 POST 请求。响应中包含 name 字段，其中包含 data-point-id，该字段可用于批量删除或更新 (Patch) 请求。

请求

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

{
  "symptoms": {
    "sampleTime": {
      "physicalTime": "2026-07-02T19:00:00Z"
    },
    "symptoms": [ "CRAMPS", "BLOATED", "FATIGUE" ]
  }
}

响应

{
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.devicesandservices.health.v4.DataPoint",
    "name": "users/user-id/dataTypes/symptoms/dataPoints/data-point-id",
    "symptoms": {
      "sampleTime": {
        "physicalTime": "2026-07-02T19:00:00Z",
        "utcOffset": "0s",
        "civilTime": {
          "date": { "year": 2026, "month": 7, "day": 2 },
          "time": { "hours": 19 }
        }
      },
      "symptoms": [ "CRAMPS", "BLOATED", "FATIGUE" ]
    }
  }
}

心情

记录给定时间戳的情绪状态和价位。如需查看完整的字段列表和说明，请参阅 Moods。

创建情绪记录

如需记录情绪状态，请向 moods 数据点端点发送 POST 请求。响应中包含 name 字段，其中包含 data-point-id，该字段可用于批量删除或更新 (Patch) 请求。

请求

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

{
  "moods": {
    "sampleTime": {
      "physicalTime": "2026-07-02T21:00:00Z"
    },
    "moods": [ "CALM", "CONTENT" ],
    "valences": [ "PLEASANT" ]
  }
}

响应

{
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.devicesandservices.health.v4.DataPoint",
    "name": "users/user-id/dataTypes/moods/dataPoints/data-point-id",
    "moods": {
      "sampleTime": {
        "physicalTime": "2026-07-02T21:00:00Z",
        "utcOffset": "0s",
        "civilTime": {
          "date": { "year": 2026, "month": 7, "day": 2 },
          "time": { "hours": 21 }
        }
      },
      "moods": [ "CALM", "CONTENT" ],
      "valences": [ "PLEASANT" ]
    }
  }
}

批量删除

如需删除一个或多个数据点，请向 batchDelete 端点发送 POST 请求，并提供要移除的条目的资源名称。

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

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

示例：删除多个数据点

如需在单个请求中删除多个数据点，请在 names 数组中添加相应数据点的资源名称。

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

{
  "names": [
    "users/user-id/dataTypes/symptoms/dataPoints/symptom-id-1",
    "users/user-id/dataTypes/symptoms/dataPoints/symptom-id-2"
  ]
}