أنواع بيانات صحة المرأة

توفّر Google Health API أنواع بيانات لتتبُّع الصحة الإنجابية والأعراض والحالات المزاجية. تسمح لك هذه الأنواع بتسجيل فترات الحيض ونتائج اختبار الإباضة والحالات الجسدية والعاطفية المرتبطة بها.

أنواع البيانات المتوافقة

الجدول: أنواع بيانات "صحة المرأة" في Google Health API
نوع البيانات العمليات
المتاحة		 النطاق
الحيض
dataType: menstrual-period
filter parameter: menstrual_period
نوع السجلّ: Interval
 create, update, batchDelete .reproductive_health.writeonly
مزاج
dataType: moods
filter parameter: moods
نوع السجلّ: Sample
 create, update, batchDelete .mindfulness.writeonly
اختبار الإباضة
dataType: ovulation-test
filter parameter: ovulation_test
نوع السجلّ: Sample
 create, update, batchDelete .reproductive_health.writeonly
الأعراض
dataType: symptoms
filter parameter: symptoms
نوع السجلّ: Sample
 create, update, batchDelete .logged_symptoms.writeonly

الحيض

يمثّل الحيض فترة زمنية يسجّلها المستخدم. للاطّلاع على قائمة كاملة بالحقول والأوصاف، يُرجى الاطّلاع على MenstrualPeriod.

إرشادات حول تسجيل فترات الحيض

  • يجب إدخال تاريخ الانتهاء: يجب أن تتضمّن جميع سجلّات الحيض تاريخ انتهاء أو وقت انتهاء. يجب ألا تكون تواريخ الانتهاء فارغة.
  • التعامل مع فترات الحيض المستمرة: إذا لم تتمكّن من تقديم تاريخ انتهاء عند إنشاء السجلّ (على سبيل المثال، إذا كانت فترة الحيض مستمرة)، اضبط تاريخ الانتهاء ليتطابق مع تاريخ البدء. عدِّل السجلّ يوميًا، واضبط تاريخ الانتهاء على التاريخ الحالي، إلى أن تنتهي فترة الحيض ويتم تأكيد تاريخ الانتهاء النهائي.
  • فترات الحيض المؤكَّدة: يتم التعامل مع جميع سجلّات الحيض على أنّها فترات حيض مؤكَّدة.

إنشاء فترة حيض

لإنشاء إدخال لفترة الحيض، أرسِل طلب 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"
  ]
}