Skip to content
AF
Google Health API reference

Symptoms: the Google Health API symptoms data type

Read from Google’s documentation on 2026-10-17 · discovery document revision 20261014 · Google’s data-types page last updated 2026-10-06

Symptoms (symptoms) is a Sample data type in the Google Health API. Google's data-types table lists create, update and batchDelete for it under the .logged_symptoms.writeonly scope. The table marks it with neither webhook nor true-zeros support. Google's Fitbit migration table names no Fitbit Web API predecessor for it.

Symptoms at a glance

From the Symptoms row of Google’s data-types table, joined to the discovery document’s DataPoint schema.

Display name
Symptoms
dataType (in endpoint URLs)
symptoms
filter parameter
symptomsGoogle: “The identifier separated by underscores (for example, active_minutes) used as the value for the dataType filter parameter in daily rollup and rollup requests.”
Record type
Sample — Google: “Represents instantaneous measurements.”
Storage resolution
not stated in Google’s table
Webhook support
Not marked in Google’s table
True zeros support
Not marked in Google’s table
Channel
v4
DataPoint field
DataPoint.symptoms → SymptomsIts description: “Optional. Data for points in the symptoms sample data type collection.”
Compatible devices
0 in Google’s table

Operations and request paths

The operations Google’s table lists for symptoms, each matched to its users.dataTypes.dataPoints method in the discovery document. The path is the documented path template (the method’s flatPath on https://health.googleapis.com/) with {dataTypesId} filled in as symptoms. Google on {user}: “The {user} can be either the alias me or the authenticated user's numeric Health User ID (retrieved via GetIdentity).”

Table listsMethodDocumented path template
createcreatePOST https://health.googleapis.com/v4/users/{usersId}/dataTypes/symptoms/dataPoints
updatepatchvia Google’s endpoint-mapping table (flagged below)PATCH https://health.googleapis.com/v4/users/{usersId}/dataTypes/symptoms/dataPoints/{dataPointsId}
batchDeletebatchDeletePOST https://health.googleapis.com/v4/users/{usersId}/dataTypes/symptoms/dataPoints:batchDelete

Every method, and how many of the data types list it: the methods overview.

Scopes

The scopes Google’s table lists for symptoms, as full URLs, with the consent text Google’s Scopes page gives each. Every Google Health API scope.

ScopeAccessGoogle’s permission text
https://www.googleapis.com/auth/googlehealth.logged_symptoms.writeonlywriteAdd logged symptoms data to Google Health, and edit or delete the data it adds.

Fields of Symptoms

The schema the discovery document gives DataPoint.symptoms, required fields first. Types are as the discovery document states them; the label is the word Google’s description opens with. The schemas its fields refer to follow, one level deep.

Symptoms — Google: “Symptoms logged by the user.”

FieldTypeGoogle’s description
sampleTimeRequiredObservationSampleTimeRequired. Time when the symptoms were logged.
symptomsRequiredarray<string>Required. List of symptoms experienced.
  • SYMPTOM_VALUE_UNSPECIFIED — Unspecified symptom value.
  • CRAMPS — Abdominal cramps.
  • HEADACHE — Headache.
  • TENDER_BREASTS — Tender breasts.
  • ACNE — Acne.
  • SICK — Feeling sick or unwell.
  • BLOATED — Bloating or abdominal swelling.
  • HOT_FLASHES — Hot flashes.
  • PMS — Premenstrual syndrome symptoms.
  • COUGH — Coughing.
  • FEVER — Fever or elevated body temperature.
  • DIFFICULTY_BREATHING — Difficulty breathing or shortness of breath.
  • BACK_PAIN — Back pain.
  • SHAKINESS — Shakiness or tremors.
  • HUNGER — Excessive hunger.
  • SWEATING — Excessive sweating.
  • ANXIETY — Anxiety or nervousness.
  • THIRST — Excessive thirst.
  • FREQUENT_URINATION — Frequent urination.
  • BLURRED_VISION — Blurred vision.
  • OTHER — Other symptoms.
  • SEX_DRIVE_HIGH — High sex drive.
  • SEX_DRIVE_MEDIUM — Medium sex drive.
  • SEX_DRIVE_LOW — Low sex drive.
  • HEART_PALPITATIONS — Heart palpitations or racing heart.
  • FAINTING — Fainting or loss of consciousness.
  • CHEST_PAIN — Chest pain or discomfort.
  • FATIGUE — Fatigue or extreme tiredness.
  • CONFUSION — Confusion or mental fogginess.
  • DIZZINESS — Dizziness or lightheadedness.
  • ABDOMINAL_PAIN — Abdominal pain.
  • BLADDER_LEAKS — Bladder leaks.
  • BLEEDING_GUMS — Bleeding gums.
  • BRAIN_FOG — Brain fog.
  • BURNING_MOUTH — Burning mouth.
  • CONSTIPATION — Constipation.
  • CRAVINGS — Food cravings.
  • DECREASED_APPETITE — Decreased appetite.
  • DIARRHEA — Diarrhea.
  • DRAWING_PAIN — Drawing pain.
  • DRY_EYES — Dry eyes.
  • DRY_HAIR — Dry hair.
  • DRY_SKIN — Dry skin.
  • EXHAUSTION — Exhaustion.
  • FEEL_GOOD — Feeling good or well.
  • FOOD_AVERSIONS — Food aversions.
  • HAIR_LOSS — Hair loss.
  • HEARTBURN — Heartburn.
  • HYPERPIGMENTATION — Hyperpigmentation.
  • INCREASED_APPETITE — Increased appetite.
  • INCREASED_APPETITE_V2 — Increased appetite V2.
  • INSOMNIA — Insomnia or difficulty sleeping.
  • JOINT_PAIN — Joint pain.
  • LEG_CRAMPS — Leg cramps.
  • MILKY_NIPPLE_DISCHARGE — Milky nipple discharge.
  • NAUSEA — Nausea.
  • NIGHT_SWEATS — Night sweats.
  • NORMAL_DIGESTION — Normal digestion.
  • NORMAL_STOOL — Normal stool.
  • PERINEUM_PAIN — Perineum pain.
  • SLEEPINESS — Sleepiness or drowsiness.
  • STRETCH_MARKS — Stretch marks.
  • SWELLING — Swelling.
  • VAGINAL_DRYNESS — Vaginal dryness.
  • VAGINAL_ITCHING — Vaginal itching.
  • VOMITING — Vomiting.

ObservationSampleTime

Google: “Represents a sample time of an observed data point.”

FieldTypeGoogle’s description
physicalTimeRequiredstring/google-datetimeRequired. The time of the observation.
utcOffsetRequiredstring/google-durationRequired. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC).
civilTimeOutput onlyCivilDateTimeOutput only. The civil time in the timezone the subject is in at the time of the observation.

Fitbit Web API predecessor

Google’s Fitbit Web API → Google Health API data-type table has no row for symptoms, so it names no Fitbit Web API predecessor.

Google’s full Fitbit Web API mapping tables · the migration playbook

Where Google’s pages disagree

Published as found, with the texts that disagree; nothing here is corrected by us.

  • Operation name differs

    The table lists "update" for symptoms, but the discovery document has no method named update; Google's endpoint-mapping table points updates at patch.

    • Google's Fitbit migration API specifications: “CREATE & UPDATE Logs”
    • Google's Fitbit migration API specifications: “patch method”
    • the v4 discovery document: “Updates a single identifiable data point. If a data point with the specified name is not found, the request will fail.”

Google’s documentation

Related on this site

Questions

Which OAuth scopes does the Google Health API symptoms data type need?

Google's data-types table (read 2026-10-17) lists https://www.googleapis.com/auth/googlehealth.logged_symptoms.writeonly for symptoms. The Scopes page's consent text: .logged_symptoms.writeonly, "Add logged symptoms data to Google Health, and edit or delete the data it adds."

Can apps write symptoms data to the Google Health API?

Yes. Google's data-types table lists create, update and batchDelete for symptoms. create is POST https://health.googleapis.com/v4/users/{usersId}/dataTypes/symptoms/dataPoints. The table's "update" has no method of that name in the discovery document; Google's endpoint-mapping table points updates at patch, which is PATCH https://health.googleapis.com/v4/users/{usersId}/dataTypes/symptoms/dataPoints/{dataPointsId}. batchDelete is POST https://health.googleapis.com/v4/users/{usersId}/dataTypes/symptoms/dataPoints:batchDelete. Writes need https://www.googleapis.com/auth/googlehealth.logged_symptoms.writeonly.

How do you aggregate symptoms data with the Google Health API?

Not with rollUp or dailyRollUp, going by Google's data-types table: it lists only create, update and batchDelete for symptoms. Read the data points with list (or reconcile, where listed) and compute any summary yourself.

Does the Google Health API send webhooks for symptoms?

Not according to Google's data-types table, which does not mark symptoms with webhook support, and the webhooks guide does not list it.

Sources checked

Google’s text is quoted for identification; each guide page’s footer reads: “Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License.”. Generated from Google’s pages by scripts/fetch-google-health-api.mjs, not typed by hand; Google’s documentation remains the authority.

← All Google Health API data types