انواع داده‌های سلامت زنان

رابط برنامه‌نویسی کاربردی گوگل هلث (Google Health API) انواع داده‌ها را برای ردیابی سلامت باروری، علائم و خلق و خو ارائه می‌دهد. این انواع داده‌ها به شما امکان می‌دهند دوره‌های قاعدگی، نتایج آزمایش تخمک‌گذاری و حالات جسمی و عاطفی مرتبط را ثبت کنید.

انواع داده پشتیبانی شده

جدول: انواع داده‌های سلامت زنان در API گوگل هلث
نوع داده موجود است
عملیات		 محدوده
دوره قاعدگی
نوع داده: menstrual-period
پارامتر فیلتر: menstrual_period
نوع رکورد: فاصله‌ای
 ایجاد، به‌روزرسانی، حذف دسته‌ای .reproductive_health.writeonly
خلق و خو
نوع داده: moods
پارامتر فیلتر: moods
نوع رکورد: نمونه
 ایجاد، به‌روزرسانی، حذف دسته‌ای .mindfulness.writeonly
آزمایش تخمک گذاری
نوع داده: ovulation-test
پارامتر فیلتر: ovulation_test
نوع رکورد: نمونه
 ایجاد، به‌روزرسانی، حذف دسته‌ای .reproductive_health.writeonly
علائم
نوع داده: symptoms
پارامتر فیلتر: symptoms
نوع رکورد: نمونه
 ایجاد، به‌روزرسانی، حذف دسته‌ای .logged_symptoms.writeonly

دوره قاعدگی

یک دوره قاعدگی نشان دهنده یک بازه زمانی ثبت شده توسط کاربر است. برای مشاهده لیست کامل فیلدها و توضیحات، به MenstrualPeriod مراجعه کنید.

دستورالعمل‌هایی برای دوره‌های ثبت وقایع

  • تاریخ‌های پایان الزامی هستند : تمام رکوردهای دوره باید شامل تاریخ یا زمان پایان باشند. تاریخ‌های پایان هرگز نباید تهی (null) باشند.
  • مدیریت دوره‌های جاری : اگر نمی‌توانید هنگام ایجاد رکورد، تاریخ پایان را ارائه دهید (برای مثال، اگر دوره در حال انجام است)، تاریخ پایان را طوری تنظیم کنید که با تاریخ شروع مطابقت داشته باشد. رکورد را روزانه به‌روزرسانی کنید و تاریخ پایان را روی تاریخ فعلی تنظیم کنید تا دوره به پایان برسد و تاریخ پایان نهایی تأیید شود.
  • دوره‌های تأیید شده : تمام سوابق دوره به عنوان دوره‌های تأیید شده در نظر گرفته می‌شوند.

ایجاد دوره قاعدگی

برای ایجاد یک ورودی دوره قاعدگی، یک درخواست POST به نقطه پایانی نقاط داده menstrual-period ارسال کنید. پاسخ شامل فیلد name حاوی data-point-id است که می‌تواند در درخواست حذف دسته‌ای یا به‌روزرسانی (وصله) استفاده شود.

درخواست 

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 مراجعه کنید.

یک تست تخمک گذاری ایجاد کنید

برای ثبت نتیجه آزمایش تخمک‌گذاری، یک درخواست POST به نقطه پایانی نقاط داده ovulation-test ارسال کنید. پاسخ شامل فیلد name حاوی data-point-id است که می‌تواند در درخواست حذف دسته‌ای یا به‌روزرسانی (وصله) استفاده شود.

درخواست 

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 مراجعه کنید.

ایجاد گزارش علائم

برای ثبت علائم فیزیکی، یک درخواست POST به نقطه پایانی نقاط داده symptoms ارسال کنید. پاسخ شامل فیلد name حاوی data-point-id است که می‌تواند در درخواست حذف دسته‌ای یا به‌روزرسانی (وصله) استفاده شود.

درخواست 

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 مراجعه کنید.

یک گزارش خلق و خو ایجاد کنید

برای ثبت حالات عاطفی، یک درخواست POST به نقطه پایانی نقاط داده مربوط به moods ارسال کنید. پاسخ شامل فیلد name حاوی data-point-id است که می‌تواند در درخواست حذف دسته‌ای یا به‌روزرسانی (وصله) استفاده شود.

درخواست 

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

حذف دسته‌ای

برای حذف یک یا چند نقطه داده، یک درخواست POST به نقطه پایانی batchDelete به همراه نام منابع ورودی‌های مورد نظر برای حذف ارسال کنید.

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