סוגי נתונים של בריאות האישה

‫Google Health API מספק סוגי נתונים למעקב אחרי מחזור חודשי, תסמינים ומצבי רוח. הסוגים האלה מאפשרים לכם לתעד את תקופות הווסת, את תוצאות בדיקת הביוץ ואת המצבים הגופניים והרגשיים שקשורים לכך.

סוגי נתונים נתמכים

טבלה: סוגי נתוני בריאות וכושר של נשים ב-Google Health API

סוג הנתונים	פעולות זמינות	היקף
Menstrual Period ‫dataType: menstrual-period filter parameter: menstrual_period סוג הרשומה: מרווח מדריך לבריאות האישה	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 data points. התשובה כוללת את השדה 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"
  ]
}