Các loại dữ liệu sức khoẻ phụ nữ

Google Health API cung cấp các loại dữ liệu để theo dõi sức khoẻ sinh sản, các triệu chứng và tâm trạng. Những loại dữ liệu này cho phép bạn ghi nhật ký kỳ kinh nguyệt, kết quả kiểm tra rụng trứng và các trạng thái thể chất cũng như cảm xúc liên quan.

Các loại dữ liệu được hỗ trợ

Bảng: Các loại dữ liệu sức khoẻ phụ nữ trong Google Health API
Loại dữ liệu Các thao tác
có thể thực hiện		 Phạm vi
Kỳ kinh nguyệt
dataType: menstrual-period
tham số bộ lọc: menstrual_period
Loại bản ghi: Khoảng thời gian
 create, update, batchDelete .reproductive_health.writeonly
Tâm trạng
dataType: moods
tham số bộ lọc: moods
Loại bản ghi: Mẫu
 create, update, batchDelete .mindfulness.writeonly
Que thử rụng trứng
dataType: ovulation-test
tham số bộ lọc: ovulation_test
Loại bản ghi: Mẫu
 create, update, batchDelete .reproductive_health.writeonly
Triệu chứng
dataType: symptoms
tham số bộ lọc: symptoms
Loại bản ghi: Mẫu
 create, update, batchDelete .logged_symptoms.writeonly

Kỳ kinh nguyệt

Kỳ kinh nguyệt là khoảng thời gian được người dùng ghi lại. Để xem danh sách đầy đủ các trường và nội dung mô tả, hãy xem MenstrualPeriod.

Nguyên tắc về khoảng thời gian ghi nhật ký

  • Ngày kết thúc là bắt buộc: Tất cả bản ghi về khoảng thời gian phải có ngày hoặc giờ kết thúc. Ngày kết thúc không được để trống.
  • Xử lý các khoảng thời gian đang diễn ra: Nếu bạn không thể cung cấp ngày kết thúc khi tạo bản ghi (ví dụ: nếu khoảng thời gian đang diễn ra), hãy đặt ngày kết thúc trùng với ngày bắt đầu. Cập nhật bản ghi hằng ngày, đặt ngày kết thúc thành ngày hiện tại cho đến khi khoảng thời gian kết thúc và ngày kết thúc cuối cùng được xác nhận.
  • Kỳ kinh đã xác nhận: Tất cả bản ghi kỳ kinh đều được coi là kỳ kinh đã xác nhận.

Tạo kỳ kinh nguyệt

Để tạo một mục nhập về kỳ kinh nguyệt, hãy gửi yêu cầu POST đến điểm cuối dữ liệu menstrual-period. Phản hồi này bao gồm trường name chứa data-point-id. Bạn có thể dùng trường này trong yêu cầu Xoá hàng loạt hoặc Cập nhật (Bản vá).

Yêu cầu

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

Phản hồi

{
  "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."
    }
  }
}

Kiểm tra sự rụng trứng

Ghi lại thông tin quan sát về kết quả kiểm tra rụng trứng. Để xem danh sách đầy đủ các trường và nội dung mô tả, hãy xem OvulationTest.

Tạo một bài kiểm tra rụng trứng

Để ghi lại kết quả xét nghiệm rụng trứng, hãy gửi yêu cầu POST đến điểm cuối ovulation-test của dữ liệu. Phản hồi này bao gồm trường name chứa data-point-id. Bạn có thể dùng trường này trong yêu cầu Xoá hàng loạt hoặc Cập nhật (Patch).

Yêu cầu

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

Phản hồi

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

Hiện tượng

Ghi lại các triệu chứng thực thể xuất hiện tại một dấu thời gian nhất định. Để xem danh sách đầy đủ các trường và nội dung mô tả, hãy xem Symptoms.

Tạo nhật ký triệu chứng

Để ghi lại các triệu chứng thực thể, hãy gửi yêu cầu POST đến điểm cuối symptoms. Phản hồi này bao gồm trường name chứa data-point-id. Bạn có thể dùng trường này trong yêu cầu Xoá hàng loạt hoặc Cập nhật (Patch).

Yêu cầu

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

Phản hồi

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

Tâm trạng

Ghi lại trạng thái cảm xúc và giá trị tại một dấu thời gian nhất định. Để xem danh sách đầy đủ các trường và nội dung mô tả, hãy xem Moods.

Tạo nhật ký tâm trạng

Để ghi lại trạng thái cảm xúc, hãy gửi yêu cầu POST đến điểm cuối dữ liệu moods. Phản hồi này bao gồm trường name chứa data-point-id. Bạn có thể dùng trường này trong yêu cầu Xoá hàng loạt hoặc Cập nhật (Patch).

Yêu cầu

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

Phản hồi

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

Xoá hàng loạt

Để xoá một hoặc nhiều điểm dữ liệu, hãy gửi yêu cầu POST đến điểm cuối batchDelete kèm theo tên tài nguyên của các mục cần xoá.

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

Ví dụ: Xoá nhiều điểm dữ liệu

Để xoá nhiều điểm dữ liệu trong một yêu cầu, hãy thêm tên tài nguyên của các điểm dữ liệu đó vào mảng 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"
  ]
}