Types de données sur la santé des femmes

L'API Google Health fournit des types de données pour suivre la santé reproductive, les symptômes et les humeurs. Ces types vous permettent d'enregistrer les règles, les résultats des tests d'ovulation et les états physiques et émotionnels associés.

Types de données acceptés

Tableau : Types de données de santé des femmes de l'API Google Health
Type de données Opérations
disponibles		 Champ d'application
Règles
dataType: menstrual-period
filter parameter: menstrual_period
**Type d'enregistrement** : Interval
 create, update, batchDelete .reproductive_health.writeonly
Humeurs
dataType: moods
filter parameter: moods
**Type d'enregistrement** : Sample
 create, update, batchDelete .mindfulness.writeonly
Test d'ovulation
dataType: ovulation-test
filter parameter: ovulation_test
**Type d'enregistrement** : Sample
 create, update, batchDelete .reproductive_health.writeonly
Symptômes
dataType: symptoms
filter parameter: symptoms
**Type d'enregistrement** : Sample
 create, update, batchDelete .logged_symptoms.writeonly

Règles

Les règles représentent un intervalle de temps enregistré par un utilisateur. Pour obtenir la liste complète des champs et des descriptions, consultez MenstrualPeriod.

Consignes pour l'enregistrement des règles

  • Les dates de fin sont obligatoires : tous les enregistrements de règles doivent inclure une date ou une heure de fin. Les dates de fin ne doivent jamais être nulles.
  • Gestion des règles en cours : si vous ne pouvez pas fournir de date de fin lors de la création de l'enregistrement (par exemple, si les règles sont en cours), définissez la date de fin sur la même valeur que la date de début. Mettez à jour l'enregistrement tous les jours en définissant la date de fin sur la date actuelle, jusqu'à la fin des règles et la confirmation de la date de fin définitive.
  • Règles confirmées : tous les enregistrements de règles sont traités comme des règles confirmées.

Créer des règles

Pour créer une entrée de règles, envoyez une requête POST au point de terminaison des points de données menstrual-period. La réponse inclut le name champ contenant le data-point-id, qui peut être utilisé dans une requête de suppression groupée ou de mise à jour (correction).

Requête

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

Réponse

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

Test d'ovulation

Enregistre une observation de test d'ovulation. Pour obtenir la liste complète des champs et des descriptions, consultez OvulationTest.

Créer un test d'ovulation

Pour enregistrer le résultat d'un test d'ovulation, envoyez une requête POST au point de terminaison des points de données ovulation-test. La réponse inclut le name champ contenant le data-point-id, qui peut être utilisé dans une requête de suppression groupée ou de mise à jour (correction).

Requête

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

Réponse

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

Symptômes

Enregistre les symptômes physiques ressentis à un horodatage donné. Pour obtenir la liste complète des champs et des descriptions, consultez Symptoms.

Créer un journal des symptômes

Pour enregistrer les symptômes physiques, envoyez une requête POST au point de terminaison des points de données symptoms. La réponse inclut le name champ contenant le data-point-id, qui peut être utilisé dans une suppression groupée ou mise à jour (correction) requête.

Requête

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

Réponse

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

Humeurs

Enregistre les états émotionnels et les valences à un horodatage donné. Pour obtenir la liste complète des champs et des descriptions, consultez Moods.

Créer un journal des humeurs

Pour enregistrer les états émotionnels, envoyez une requête POST au point de terminaison des points de données moods. La réponse inclut le name champ contenant le data-point-id, qui peut être utilisé dans une suppression groupée ou mise à jour (correction) requête.

Requête

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

Réponse

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

Suppression groupée

Pour supprimer un ou plusieurs points de données, envoyez une requête POST au point de terminaison batchDelete avec les noms de ressources des entrées à supprimer.

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

Exemple : Suppression de plusieurs points de données

Pour supprimer plusieurs points de données en une seule requête, incluez leurs noms de ressources dans le tableau 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"
  ]
}