Datentypen für Frauengesundheit

Die Google Health API bietet Datentypen zum Erfassen von Daten zur reproduktiven Gesundheit, zu Symptomen und Stimmungen. Mit diesen Typen können Sie Menstruationsperioden, Ovulationstestergebnisse und zugehörige körperliche und emotionale Zustände protokollieren.

Unterstützte Datentypen

Tabelle: Datentypen für die Frauengesundheit in der Google Health API
Datentyp Verfügbare
Vorgänge		 Bereich
Menstruationsperiode
Datentyp: menstrual-period
Filterparameter: menstrual_period
Eintragstyp: Intervall
 Erstellen, aktualisieren, Batch-Löschvorgang .reproductive_health.writeonly
Stimmungen
Datentyp: moods
Filterparameter: moods
Eintragstyp: Beispiel
 Erstellen, aktualisieren, Batch-Löschvorgang .mindfulness.writeonly
Ovulationstest
Datentyp: ovulation-test
Filterparameter: ovulation_test
Eintragstyp: Beispiel
 Erstellen, aktualisieren, Batch-Löschvorgang .reproductive_health.writeonly
Symptome
Datentyp: symptoms
Filterparameter: symptoms
Eintragstyp: Beispiel
 Erstellen, aktualisieren, Batch-Löschvorgang .logged_symptoms.writeonly

Menstruationsperiode

Eine Menstruationsperiode stellt ein von einem Nutzer protokolliertes Zeitintervall dar. Eine vollständige Liste der Felder und Beschreibungen finden Sie unter MenstrualPeriod.

Richtlinien für die Protokollierung von Perioden

  • Enddaten sind erforderlich: Alle Periodeneinträge müssen ein Enddatum oder eine Zeit enthalten. Enddaten dürfen niemals null sein.
  • Umgang mit laufenden Perioden: Wenn Sie beim Erstellen des Eintrags kein Enddatum angeben können (z. B. wenn die Periode noch andauert), legen Sie das Enddatum so fest, dass es mit dem Startdatum übereinstimmt. Aktualisieren Sie den Eintrag täglich und legen Sie das Enddatum auf das aktuelle Datum fest, bis die Periode endet und das endgültige Enddatum bestätigt wird.
  • Bestätigte Perioden: Alle Periodeneinträge werden als bestätigte Perioden behandelt.

Menstruationsperiode erstellen

Senden Sie zum Erstellen eines Eintrags für eine Menstruationsperiode eine POST-Anfrage an den Endpunkt für Datenpunkte für Menstruationsperioden (menstrual-period). Die Antwort enthält das name Feld mit der data-point-id, die in einer Batch-Löschung oder Aktualisierungsanfrage (Patch) verwendet werden kann.

Anfrage

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

Antwort

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

Ovulationstest

Protokolliert eine Beobachtung eines Ovulationstests. Eine vollständige Liste der Felder und Beschreibungen finden Sie unter OvulationTest.

Ovulationstest erstellen

Senden Sie zum Protokollieren eines Ovulationstestergebnisses eine POST-Anfrage an den Endpunkt für Datenpunkte für Ovulationstests (ovulation-test). Die Antwort enthält das name Feld mit der data-point-id, die in einer Batch-Löschung oder Aktualisierung (Patch) Anfrage verwendet werden kann.

Anfrage

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

Antwort

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

Symptome

Protokolliert körperliche Symptome, die zu einem bestimmten Zeitpunkt aufgetreten sind. Eine vollständige Liste der Felder und Beschreibungen finden Sie unter Symptoms.

Symptomprotokoll erstellen

Senden Sie zum Protokollieren körperlicher Symptome eine POST-Anfrage an den Endpunkt für Datenpunkte für Symptome (symptoms). Die Antwort enthält das Feld name mit der data-point-id, die in einer Batch-Löschung oder Aktualisierungsanfrage (Patch) verwendet werden kann.

Anfrage

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

Antwort

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

Stimmungen

Protokolliert emotionale Zustände und Valenzen zu einem bestimmten Zeitpunkt. Eine vollständige Liste der Felder und Beschreibungen finden Sie unter Moods.

Stimmungsprotokoll erstellen

Senden Sie zum Protokollieren emotionaler Zustände eine POST-Anfrage an den Endpunkt für Datenpunkte für Stimmungen (moods). Die Antwort enthält das Feld name mit der data-point-id, die in einer Batch-Löschung oder Aktualisierungsanfrage (Patch) verwendet werden kann.

Anfrage

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

Antwort

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

Batch-Löschvorgang

Senden Sie zum Löschen eines oder mehrerer Datenpunkte eine POST-Anfrage an den Endpunkt batchDelete mit den Ressourcennamen der zu entfernenden Einträge.

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

Beispiel: Mehrere Datenpunkte löschen

Wenn Sie mehrere Datenpunkte in einer einzigen Anfrage löschen möchten, fügen Sie ihre Ressourcennamen in das Array names ein.

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