{ "icons": { "x32": "http://www.google.com/images/icons/product/search-32.gif", "x16": "http://www.google.com/images/icons/product/search-16.gif" }, "rootUrl": "https://health.googleapis.com/", "batchPath": "batch", "mtlsRootUrl": "https://health.mtls.googleapis.com/", "revision": "20260907", "basePath": "", "id": "health:v4beta", "version_module": true, "resources": { "shl": { "resources": { "m": { "methods": { "getShlManifest": { "path": "v4beta/shl/m/{externalShlId}", "description": "Forward a manifest request for a given SHL", "parameterOrder": [ "externalShlId" ], "parameters": { "externalShlId": { "required": true, "description": "Required. External ID mapping to a ShlSharedLinkCapabilityToken object See https://docs.google.com/document/d/1Pch20pxJHRbsaMxp0EYgs3ZU0Gu7QTUznk8LhvbQvfY/edit?tab=t.0#heading=h.17wg41voij6q", "location": "path", "type": "string" } }, "flatPath": "v4beta/shl/m/{externalShlId}", "request": { "$ref": "ManifestParams" }, "response": { "$ref": "HttpBody" }, "httpMethod": "POST", "id": "health.shl.m.getShlManifest" } } }, "r": { "methods": { "get": { "parameters": { "externalShlId": { "required": true, "description": "Required. External ID mapping to a ShlSharedLinkCapabilityToken object See https://docs.google.com/document/d/1Pch20pxJHRbsaMxp0EYgs3ZU0Gu7QTUznk8LhvbQvfY/edit?tab=t.0#heading=h.17wg41voij6q", "location": "path", "type": "string" }, "resourceToken": { "description": "Required. Encoded, encrypted message containing resource access details", "required": true, "type": "string", "location": "path" } }, "httpMethod": "GET", "flatPath": "v4beta/shl/r/{externalShlId}/{resourceToken}", "path": "v4beta/shl/r/{externalShlId}/{resourceToken}", "parameterOrder": [ "externalShlId", "resourceToken" ], "description": "Forward a resource request for a given SHL", "response": { "$ref": "HttpBody" }, "id": "health.shl.r.get" } } } } }, "users": { "methods": { "updateProfile": { "description": "Updates the user's profile details.", "id": "health.users.updateProfile", "scopes": [ "https://www.googleapis.com/auth/googlehealth.profile.writeonly" ], "parameterOrder": [ "name" ], "path": "v4beta/{+name}", "parameters": { "name": { "description": "Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user.", "location": "path", "pattern": "^users/[^/]+/profile$", "required": true, "type": "string" }, "updateMask": { "description": "Optional. The list of fields to be updated.", "format": "google-fieldmask", "type": "string", "location": "query" } }, "request": { "$ref": "Profile" }, "flatPath": "v4beta/users/{usersId}/profile", "response": { "$ref": "Profile" }, "httpMethod": "PATCH" }, "getProfile": { "response": { "$ref": "Profile" }, "flatPath": "v4beta/users/{usersId}/profile", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "location": "path", "pattern": "^users/[^/]+/profile$", "description": "Required. The name of the Profile. Format: `users/me/profile`.", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/googlehealth.profile.readonly" ], "path": "v4beta/{+name}", "id": "health.users.getProfile", "httpMethod": "GET", "description": "Returns user Profile details." }, "getIrnProfile": { "description": "Returns user's IRN Profile details.", "id": "health.users.getIrnProfile", "scopes": [ "https://www.googleapis.com/auth/googlehealth.irn.readonly" ], "path": "v4beta/{+name}", "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. The resource name of the IRN Profile. Format: `users/{user}/irnProfile` Example: `users/1234567890/irnProfile` or `users/me/irnProfile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user.", "pattern": "^users/[^/]+/irnProfile$" } }, "flatPath": "v4beta/users/{usersId}/irnProfile", "response": { "$ref": "IrnProfile" }, "parameterOrder": [ "name" ], "httpMethod": "GET" }, "updateSettings": { "path": "v4beta/{+name}", "description": "Updates the user's settings details.", "httpMethod": "PATCH", "scopes": [ "https://www.googleapis.com/auth/googlehealth.settings.writeonly" ], "response": { "$ref": "Settings" }, "flatPath": "v4beta/users/{usersId}/settings", "parameters": { "name": { "pattern": "^users/[^/]+/settings$", "required": true, "type": "string", "location": "path", "description": "Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user." }, "updateMask": { "format": "google-fieldmask", "location": "query", "description": "Optional. The list of fields to be updated.", "type": "string" } }, "request": { "$ref": "Settings" }, "id": "health.users.updateSettings", "parameterOrder": [ "name" ] }, "getSettings": { "description": "Returns user settings details.", "parameterOrder": [ "name" ], "response": { "$ref": "Settings" }, "flatPath": "v4beta/users/{usersId}/settings", "path": "v4beta/{+name}", "id": "health.users.getSettings", "httpMethod": "GET", "parameters": { "name": { "type": "string", "description": "Required. The name of the Settings. Format: `users/me/settings`.", "required": true, "location": "path", "pattern": "^users/[^/]+/settings$" } }, "scopes": [ "https://www.googleapis.com/auth/googlehealth.settings.readonly" ] }, "getIdentity": { "parameterOrder": [ "name" ], "flatPath": "v4beta/users/{usersId}/identity", "parameters": { "name": { "description": "Required. The resource name of the Identity. Format: `users/me/identity`", "pattern": "^users/[^/]+/identity$", "type": "string", "required": true, "location": "path" } }, "description": "Gets the user's identity. It includes the legacy Fitbit user ID and the Google user ID and it can be used by migrating clients to map identifiers between the two systems.", "response": { "$ref": "Identity" }, "httpMethod": "GET", "path": "v4beta/{+name}", "scopes": [ "https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly", "https://www.googleapis.com/auth/googlehealth.ecg.readonly", "https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonly", "https://www.googleapis.com/auth/googlehealth.irn.readonly", "https://www.googleapis.com/auth/googlehealth.logged_symptoms.readonly", "https://www.googleapis.com/auth/googlehealth.mindfulness.readonly", "https://www.googleapis.com/auth/googlehealth.profile.readonly", "https://www.googleapis.com/auth/googlehealth.reproductive_health.readonly", "https://www.googleapis.com/auth/googlehealth.settings.readonly", "https://www.googleapis.com/auth/googlehealth.sleep.readonly" ], "id": "health.users.getIdentity" } }, "resources": { "dataTypes": { "resources": { "dataPoints": { "methods": { "patch": { "parameters": { "name": { "type": "string", "description": "Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens.", "location": "path", "required": true, "pattern": "^users/[^/]+/dataTypes/[^/]+/dataPoints/[^/]+$" } }, "id": "health.users.dataTypes.dataPoints.patch", "parameterOrder": [ "name" ], "path": "v4beta/{+name}", "description": "Updates a single identifiable data point. If a data point with the specified `name` is not found, the request will fail.", "httpMethod": "PATCH", "scopes": [ "https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly", "https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.writeonly", "https://www.googleapis.com/auth/googlehealth.logged_symptoms.writeonly", "https://www.googleapis.com/auth/googlehealth.mindfulness.writeonly", "https://www.googleapis.com/auth/googlehealth.nutrition.writeonly", "https://www.googleapis.com/auth/googlehealth.reproductive_health.writeonly", "https://www.googleapis.com/auth/googlehealth.sleep.writeonly" ], "flatPath": "v4beta/users/{usersId}/dataTypes/{dataTypesId}/dataPoints/{dataPointsId}", "request": { "$ref": "DataPoint" }, "response": { "$ref": "Operation" } }, "list": { "id": "health.users.dataTypes.dataPoints.list", "response": { "$ref": "ListDataPointsResponse" }, "httpMethod": "GET", "flatPath": "v4beta/users/{usersId}/dataTypes/{dataTypesId}/dataPoints", "scopes": [ "https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly", "https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly", "https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonly", "https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.writeonly", "https://www.googleapis.com/auth/googlehealth.location.readonly", "https://www.googleapis.com/auth/googlehealth.logged_symptoms.readonly", "https://www.googleapis.com/auth/googlehealth.logged_symptoms.writeonly", "https://www.googleapis.com/auth/googlehealth.mindfulness.readonly", "https://www.googleapis.com/auth/googlehealth.mindfulness.writeonly", "https://www.googleapis.com/auth/googlehealth.nutrition.writeonly", "https://www.googleapis.com/auth/googlehealth.reproductive_health.readonly", "https://www.googleapis.com/auth/googlehealth.reproductive_health.writeonly", "https://www.googleapis.com/auth/googlehealth.sleep.readonly", "https://www.googleapis.com/auth/googlehealth.sleep.writeonly" ], "description": "Query user health and fitness data points.", "parameters": { "pageToken": { "type": "string", "location": "query", "description": "Optional. The `next_page_token` from a previous request, if any." }, "parent": { "pattern": "^users/[^/]+/dataTypes/[^/]+$", "required": true, "description": "Required. Parent data type of the Data Point collection. Format: `users/me/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/weight` For a list of the supported data types see the DataPoint data union field.", "location": "path", "type": "string" }, "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "Optional. The maximum number of data points to return. If unspecified, at most 1440 data points will be returned. The maximum page size is 10000; values above that will be truncated accordingly. For `exercise` and `sleep` the default page size is 25. The maximum page size for `exercise` and `sleep` is 25." }, "filter": { "type": "string", "location": "query", "description": "Optional. Filter expression following https://google.aip.dev/160. A time range (either physical or civil) can be specified. The supported filter fields are: - Interval start time: - Pattern: `{interval_data_type}.interval.start_time` - Supported comparison operators: `\u003e=`, `\u003c` - Timestamp literal expected in RFC-3339 format - Supported logical operators: `AND` - Example: - `steps.interval.start_time \u003e= \"2023-11-24T00:00:00Z\" AND steps.interval.start_time \u003c \"2023-11-25T00:00:00Z\"` - `distance.interval.start_time \u003e= \"2024-08-14T12:34:56Z\"` - Interval civil start time: - Pattern: `{interval_data_type}.interval.civil_start_time` - Supported comparison operators: `\u003e=`, `\u003c` - Date with optional time literal expected in ISO 8601 `YYYY-MM-DD[THH:mm:ss]` format - Supported logical operators: `AND` - Example: - `steps.interval.civil_start_time \u003e= \"2023-11-24\" AND steps.interval.civil_start_time \u003c \"2023-11-25\"` - `distance.interval.civil_start_time \u003e= \"2024-08-14T12:34:56\"` - Sample observation physical time: - Pattern: `{sample_data_type}.sample_time.physical_time` - Supported comparison operators: `\u003e=`, `\u003c` - Timestamp literal expected in RFC-3339 format - Supported logical operators: `AND` - Example: - `weight.sample_time.physical_time \u003e= \"2023-11-24T00:00:00Z\" AND weight.sample_time.physical_time \u003c \"2023-11-25T00:00:00Z\"` - `weight.sample_time.physical_time \u003e= \"2024-08-14T12:34:56Z\"` - Sample observation civil time: - Pattern: `{sample_data_type}.sample_time.civil_time` - Supported comparison operators: `\u003e=`, `\u003c` - Date with optional time literal expected in ISO 8601 `YYYY-MM-DD[THH:mm:ss]` format - Supported logical operators: `AND` - Example: - `weight.sample_time.civil_time \u003e= \"2023-11-24\" AND weight.sample_time.civil_time \u003c \"2023-11-25\"` - `weight.sample_time.civil_time \u003e= \"2024-08-14T12:34:56\"` - Daily summary date: - Pattern: `{daily_summary_data_type}.date` - Supported comparison operators: `\u003e=`, `\u003c` - Date literal expected in ISO 8601 `YYYY-MM-DD` format - Supported logical operators: `AND` - Example: - `daily_heart_rate_variability.date \u003c \"2024-08-15\"` - Session civil start time (**Excluding Sleep and ECG**): - Pattern: `{session_data_type}.interval.civil_start_time` - Supported comparison operators: `\u003e=`, `\u003c` - Date with optional time literal expected in ISO 8601 `YYYY-MM-DD[THH:mm:ss]` format - Supported logical operators: `AND` - Example: - `exercise.interval.civil_start_time \u003e= \"2023-11-24\" AND exercise.interval.civil_start_time \u003c \"2023-11-25\"` - `exercise.interval.civil_start_time \u003e= \"2024-08-14T12:34:56\"` - Session start time (**ECG specific**): - Pattern: `electrocardiogram.interval.start_time` - Supported comparison operators: `\u003e=` - Timestamp literal expected in RFC-3339 format - Example: - `electrocardiogram.interval.start_time \u003e= \"2024-08-14T12:34:56Z\"` - Note: Only filtering by start time is supported for ECG. Filtering by end time (e.g., `electrocardiogram.interval.end_time`) is not supported. - Session end time (**Sleep specific**): - Pattern: `sleep.interval.end_time` - Supported comparison operators: `\u003e=`, `\u003c` - Timestamp literal expected in RFC-3339 format - Supported logical operators: `AND`, `OR` - Example: - `sleep.interval.end_time \u003e= \"2023-11-24T00:00:00Z\" AND sleep.interval.end_time \u003c \"2023-11-25T00:00:00Z\"` - Session civil end time (**Sleep specific**): - Pattern: `sleep.interval.civil_end_time` - Supported comparison operators: `\u003e=`, `\u003c` - Date with optional time literal expected in ISO 8601 `YYYY-MM-DD[THH:mm:ss]` format - Supported logical operators: `AND`, `OR` - Example: - `sleep.interval.civil_end_time \u003e= \"2023-11-24\" AND sleep.interval.civil_end_time \u003c \"2023-11-25\"` Data points in the response will be ordered by the interval start time in descending order." } }, "path": "v4beta/{+parent}/dataPoints", "parameterOrder": [ "parent" ] }, "rollUp": { "httpMethod": "POST", "description": "Roll up data points over physical time intervals for supported data types.", "parameterOrder": [ "parent" ], "response": { "$ref": "RollUpDataPointsResponse" }, "parameters": { "parent": { "description": "Required. Parent data type of the Data Point collection. Format: `users/{user}/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/distance` For a list of the supported data types see the RollupDataPoint value union field.", "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+$", "type": "string", "required": true } }, "request": { "$ref": "RollUpDataPointsRequest" }, "flatPath": "v4beta/users/{usersId}/dataTypes/{dataTypesId}/dataPoints:rollUp", "id": "health.users.dataTypes.dataPoints.rollUp", "scopes": [ "https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly", "https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly", "https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonly", "https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.writeonly", "https://www.googleapis.com/auth/googlehealth.location.readonly", "https://www.googleapis.com/auth/googlehealth.logged_symptoms.readonly", "https://www.googleapis.com/auth/googlehealth.logged_symptoms.writeonly", "https://www.googleapis.com/auth/googlehealth.mindfulness.readonly", "https://www.googleapis.com/auth/googlehealth.mindfulness.writeonly", "https://www.googleapis.com/auth/googlehealth.nutrition.writeonly", "https://www.googleapis.com/auth/googlehealth.reproductive_health.readonly", "https://www.googleapis.com/auth/googlehealth.reproductive_health.writeonly", "https://www.googleapis.com/auth/googlehealth.sleep.readonly", "https://www.googleapis.com/auth/googlehealth.sleep.writeonly" ], "path": "v4beta/{+parent}/dataPoints:rollUp" }, "reconcile": { "path": "v4beta/{+parent}/dataPoints:reconcile", "flatPath": "v4beta/users/{usersId}/dataTypes/{dataTypesId}/dataPoints:reconcile", "response": { "$ref": "ReconcileDataPointsResponse" }, "parameters": { "pageToken": { "type": "string", "location": "query", "description": "Optional. The `next_page_token` from a previous request, if any." }, "parent": { "required": true, "type": "string", "description": "Required. Parent data type of the Data Point collection. Format: `users/me/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/heart-rate` For a list of the supported data types see the DataPoint data union field.", "pattern": "^users/[^/]+/dataTypes/[^/]+$", "location": "path" }, "filter": { "location": "query", "description": "Optional. Filter expression based on https://aip.dev/160. A time range, either physical or civil, can be specified. See the ListDataPointsRequest.filter for the supported fields and syntax.", "type": "string" }, "dataSourceFamily": { "location": "query", "description": "Optional. The data source family name to reconcile. If empty, data points from all data sources will be reconciled. Format: `users/me/dataSourceFamilies/{data_source_family}` - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect.", "type": "string" }, "pageSize": { "location": "query", "format": "int32", "description": "Optional. The maximum number of data points to return. If unspecified, at most 1440 data points will be returned. The maximum page size is 10000; values above that will be truncated accordingly. For `exercise` and `sleep` the default page size is 25. The maximum page size for `exercise` and `sleep` is 25.", "type": "integer" } }, "id": "health.users.dataTypes.dataPoints.reconcile", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly", "https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly", "https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonly", "https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.writeonly", "https://www.googleapis.com/auth/googlehealth.location.readonly", "https://www.googleapis.com/auth/googlehealth.logged_symptoms.readonly", "https://www.googleapis.com/auth/googlehealth.logged_symptoms.writeonly", "https://www.googleapis.com/auth/googlehealth.mindfulness.readonly", "https://www.googleapis.com/auth/googlehealth.mindfulness.writeonly", "https://www.googleapis.com/auth/googlehealth.nutrition.writeonly", "https://www.googleapis.com/auth/googlehealth.reproductive_health.readonly", "https://www.googleapis.com/auth/googlehealth.reproductive_health.writeonly", "https://www.googleapis.com/auth/googlehealth.sleep.readonly", "https://www.googleapis.com/auth/googlehealth.sleep.writeonly" ], "description": "Reconcile data points from multiple data sources into a single data stream.", "httpMethod": "GET" }, "batchDelete": { "parameters": { "parent": { "required": true, "description": "Optional. Parent (data type) for the Data Point collection Format: `users/me/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/-` For a list of the supported data types see the DataPoint data union field. Deleting data points across multiple data type collections is supported following https://aip.dev/159. If this is set, the parent of all of the data points specified in `names` must match this field.", "type": "string", "pattern": "^users/[^/]+/dataTypes/[^/]+$", "location": "path" } }, "description": "Delete a batch of identifyable data points.", "id": "health.users.dataTypes.dataPoints.batchDelete", "request": { "$ref": "BatchDeleteDataPointsRequest" }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly", "https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.writeonly", "https://www.googleapis.com/auth/googlehealth.logged_symptoms.writeonly", "https://www.googleapis.com/auth/googlehealth.mindfulness.writeonly", "https://www.googleapis.com/auth/googlehealth.nutrition.writeonly", "https://www.googleapis.com/auth/googlehealth.reproductive_health.writeonly", "https://www.googleapis.com/auth/googlehealth.sleep.writeonly" ], "httpMethod": "POST", "flatPath": "v4beta/users/{usersId}/dataTypes/{dataTypesId}/dataPoints:batchDelete", "path": "v4beta/{+parent}/dataPoints:batchDelete", "response": { "$ref": "Operation" } }, "create": { "request": { "$ref": "DataPoint" }, "parameters": { "parent": { "required": true, "type": "string", "description": "Required. The parent resource name where the data point will be created. Format: `users/{user}/dataTypes/{data_type}`", "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+$" } }, "path": "v4beta/{+parent}/dataPoints", "response": { "$ref": "Operation" }, "flatPath": "v4beta/users/{usersId}/dataTypes/{dataTypesId}/dataPoints", "description": "Creates a single identifiable data point.", "scopes": [ "https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly", "https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.writeonly", "https://www.googleapis.com/auth/googlehealth.logged_symptoms.writeonly", "https://www.googleapis.com/auth/googlehealth.mindfulness.writeonly", "https://www.googleapis.com/auth/googlehealth.nutrition.writeonly", "https://www.googleapis.com/auth/googlehealth.reproductive_health.writeonly", "https://www.googleapis.com/auth/googlehealth.sleep.writeonly" ], "parameterOrder": [ "parent" ], "httpMethod": "POST", "id": "health.users.dataTypes.dataPoints.create" }, "exportExerciseTcx": { "description": "Exports exercise data in TCX format. **IMPORTANT:** HTTP clients must append `?alt=media` to the request URL to download the raw TCX file. Example: `https://health.googleapis.com/v4/users/me/dataTypes/exercise/dataPoints/EXERCISE_ID:exportExerciseTcx?alt=media` Without `alt=media`, the server returns a JSON response (`ExportExerciseTcxResponse`) which is intended primarily for gRPC clients. **Note:** While the Authorization section below states that any one of the listed scopes is accepted, this specific method requires the user to provide both one of the `activity_and_fitness` scopes (`normal` or `readonly`) AND one of the `location` scopes (`normal` or `readonly`) in their access token to succeed.", "parameters": { "name": { "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+/dataPoints/[^/]+$", "description": "Required. The resource name of the exercise data point to export. Format: `users/{user}/dataTypes/exercise/dataPoints/{data_point}` Example: `users/me/dataTypes/exercise/dataPoints/2026443605080188808` The `{user}` is the alias `\"me\"` currently. Future versions may support user IDs. The `{data_point}` ID maps to the exercise ID, which is a long integer.", "required": true, "type": "string" }, "partialData": { "type": "boolean", "location": "query", "description": "Optional. Indicates whether to include the TCX data points when the GPS data is not available. If not specified, defaults to `false` and partial data will not be included." } }, "supportsMediaDownload": true, "id": "health.users.dataTypes.dataPoints.exportExerciseTcx", "flatPath": "v4beta/users/{usersId}/dataTypes/{dataTypesId}/dataPoints/{dataPointsId}:exportExerciseTcx", "parameterOrder": [ "name" ], "response": { "$ref": "ExportExerciseTcxResponse" }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly", "https://www.googleapis.com/auth/googlehealth.location.readonly" ], "useMediaDownloadService": true, "path": "v4beta/{+name}:exportExerciseTcx" }, "dailyRollUp": { "scopes": [ "https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly", "https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly", "https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonly", "https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.writeonly", "https://www.googleapis.com/auth/googlehealth.location.readonly", "https://www.googleapis.com/auth/googlehealth.logged_symptoms.readonly", "https://www.googleapis.com/auth/googlehealth.logged_symptoms.writeonly", "https://www.googleapis.com/auth/googlehealth.mindfulness.readonly", "https://www.googleapis.com/auth/googlehealth.mindfulness.writeonly", "https://www.googleapis.com/auth/googlehealth.nutrition.writeonly", "https://www.googleapis.com/auth/googlehealth.reproductive_health.readonly", "https://www.googleapis.com/auth/googlehealth.reproductive_health.writeonly", "https://www.googleapis.com/auth/googlehealth.sleep.readonly", "https://www.googleapis.com/auth/googlehealth.sleep.writeonly" ], "id": "health.users.dataTypes.dataPoints.dailyRollUp", "httpMethod": "POST", "response": { "$ref": "DailyRollUpDataPointsResponse" }, "flatPath": "v4beta/users/{usersId}/dataTypes/{dataTypesId}/dataPoints:dailyRollUp", "path": "v4beta/{+parent}/dataPoints:dailyRollUp", "parameters": { "parent": { "required": true, "description": "Required. Parent data type of the Data Point collection. Format: `users/{user}/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/distance` For a list of the supported data types see the DailyRollupDataPoint value union field.", "type": "string", "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+$" } }, "description": "Roll up data points over civil time intervals for supported data types.", "request": { "$ref": "DailyRollUpDataPointsRequest" }, "parameterOrder": [ "parent" ] }, "get": { "httpMethod": "GET", "response": { "$ref": "DataPoint" }, "flatPath": "v4beta/users/{usersId}/dataTypes/{dataTypesId}/dataPoints/{dataPointsId}", "id": "health.users.dataTypes.dataPoints.get", "path": "v4beta/{+name}", "parameters": { "name": { "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+/dataPoints/[^/]+$", "type": "string", "description": "Required. The name of the data point to retrieve. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` See DataPoint.name for examples and possible values.", "required": true } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly", "https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly", "https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonly", "https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.writeonly", "https://www.googleapis.com/auth/googlehealth.location.readonly", "https://www.googleapis.com/auth/googlehealth.logged_symptoms.readonly", "https://www.googleapis.com/auth/googlehealth.logged_symptoms.writeonly", "https://www.googleapis.com/auth/googlehealth.mindfulness.readonly", "https://www.googleapis.com/auth/googlehealth.mindfulness.writeonly", "https://www.googleapis.com/auth/googlehealth.nutrition.writeonly", "https://www.googleapis.com/auth/googlehealth.reproductive_health.readonly", "https://www.googleapis.com/auth/googlehealth.reproductive_health.writeonly", "https://www.googleapis.com/auth/googlehealth.sleep.readonly", "https://www.googleapis.com/auth/googlehealth.sleep.writeonly" ], "description": "Get a single identifyable data point." } } } } }, "pairedDevices": { "methods": { "list": { "flatPath": "v4beta/users/{usersId}/pairedDevices", "scopes": [ "https://www.googleapis.com/auth/googlehealth.settings.readonly" ], "response": { "$ref": "ListPairedDevicesResponse" }, "httpMethod": "GET", "id": "health.users.pairedDevices.list", "parameterOrder": [ "parent" ], "path": "v4beta/{+parent}/pairedDevices", "description": "Returns the user's list of paired 1P trackers and smartwatches.", "parameters": { "parent": { "required": true, "description": "Required. The parent, which owns this collection of devices. Format: users/{user}", "type": "string", "pattern": "^users/[^/]+$", "location": "path" }, "pageSize": { "location": "query", "description": "Optional. The maximum number of devices to return. The service may return fewer than this value. If unspecified, at most 5 devices will be returned. The maximum value is 100. values above 100 will be coerced to 100.", "format": "int32", "type": "integer" }, "pageToken": { "description": "Optional. A page token, received from a previous `ListPairedDevices` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListPairedDevices` must match the call that provided the page token.", "location": "query", "type": "string" } } }, "get": { "parameters": { "name": { "required": true, "type": "string", "pattern": "^users/[^/]+/pairedDevices/[^/]+$", "location": "path", "description": "Required. The name of the device to retrieve. Format: users/{user}/devices/{device}" } }, "response": { "$ref": "PairedDevice" }, "flatPath": "v4beta/users/{usersId}/pairedDevices/{pairedDevicesId}", "path": "v4beta/{+name}", "description": "Returns user's Device.", "parameterOrder": [ "name" ], "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/googlehealth.settings.readonly" ], "id": "health.users.pairedDevices.get" } } } } }, "projects": { "resources": { "subscribers": { "methods": { "patch": { "httpMethod": "PATCH", "response": { "$ref": "Operation" }, "parameterOrder": [ "name" ], "flatPath": "v4beta/projects/{projectsId}/subscribers/{subscribersId}", "id": "health.projects.subscribers.patch", "parameters": { "name": { "required": true, "description": "Identifier. The resource name of the Subscriber. Format: projects/{project}/subscribers/{subscriber} The {project} ID is a Google Cloud Project ID or Project Number. The {subscriber} ID is user-settable (4-36 characters, matching /[a-z]([a-z0-9-]{2,34}[a-z0-9])/) if provided during creation, or system-generated otherwise (e.g., a UUID). Example (User-settable subscriber ID): projects/my-project/subscribers/my-sub-123 Example (System-generated subscriber ID): projects/my-project/subscribers/a1b2c3d4-e5f6-7890-1234-567890abcdef", "pattern": "^projects/[^/]+/subscribers/[^/]+$", "location": "path", "type": "string" }, "updateMask": { "location": "query", "description": "Optional. A field mask that specifies which fields of the Subscriber message are to be updated. This allows for partial updates. Supported fields: - endpoint_uri - subscriber_configs - endpoint_authorization", "format": "google-fieldmask", "type": "string" } }, "request": { "$ref": "Subscriber" }, "path": "v4beta/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Updates the configuration of an existing subscriber, such as the endpoint URI or the data types it's interested in. **Endpoint Verification:** If the `endpoint_uri` or `endpoint_authorization` field is included in the `update_mask`, the backend will re-verify the endpoint. The verification process is the same as described in `CreateSubscriber`: 1. **Verification with Authorization:** POST to the new or existing `endpoint_uri` with the new or existing `Authorization` secret. Expects HTTP `201 Created`. 2. **Verification without Authorization:** POST to the `endpoint_uri` without the `Authorization` header. Expects HTTP `401 Unauthorized` or `403 Forbidden`. Both tests must pass using the potentially updated values for the subscriber update to succeed. If verification fails, the update will not be applied, and an error will be returned." }, "list": { "id": "health.projects.subscribers.list", "parameterOrder": [ "parent" ], "httpMethod": "GET", "response": { "$ref": "ListSubscribersResponse" }, "path": "v4beta/{+parent}/subscribers", "flatPath": "v4beta/projects/{projectsId}/subscribers", "description": "Lists all subscribers registered within the owned Google Cloud Project.", "parameters": { "pageToken": { "description": "Optional. A page token, received from a previous `ListSubscribers` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListSubscribers` must match the call that provided the page token.", "location": "query", "type": "string" }, "parent": { "type": "string", "required": true, "description": "Required. The parent, which owns this collection of subscribers. Format: projects/{project}", "pattern": "^projects/[^/]+$", "location": "path" }, "pageSize": { "location": "query", "description": "Optional. The maximum number of subscribers to return. The service may return fewer than this value. If unspecified, at most 50 subscribers will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", "format": "int32", "type": "integer" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "description": "Registers a new subscriber endpoint to receive notifications. A subscriber represents an application or service that wishes to receive data change notifications for users who have granted consent. **Endpoint Verification:** For a subscriber to be successfully created, the provided `endpoint_uri` must be a valid HTTPS endpoint and must pass an automated verification check. The backend will send two HTTP POST requests to the `endpoint_uri`: 1. **Verification with Authorization:** * **Headers:** Includes `Content-Type: application/json` and `Authorization` (with the exact value from `CreateSubscriberPayload.endpoint_authorization.secret`). * **Body:** `{\"type\": \"verification\"}` * **Expected Response:** HTTP `201 Created`. 2. **Verification without Authorization:** * **Headers:** Includes `Content-Type: application/json`. The `Authorization` header is OMITTED. * **Body:** `{\"type\": \"verification\"}` * **Expected Response:** HTTP `401 Unauthorized` or `403 Forbidden`. Both tests must pass for the subscriber creation to succeed. If verification fails, the operation will not be completed and an error will be returned. This process ensures the endpoint is reachable and correctly validates the `Authorization` header.", "parameters": { "subscriberId": { "description": "Optional. The ID to use for the subscriber, which will become the final component of the subscriber's resource name. This value should be 4-36 characters, and valid characters are /[a-z]([a-z0-9-]{2,34}[a-z0-9])/.", "type": "string", "location": "query" }, "parent": { "location": "path", "type": "string", "description": "Required. The parent resource where this subscriber will be created. Format: projects/{project_number} Example: projects/1234567890", "pattern": "^projects/[^/]+$", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "Operation" }, "path": "v4beta/{+parent}/subscribers", "request": { "$ref": "CreateSubscriberPayload" }, "flatPath": "v4beta/projects/{projectsId}/subscribers", "parameterOrder": [ "parent" ], "id": "health.projects.subscribers.create", "httpMethod": "POST" }, "delete": { "description": "Deletes a subscriber registration. This will stop all notifications to the subscriber's endpoint.", "path": "v4beta/{+name}", "flatPath": "v4beta/projects/{projectsId}/subscribers/{subscribersId}", "response": { "$ref": "Operation" }, "parameterOrder": [ "name" ], "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "health.projects.subscribers.delete", "parameters": { "name": { "pattern": "^projects/[^/]+/subscribers/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The name of the subscriber to delete. Format: projects/{project}/subscribers/{subscriber} Example: projects/my-project/subscribers/my-subscriber-123 The {subscriber} ID is user-settable (4-36 characters, matching /[a-z]([a-z0-9-]{2,34}[a-z0-9])/) or system-generated if not provided during creation." }, "force": { "description": "Optional. If set to true, any child resources (e.g., subscriptions) will also be deleted. If false (default) and child resources exist, the request will fail.", "location": "query", "type": "boolean" } } } }, "resources": { "subscriptions": { "methods": { "patch": { "request": { "$ref": "Subscription" }, "flatPath": "v4beta/projects/{projectsId}/subscribers/{subscribersId}/subscriptions/{subscriptionsId}", "description": "Updates the data types for an existing user subscription.", "id": "health.projects.subscribers.subscriptions.patch", "response": { "$ref": "Subscription" }, "parameters": { "name": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/subscribers/[^/]+/subscriptions/[^/]+$", "required": true, "description": "Identifier. The resource name of the Subscription. Format: `projects/{project}/subscribers/{subscriber}/subscriptions/{subscription}` Example: `projects/my-project/subscribers/my-subscriber-123/subscriptions/my-subscription-456` The {project} ID is mandatory (6-30 characters, matching /a-z{6,30}/) The {subscriber} ID is user-settable (4-36 characters, matching /[a-z]([a-z0-9-]{2,34}[a-z0-9])/) if provided during creation, or system-generated otherwise. The {subscription} ID is user-settable (4-36 chars, matching /[a-z]([a-z0-9-]{2,34}[a-z0-9])/) or system-generated otherwise." }, "updateMask": { "format": "google-fieldmask", "type": "string", "location": "query", "description": "Optional. The list of fields to update." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PATCH", "parameterOrder": [ "name" ], "path": "v4beta/{+name}" }, "create": { "request": { "$ref": "CreateSubscriptionPayload" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v4beta/{+parent}/subscriptions", "httpMethod": "POST", "id": "health.projects.subscribers.subscriptions.create", "description": "Creates a subscription for a specific user to a specific subscriber. This method requires the subscriber to have a `SubscriptionCreatePolicy` set to `MANUAL` for the given data types.", "parameters": { "parent": { "required": true, "type": "string", "description": "Required. The parent subscriber. Format: projects/{project}/subscribers/{subscriber} The {subscriber} ID is user-settable (4-36 characters, matching /[a-z]([a-z0-9-]{2,34}[a-z0-9])/) if provided during creation, or system-generated otherwise.", "pattern": "^projects/[^/]+/subscribers/[^/]+$", "location": "path" }, "subscriptionId": { "type": "string", "description": "Optional. The {subscription_id} is user-settable (4-36 chars, matching /[a-z]([a-z0-9-]{2,34}[a-z0-9])/) or system-generated otherwise. If provided, the ID must be unique within the parent subscriber.", "location": "query" } }, "parameterOrder": [ "parent" ], "flatPath": "v4beta/projects/{projectsId}/subscribers/{subscribersId}/subscriptions", "response": { "$ref": "Subscription" } }, "delete": { "parameterOrder": [ "name" ], "response": { "$ref": "Empty" }, "id": "health.projects.subscribers.subscriptions.delete", "flatPath": "v4beta/projects/{projectsId}/subscribers/{subscribersId}/subscriptions/{subscriptionsId}", "httpMethod": "DELETE", "path": "v4beta/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a specific user subscription, stopping notifications for this user to this subscriber.", "parameters": { "name": { "location": "path", "pattern": "^projects/[^/]+/subscribers/[^/]+/subscriptions/[^/]+$", "description": "Required. The resource name of the subscription to delete. Format: `projects/{project}/subscribers/{subscriber}/subscriptions/{subscription}` Example: `projects/my-project/subscribers/my-subscriber-123/subscriptions/my-subscription-456` The {subscriber} ID is user-settable (4-36 characters, matching /[a-z]([a-z0-9-]{2,34}[a-z0-9])/) if provided during creation, or system-generated otherwise. The {subscription} ID is user-settable (4-36 characters, matching /[a-z]([a-z0-9-]{2,34}[a-z0-9])/) or system-generated if not provided during creation.", "required": true, "type": "string" } } }, "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/subscribers/[^/]+$", "required": true, "description": "Required. The parent subscriber. Format: projects/{project}/subscribers/{subscriber} The {subscriber} ID is user-settable (4-36 characters, matching /[a-z]([a-z0-9-]{2,34}[a-z0-9])/) if provided during creation, or system-generated otherwise." }, "pageToken": { "type": "string", "description": "Optional. A page token, received from a previous `ListSubscriptions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListSubscriptions` must match the call that provided the page token.", "location": "query" }, "pageSize": { "type": "integer", "description": "Optional. The maximum number of subscriptions to return. The service may return fewer than this value. If unspecified, at most 50 subscriptions will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", "location": "query", "format": "int32" }, "filter": { "location": "query", "type": "string", "description": "Optional. A filter to apply to the list of subscriptions. The filter syntax is described in https://google.aip.dev/160. The filter can be applied to the following fields: - `user` - `data_type` The `user` identifier (e.g., `user1` in `users/user1`) refers to the public `health_user_id` Example: user = \"users/user1\" Example: user = \"users/user1\" OR user = \"users/user2\" Example: user = \"users/user1\" AND (data_type = \"sleep\" OR data_type = \"weight\")" } }, "id": "health.projects.subscribers.subscriptions.list", "path": "v4beta/{+parent}/subscriptions", "httpMethod": "GET", "description": "Lists all active subscriptions for a given subscriber. This can be filtered, for example, by user or data type.", "flatPath": "v4beta/projects/{projectsId}/subscribers/{subscribersId}/subscriptions", "response": { "$ref": "ListSubscriptionsResponse" }, "parameterOrder": [ "parent" ] } } } } } } } }, "schemas": { "ExerciseEvent": { "id": "ExerciseEvent", "type": "object", "properties": { "eventTime": { "description": "Required. Exercise event time", "format": "google-datetime", "type": "string" }, "eventUtcOffset": { "format": "google-duration", "description": "Required. Exercise event time offset from UTC", "type": "string" }, "exerciseEventType": { "description": "Required. The type of the event, such as start, stop, pause, resume.", "type": "string", "enumDescriptions": [ "Exercise event type is unspecified.", "Exercise start event.", "Exercise stop event.", "Exercise pause event.", "Exercise resume event.", "Exercise auto-pause event.", "Exercise auto-resume event." ], "enum": [ "EXERCISE_EVENT_TYPE_UNSPECIFIED", "START", "STOP", "PAUSE", "RESUME", "AUTO_PAUSE", "AUTO_RESUME" ] } }, "description": "Represents instantaneous events that happen during an exercise, such as start, stop, pause, split." }, "SplitSummary": { "type": "object", "id": "SplitSummary", "description": "Represents splits or laps recorded within an exercise. Lap events partition a workout into segments based on criteria like distance, time, or calories.", "properties": { "endTime": { "description": "Required. Lap end time", "type": "string", "format": "google-datetime" }, "startTime": { "description": "Required. Lap start time", "type": "string", "format": "google-datetime" }, "activeDuration": { "description": "Output only. Lap time excluding the pauses.", "type": "string", "format": "google-duration", "readOnly": true }, "metricsSummary": { "description": "Required. Summary metrics for this split.", "$ref": "MetricsSummary" }, "splitType": { "enumDescriptions": [ "Split type is unspecified.", "Manual split.", "Split by duration.", "Split by distance.", "Split by calories." ], "enum": [ "SPLIT_TYPE_UNSPECIFIED", "MANUAL", "DURATION", "DISTANCE", "CALORIES" ], "type": "string", "description": "Required. Method used to split the exercise laps. Users may manually mark the lap as complete even if the tracking is automatic." }, "startUtcOffset": { "type": "string", "format": "google-duration", "description": "Required. Lap start time offset from UTC" }, "endUtcOffset": { "format": "google-duration", "type": "string", "description": "Required. Lap end time offset from UTC" } } }, "NutrientQuantityRollup": { "type": "object", "id": "NutrientQuantityRollup", "properties": { "quantity": { "$ref": "WeightQuantityRollup", "description": "Required. Aggregated nutrient weight." }, "nutrient": { "enum": [ "NUTRIENT_UNSPECIFIED", "BIOTIN", "CAFFEINE", "CALCIUM", "CHLORIDE", "CARBOHYDRATES", "CHOLESTEROL", "CHROMIUM", "COPPER", "DIETARY_FIBER", "FOLIC_ACID", "IODINE", "IRON", "MAGNESIUM", "MANGANESE", "MOLYBDENUM", "MONOUNSATURATED_FAT", "NIACIN", "PANTOTHENIC_ACID", "PHOSPHORUS", "POLYUNSATURATED_FAT", "POTASSIUM", "PROTEIN", "RIBOFLAVIN", "SATURATED_FAT", "SELENIUM", "SODIUM", "SUGAR", "THIAMIN", "TRANS_FAT", "UNSATURATED_FAT", "VITAMIN_A", "VITAMIN_B12", "VITAMIN_B6", "VITAMIN_C", "VITAMIN_D", "VITAMIN_E", "VITAMIN_K", "ZINC", "FOLATE" ], "description": "Required. Aggregated nutrient.", "type": "string", "enumDescriptions": [ "Unspecified nutrient.", "Value representing biotin nutrient.", "Value representing caffeine nutrient.", "Value representing calcium nutrient.", "Value representing chloride nutrient.", "Value representing carbohydrates nutrient.", "Value representing cholesterol nutrient.", "Value representing chromium nutrient.", "Value representing copper nutrient.", "Value representing dietary fiber nutrient.", "Value representing folic acid nutrient.", "Value representing iodine nutrient.", "Value representing iron nutrient.", "Value representing magnesium nutrient.", "Value representing manganese nutrient.", "Value representing molybdenum nutrient.", "Value representing monounsaturated fat nutrient.", "Value representing niacin nutrient.", "Value representing pantothenic acid nutrient.", "Value representing phosphorus nutrient.", "Value representing polyunsaturated fat nutrient.", "Value representing potassium nutrient.", "Value representing protein nutrient.", "Value representing riboflavin nutrient.", "Value representing saturated fat nutrient.", "Value representing selenium nutrient.", "Value representing sodium nutrient.", "Value representing sugar nutrient.", "Value representing thiamin nutrient.", "Value representing trans fat nutrient.", "Value representing unsaturated fat nutrient.", "Value representing vitamin A nutrient.", "Value representing vitamin B12 nutrient.", "Value representing vitamin B6 nutrient.", "Value representing vitamin C nutrient.", "Value representing vitamin D nutrient.", "Value representing vitamin E nutrient.", "Value representing vitamin K nutrient.", "Value representing zinc nutrient.", "Value representing folate nutrient." ] } }, "description": "Nutrient quantity rollup." }, "MedicalDeviceInfo": { "id": "MedicalDeviceInfo", "type": "object", "description": "Software as Medical Device (SaMD) metadata. Used to construct the Unique Device Identifier (UDI).", "properties": { "serviceVersion": { "readOnly": true, "description": "Output only. The service version used by the feature.", "type": "string" }, "deviceModel": { "type": "string", "readOnly": true, "description": "Output only. The model name or device type of the compatible device used to collect the data." }, "firmwareVersion": { "readOnly": true, "description": "Output only. The firmware version running on the compatible device used to collect the data.", "type": "string" }, "algorithmVersion": { "description": "Output only. The algorithm version used by the feature.", "readOnly": true, "type": "string" }, "featureVersion": { "type": "string", "description": "Output only. The version of the feature/app running on the device.", "readOnly": true } } }, "ListSubscriptionsResponse": { "description": "Response message for ListSubscriptions.", "properties": { "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "subscriptions": { "type": "array", "description": "The subscriptions from the specified subscriber.", "items": { "$ref": "Subscription" } } }, "type": "object", "id": "ListSubscriptionsResponse" }, "ActiveMinutesByActivityLevel": { "description": "Active minutes at a given activity level.", "properties": { "activityLevel": { "description": "Required. The level of activity.", "enum": [ "ACTIVITY_LEVEL_UNSPECIFIED", "LIGHT", "MODERATE", "VIGOROUS" ], "type": "string", "enumDescriptions": [ "Activity level is unspecified.", "Light activity level.", "Moderate activity level.", "Vigorous activity level." ] }, "activeMinutes": { "format": "int64", "description": "Required. Number of whole minutes spent in activity.", "type": "string" } }, "type": "object", "id": "ActiveMinutesByActivityLevel" }, "VO2Max": { "description": "VO2 max measurement.", "type": "object", "properties": { "vo2Max": { "format": "double", "type": "number", "description": "Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min." }, "sampleTime": { "description": "Required. The time at which VO2 max was measured.", "$ref": "ObservationSampleTime" }, "measurementMethod": { "enumDescriptions": [ "Unspecified measurement method.", "Fitbit specific, measures VO2 max rate during a run.", "Google specific, measures VO2 max rate for a user based on their demographic data.", "Run as far as possible for 12 minutes. Distance correlated with age and gender translates to a VO2 max value.", "Maximum heart rate divided by the resting heart rate, with a multiplier applied. Does not require any exercise.", "Measured by a medical device called metabolic cart.", "Continuous 20m back-and-forth runs with increasing difficulty, until exhaustion.", "Measured using walking exercise.", "Healthkit specific, measures VO2 max rate by monitoring exercise to the user’s physical limit. Similar to COOPER_TEST or MULTISTAGE_FITNESS_TEST.", "Healthkit specific, estimates VO2 max rate based on low-intensity exercise. Similar to ROCKPORT_FITNESS_TEST.", "Healthkit specific, estimates VO2 max rate without any exercise. Similar to HEART_RATE_RATIO.", "Use when the method is not covered in this enum." ], "description": "Optional. The method used to measure the VO2 max value.", "enum": [ "MEASUREMENT_METHOD_UNSPECIFIED", "FITBIT_RUN", "GOOGLE_DEMOGRAPHIC", "COOPER_TEST", "HEART_RATE_RATIO", "METABOLIC_CART", "MULTISTAGE_FITNESS_TEST", "ROCKPORT_FITNESS_TEST", "MAX_EXERCISE", "PREDICTION_SUB_MAX_EXERCISE", "PREDICTION_NON_EXERCISE", "OTHER" ], "type": "string" } }, "id": "VO2Max" }, "DistanceRollupValue": { "id": "DistanceRollupValue", "description": "Result of the rollup of the user's distance.", "type": "object", "properties": { "millimetersSum": { "description": "Sum of the distance in millimeters.", "type": "string", "format": "int64" } } }, "MenstrualPeriod": { "id": "MenstrualPeriod", "properties": { "notes": { "description": "Optional. Standard free-form notes captured at manual logging.", "type": "string" }, "interval": { "description": "Required. Observed interval.", "$ref": "ObservationTimeInterval" } }, "type": "object", "description": "Menstrual period record." }, "BatchDeleteDataPointsRequest": { "description": "Request to delete a batch of identifiable data points.", "type": "object", "id": "BatchDeleteDataPointsRequest", "properties": { "names": { "items": { "type": "string" }, "description": "Required. The names of the DataPoints to delete. A maximum of 10000 data points can be deleted in a single request.", "type": "array" } } }, "DailyRollupDataPoint": { "description": "Value of a daily rollup for a single civil time interval (aggregation window) of reconciled data points from all data sources, excluding those data points that are identified as recorded by wearables in intervals when they were not actually worn.", "id": "DailyRollupDataPoint", "type": "object", "properties": { "sedentaryPeriod": { "$ref": "SedentaryPeriodRollupValue", "description": "Returned by default when rolling up data points from the `sedentary-period` data type, or when requested explicitly using the `sedentary-period` rollup type identifier." }, "altitude": { "description": "Returned by default when rolling up data points from the `altitude` data type, or when requested explicitly using the `altitude` rollup type identifier.", "$ref": "AltitudeRollupValue" }, "coreBodyTemperature": { "$ref": "CoreBodyTemperatureRollupValue", "description": "Returned by default when rolling up data points from the `core-body-temperature` data type, or when requested explicitly using the `core-body-temperature` rollup type identifier." }, "activityLevel": { "description": "Returned by default when rolling up data points from the `activity-level` data type, or when requested explicitly using the `activity-level` rollup type identifier.", "$ref": "ActivityLevelRollupValue" }, "heartRate": { "$ref": "HeartRateRollupValue", "description": "Returned by default when rolling up data points from the `heart-rate` data type, or when requested explicitly using the `heart-rate` rollup type identifier." }, "heartRateVariabilityPersonalRange": { "$ref": "HeartRateVariabilityPersonalRangeRollupValue", "description": "Returned by default when rolling up data points from the `daily-heart-rate-variability` data type, or when requested explicitly using the `heart-rate-variability-personal-range` rollup type identifier." }, "weight": { "description": "Returned by default when rolling up data points from the `weight` data type, or when requested explicitly using the `weight` rollup type identifier.", "$ref": "WeightRollupValue" }, "activeEnergyBurned": { "$ref": "ActiveEnergyBurnedRollupValue", "description": "Returned by default when rolling up data points from the `active-energy-burned` data type." }, "bodyFat": { "description": "Returned by default when rolling up data points from the `body-fat` data type, or when requested explicitly using the `body-fat` rollup type identifier.", "$ref": "BodyFatRollupValue" }, "civilEndTime": { "$ref": "CivilDateTime", "description": "End time of the window this value aggregates over" }, "activeMinutes": { "$ref": "ActiveMinutesRollupValue", "description": "Returned by default when rolling up data points from the `active-minutes` data type, or when requested explicitly using the `active-minutes` rollup type identifier." }, "floors": { "$ref": "FloorsRollupValue", "description": "Returned by default when rolling up data points from the `floors` data type, or when requested explicitly using the `floors` rollup type identifier." }, "hydrationLog": { "description": "Returned by default when rolling up data points from the `hydration-log` data type, or when requested explicitly using the `hydration-log` rollup type identifier.", "$ref": "HydrationLogRollupValue" }, "runVo2Max": { "$ref": "RunVO2MaxRollupValue", "description": "Returned by default when rolling up data points from the `run-vo2-max` data type, or when requested explicitly using the `run-vo2-max` rollup type identifier." }, "activeZoneMinutes": { "$ref": "ActiveZoneMinutesRollupValue", "description": "Returned by default when rolling up data points from the `active-zone-minutes` data type, or when requested explicitly using the `active-zone-minutes` rollup type identifier." }, "caloriesInHeartRateZone": { "description": "Returned by default when rolling up data points from the `calories-in-heart-rate-zone` data type, or when requested explicitly using the `calories-in-heart-rate-zone` rollup type identifier.", "$ref": "CaloriesInHeartRateZoneRollupValue" }, "nutritionLog": { "description": "Returned by default when rolling up data points from the `nutrition-log` data type, or when requested explicitly using the `nutrition-log` rollup type identifier.", "$ref": "NutritionLogRollupValue" }, "bloodGlucose": { "description": "Returned by default when rolling up data points from the `blood-glucose` data type.", "$ref": "BloodGlucoseRollupValue" }, "civilStartTime": { "$ref": "CivilDateTime", "description": "Start time of the window this value aggregates over" }, "timeInHeartRateZone": { "$ref": "TimeInHeartRateZoneRollupValue", "description": "Returned by default when rolling up data points from the `time-in-heart-rate-zone` data type, or when requested explicitly using the `time-in-heart-rate-zone` rollup type identifier." }, "distance": { "$ref": "DistanceRollupValue", "description": "Returned by default when rolling up data points from the `distance` data type, or when requested explicitly using the `distance` rollup type identifier." }, "swimLengthsData": { "description": "Returned by default when rolling up data points from the `swim-lengths-data` data type, or when requested explicitly using the `swim-lengths-data` rollup type identifier.", "$ref": "SwimLengthsDataRollupValue" }, "restingHeartRatePersonalRange": { "$ref": "RestingHeartRatePersonalRangeRollupValue", "description": "Returned by default when rolling up data points from the `daily-resting-heart-rate` data type, or when requested explicitly using the `resting-heart-rate-personal-range` rollup type identifier." }, "steps": { "description": "Returned by default when rolling up data points from the `steps` data type, or when requested explicitly using the `steps` rollup type identifier.", "$ref": "StepsRollupValue" }, "totalCalories": { "description": "Returned by default when rolling up data points from the `total-calories` data type, or when requested explicitly using the `total-calories` rollup type identifier.", "$ref": "TotalCaloriesRollupValue" } } }, "RunVO2MaxRollupValue": { "type": "object", "id": "RunVO2MaxRollupValue", "description": "Represents the result of the rollup of the user's daily heart rate variability personal range.", "properties": { "rateAvg": { "format": "double", "description": "Average value of run VO2 max in the interval.", "type": "number" }, "rateMin": { "format": "double", "description": "Minimum value of run VO2 max in the interval..", "type": "number" }, "rateMax": { "description": "Maximum value of run VO2 max in the interval.", "format": "double", "type": "number" } } }, "CoreBodyTemperature": { "properties": { "id": { "description": "Optional. The unique identifier of the core body temperature measurement.", "type": "string" }, "sampleTime": { "$ref": "ObservationSampleTime", "description": "Required. The time at which core body temperature was measured." }, "measurementLocation": { "description": "Optional. The location of the core body temperature measurement.", "type": "string", "enumDescriptions": [ "Measurement location is unspecified.", "Other measurement location.", "Armpit measurement location.", "Body measurement location.", "Ear measurement location.", "Finger measurement location.", "Gastro-intestinal measurement location.", "Mouth measurement location.", "Rectum measurement location.", "Toe measurement location.", "Ear drum measurement location.", "Temporal artery measurement location.", "Forehead measurement location.", "Urinary bladder measurement location.", "Nasal measurement location.", "Nasopharyngeal measurement location.", "Wrist measurement location.", "Vagina measurement location." ], "enum": [ "MEASUREMENT_LOCATION_UNSPECIFIED", "OTHER", "ARMPIT", "BODY", "EAR", "FINGER", "GASTRO_INTESTINAL", "MOUTH", "RECTUM", "TOE", "EAR_DRUM", "TEMPORAL_ARTERY", "FOREHEAD", "URINARY_BLADDER", "NASAL", "NASOPHARYNGEAL", "WRIST", "VAGINA" ] }, "temperatureCelsius": { "format": "double", "description": "Required. The core body temperature in Celsius.", "type": "number" } }, "type": "object", "description": "Core body temperature measurement, distinct from peripheral body temperature, reflects the temperature of the body's internal organs.", "id": "CoreBodyTemperature" }, "TotalCaloriesRollupValue": { "id": "TotalCaloriesRollupValue", "properties": { "kcalSum": { "type": "number", "format": "double", "description": "Sum of the total calories in kilocalories." } }, "type": "object", "description": "Represents the result of the rollup of the user's total calories. Note: Queries for the `total-calories` data type must include a time interval filter (such as `total_calories.interval.start_time` or `total_calories.interval.civil_start_time`). The maximum range is 14 days. Example filter query: `total_calories.interval.start_time \u003e= \"2026-04-20T00:00:00Z\" AND total_calories.interval.start_time \u003c \"2026-04-21T00:00:00Z\"`" }, "FoodServing": { "type": "object", "description": "Represents different properties and information about the serving of a specific food.", "id": "FoodServing", "properties": { "foodMeasurementUnit": { "type": "string", "description": "Required. Food measurement unit" }, "multiplier": { "description": "Optional. Value representing the multiplier used to compute the energy when using this serving instead of the default serving.", "format": "double", "type": "number" }, "amount": { "description": "Optional. Amount of food consumed, fractional values are supported.", "format": "double", "type": "number" }, "foodMeasurementUnitDisplayNamePlural": { "type": "string", "description": "Output only. Legacy measurement unit for serving size in plural form (e.g. \"pieces\", \"grams\").", "readOnly": true }, "foodMeasurementUnitDisplayName": { "type": "string", "description": "Output only. Legacy measurement unit for serving size in singular form (e.g. \"piece\", \"gram\").", "readOnly": true } } }, "CivilDateTime": { "properties": { "date": { "description": "Required. Calendar date.", "$ref": "Date" }, "time": { "description": "Optional. Time of day. Defaults to the start of the day, at midnight if omitted.", "$ref": "TimeOfDay" } }, "id": "CivilDateTime", "type": "object", "description": "Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries." }, "Food": { "type": "object", "id": "Food", "description": "Represents a food item.", "properties": { "languageCode": { "description": "Optional. The language code where the food is available in format xx-XX. Supported values are defined in Settings.food_language_code.", "type": "string" }, "totalCarbohydrate": { "$ref": "WeightQuantity", "description": "Optional. Value representing the total carbohydrate of the food for the default serving." }, "mealType": { "description": "Optional. The meal type associated with this food.", "enum": [ "MEAL_TYPE_UNSPECIFIED", "BEFORE_BREAKFAST", "BREAKFAST", "BEFORE_LUNCH", "LUNCH", "BEFORE_DINNER", "DINNER", "AFTER_DINNER", "SNACK", "ANYTIME" ], "enumDescriptions": [ "Unspecified meal type.", "Value representing a meal before breakfast.", "Value representing a breakfast.", "Value representing a morning snack.", "Value representing a lunch.", "Value representing an afternoon snack.", "Value representing dinner.", "Value representing an evening snack.", "Value representing any meal outside of the usual three meals per day.", "Value representing any time (legacy NA)." ], "type": "string" }, "servings": { "description": "Optional. The serving of the food.", "type": "array", "items": { "$ref": "FoodServing" } }, "defaultServing": { "description": "Required. Value representing the default serving of the food.", "$ref": "FoodServing" }, "nutrients": { "type": "array", "description": "Optional. Value representing the nutrients of the food for the default serving.", "items": { "$ref": "NutrientQuantity" } }, "energyAvg": { "$ref": "EnergyQuantity", "description": "Optional. Value representing the average energy of the food for the default serving." }, "energyFromFat": { "$ref": "EnergyQuantity", "description": "Optional. Value representing the energy from fat of the food for the default serving." }, "energyMax": { "description": "Optional. Value representing the maximum energy of the food for the default serving.", "$ref": "EnergyQuantity" }, "accessLevel": { "enum": [ "FOOD_ACCESS_LEVEL_UNSPECIFIED", "FOOD_ACCESS_LEVEL_PUBLIC", "FOOD_ACCESS_LEVEL_PRIVATE" ], "enumDescriptions": [ "Unspecified food access level.", "Public food access level.", "Private food access level." ], "description": "Required. The access level of the food.", "type": "string" }, "displayName": { "type": "string", "description": "Required. The display name of the food." }, "energyMin": { "$ref": "EnergyQuantity", "description": "Optional. Value representing the minimum energy of the food for the default serving." }, "brand": { "description": "Optional. The brand of the food.", "type": "string" }, "totalFat": { "$ref": "WeightQuantity", "description": "Optional. Value representing the total fat of the food for the default serving." }, "description": { "description": "Optional. The description of the food.", "type": "string" } } }, "ListDataPointsResponse": { "type": "object", "id": "ListDataPointsResponse", "description": "Response containing raw data points matching the query", "properties": { "dataPoints": { "type": "array", "items": { "$ref": "DataPoint" }, "description": "Data points matching the query" }, "nextPageToken": { "description": "Next page token, empty if the response is complete", "type": "string" } } }, "DataPoint": { "id": "DataPoint", "properties": { "dailyHeartRateVariability": { "$ref": "DailyHeartRateVariability", "description": "Optional. Data for points in the `daily-heart-rate-variability` daily data type collection." }, "irregularRhythmNotification": { "description": "Optional. Data for points in the `irregular-rhythm-notification` session data type collection.", "$ref": "IrregularRhythmNotification" }, "floors": { "$ref": "Floors", "description": "Optional. Data for points in the `floors` interval data type collection." }, "heartRate": { "$ref": "HeartRate", "description": "Optional. Data for points in the `heart-rate` sample data type collection." }, "swimLengthsData": { "description": "Optional. Data for points in the `swim-lengths-data` interval data type collection.", "$ref": "SwimLengthsData" }, "activeZoneMinutes": { "description": "Optional. Data for points in the `active-zone-minutes` interval data type collection, measured in minutes.", "$ref": "ActiveZoneMinutes" }, "nutritionLog": { "description": "Optional. Data for points in the `nutrition-log` session data type collection.", "$ref": "NutritionLog" }, "bloodGlucose": { "description": "Optional. Data for points in the `blood-glucose` sample data type collection.", "$ref": "BloodGlucose" }, "foodMeasurementUnit": { "$ref": "FoodMeasurementUnit", "description": "Optional. The food measurement unit details." }, "weight": { "$ref": "Weight", "description": "Optional. Data for points in the `weight` sample data type collection." }, "dataSource": { "description": "Optional. Data source information for the metric", "$ref": "DataSource" }, "activeEnergyBurned": { "$ref": "ActiveEnergyBurned", "description": "Optional. Data for points in the `active-energy-burned` interval data type collection." }, "dailyRestingHeartRate": { "$ref": "DailyRestingHeartRate", "description": "Optional. Data for points in the `daily-resting-heart-rate` daily data type collection." }, "dailyHeartRateZones": { "description": "Optional. Data for points in the `daily-heart-rate-zones` daily data type collection.", "$ref": "DailyHeartRateZones" }, "exercise": { "description": "Optional. Data for points in the `exercise` session data type collection.", "$ref": "Exercise" }, "symptoms": { "description": "Optional. Data for points in the `symptoms` sample data type collection.", "$ref": "Symptoms" }, "runVo2Max": { "$ref": "RunVO2Max", "description": "Optional. Data for points in the `run-vo2-max` sample data type collection." }, "electrocardiogram": { "description": "Optional. Data for points in the `electrocardiogram` session data type collection.", "$ref": "Electrocardiogram" }, "heartRateVariability": { "$ref": "HeartRateVariability", "description": "Optional. Data for points in the `heart-rate-variability` sample data type collection." }, "ovulationTest": { "description": "Optional. Data for points in the `ovulation-test` sample data type collection.", "$ref": "OvulationTest" }, "timeInHeartRateZone": { "description": "Optional. Data for points in the `time-in-heart-rate-zone` interval data type collection.", "$ref": "TimeInHeartRateZone" }, "steps": { "description": "Optional. Data for points in the `steps` interval data type collection.", "$ref": "Steps" }, "dailySleepTemperatureDerivations": { "$ref": "DailySleepTemperatureDerivations", "description": "Optional. Data for points in the `daily-sleep-temperature-derivations` daily data type collection." }, "distance": { "description": "Optional. Data for points in the `distance` interval data type collection.", "$ref": "Distance" }, "respiratoryRateSleepSummary": { "description": "Optional. Data for points in the `respiratory-rate-sleep-summary` sample data type collection.", "$ref": "RespiratoryRateSleepSummary" }, "height": { "$ref": "Height", "description": "Optional. Data for points in the `height` sample data type collection." }, "dailyVo2Max": { "description": "Optional. Data for points in the `daily-vo2-max` daily data type collection.", "$ref": "DailyVO2Max" }, "name": { "description": "Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens.", "type": "string" }, "menstrualPeriod": { "$ref": "MenstrualPeriod", "description": "Optional. Data for points in the `menstrual-period` interval data type collection." }, "moods": { "$ref": "Moods", "description": "Optional. Data for points in the `moods` sample data type collection." }, "oxygenSaturation": { "description": "Optional. Data for points in the `oxygen-saturation` sample data type collection.", "$ref": "OxygenSaturation" }, "dailyRespiratoryRate": { "description": "Optional. Data for points in the `daily-respiratory-rate` daily data type collection.", "$ref": "DailyRespiratoryRate" }, "altitude": { "$ref": "Altitude", "description": "Optional. Data for points in the `altitude` interval data type collection." }, "vo2Max": { "$ref": "VO2Max", "description": "Optional. Data for points in the `vo2-max` sample data type collection." }, "activeMinutes": { "description": "Optional. Data for points in the `active-minutes` interval data type collection.", "$ref": "ActiveMinutes" }, "bodyFat": { "$ref": "BodyFat", "description": "Optional. Data for points in the `body-fat` sample data type collection." }, "hydrationLog": { "$ref": "HydrationLog", "description": "Optional. Data for points in the `hydration-log` session data type collection." }, "food": { "$ref": "Food", "description": "Optional. The food details." }, "coreBodyTemperature": { "$ref": "CoreBodyTemperature", "description": "Optional. Data for points in the `core-body-temperature` sample data type collection." }, "basalEnergyBurned": { "description": "Optional. Data for points in the `basal-energy-burned` interval data type collection.", "$ref": "BasalEnergyBurned" }, "sleep": { "description": "Optional. Data for points in the `sleep` session data type collection.", "$ref": "Sleep" }, "activityLevel": { "description": "Optional. Data for points in the `activity-level` daily data type collection.", "$ref": "ActivityLevel" }, "sedentaryPeriod": { "$ref": "SedentaryPeriod", "description": "Optional. Data for points in the `sedentary-period` interval data type collection." }, "dailyOxygenSaturation": { "description": "Optional. Data for points in the `daily-oxygen-saturation` daily data type collection.", "$ref": "DailyOxygenSaturation" } }, "type": "object", "description": "A computed or recorded metric." }, "BloodGlucose": { "description": "Represents a blood glucose level measurement. LINT: LEGACY_NAMES", "properties": { "measurementTiming": { "enum": [ "MEASUREMENT_TIMING_UNSPECIFIED", "AFTER_MEAL", "BEFORE_MEAL", "FASTING", "GENERAL", "BEFORE_BED", "OVER_NIGHT" ], "enumDescriptions": [ "Unspecified measurement timing.", "Measurement taken after meal.", "Measurement taken before meal.", "Measurement taken while fasting.", "General measurement (not associated with a meal or time of day).", "Measurement taken before bed.", "Measurement taken over night." ], "description": "Optional. Timing of the measurement.", "type": "string" }, "measurementSource": { "enumDescriptions": [ "Unspecified measurement source.", "Self-monitoring of blood glucose (Blood glucose meter)", "Continuous glucose monitoring device", "Laboratory test" ], "type": "string", "description": "Optional. Source of the measurement.", "enum": [ "MEASUREMENT_SOURCE_UNSPECIFIED", "SELF_MONITORING_BLOOD_GLUCOSE", "CONTINUOUS_GLUCOSE_MONITORING", "LAB_TEST" ] }, "sampleTime": { "$ref": "ObservationSampleTime", "description": "Required. The time at which blood glucose was measured." }, "mealType": { "enum": [ "MEAL_TYPE_UNSPECIFIED", "BREAKFAST", "LUNCH", "DINNER", "SNACK" ], "enumDescriptions": [ "Unspecified meal type.", "Breakfast.", "Lunch.", "Dinner.", "Snack." ], "description": "Optional. Meal type of the measurement.", "type": "string" }, "specimen": { "description": "Optional. Type of body fluid used to measure the blood glucose.", "enum": [ "SPECIMEN_UNSPECIFIED", "CAPILLARY_BLOOD", "INTERSTITIAL_FLUID", "PLASMA", "SERUM", "TEARS", "WHOLE_BLOOD" ], "enumDescriptions": [ "Unspecified specimen.", "Capillary blood.", "Interstitial fluid.", "Plasma.", "Serum.", "Tears.", "Whole blood." ], "type": "string" }, "notes": { "description": "Optional. Standard free-form notes captured at manual logging.", "type": "string" }, "bloodGlucoseMilligramsPerDeciliter": { "format": "double", "description": "Required. Blood glucose level concentration in mg/dL.", "type": "number" } }, "id": "BloodGlucose", "type": "object" }, "TimeOfDay": { "properties": { "hours": { "format": "int32", "type": "integer", "description": "Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time." }, "nanos": { "description": "Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.", "format": "int32", "type": "integer" }, "minutes": { "type": "integer", "format": "int32", "description": "Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59." }, "seconds": { "description": "Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.", "format": "int32", "type": "integer" } }, "description": "Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`.", "type": "object", "id": "TimeOfDay" }, "OxygenSaturation": { "properties": { "sampleTime": { "description": "Required. The time at which oxygen saturation was measured.", "$ref": "ObservationSampleTime" }, "percentage": { "description": "Required. The oxygen saturation percentage. Valid values are from 0 to 100.", "type": "number", "format": "double" } }, "description": "Captures the user's instantaneous oxygen saturation percentage (SpO2).", "type": "object", "id": "OxygenSaturation" }, "GoogleDevicesandservicesHealthV4DataType": { "description": "Represents a type of health data a user can have data points recorded for. It matches the parent resource of collection containing data points of the given type. Clients currently do not need to interact with this resource directly.", "id": "GoogleDevicesandservicesHealthV4DataType", "type": "object", "properties": { "name": { "description": "Identifier. The resource name of the data type. Format: `users/{user}/dataTypes/{data_type}` See DataPoint.name for examples and possible values.", "type": "string" } } }, "FloorsRollupValue": { "id": "FloorsRollupValue", "type": "object", "description": "Represents the result of the rollup of the user's floors.", "properties": { "countSum": { "type": "string", "description": "Sum of the floors count.", "format": "int64" } } }, "RespiratoryRateSleepSummary": { "type": "object", "properties": { "sampleTime": { "$ref": "ObservationSampleTime", "description": "Required. The time at which respiratory rate was measured." }, "remSleepStats": { "description": "Optional. Respiratory rate statistics for REM sleep.", "$ref": "RespiratoryRateSleepSummaryStatistics" }, "lightSleepStats": { "description": "Optional. Respiratory rate statistics for light sleep.", "$ref": "RespiratoryRateSleepSummaryStatistics" }, "deepSleepStats": { "description": "Optional. Respiratory rate statistics for deep sleep.", "$ref": "RespiratoryRateSleepSummaryStatistics" }, "fullSleepStats": { "description": "Required. Full respiratory rate statistics.", "$ref": "RespiratoryRateSleepSummaryStatistics" } }, "description": "Records respiratory rate details during sleep. Can have multiple per day if the user sleeps multiple times.", "id": "RespiratoryRateSleepSummary" }, "SubscriberConfig": { "id": "SubscriberConfig", "properties": { "subscriptionCreatePolicy": { "type": "string", "description": "Required. Policy for subscription creation.", "enum": [ "SUBSCRIPTION_CREATE_POLICY_UNSPECIFIED", "AUTOMATIC", "MANUAL" ], "enumDescriptions": [ "Represents an unspecified policy.", "When using `AUTOMATIC`, individual subscriptions are not created or stored. Instead, eligibility for notifications is computed dynamically. When a data update occurs for a given data type, notifications are sent to all subscribers with an `AUTOMATIC` policy for that data type, provided the user has granted the necessary consents. This means you do not need to call `CreateSubscription` for each user; notifications are managed automatically based on user consents. As `Subscription` resources are not stored, they cannot be retrieved or managed through `GetSubscription`, `ListSubscriptions`, `UpdateSubscription`, or `DeleteSubscription`.", "Requires subscriptions to be created manually for new users. The developer needs to call CreateSubscription for new users." ] }, "dataTypes": { "type": "array", "items": { "type": "string" }, "description": "Required. See [Google Health API data types](https://developers.google.com/health/data-types) for the list of supported data types. Values should be in kebab-case." } }, "type": "object", "description": "Configuration for a subscriber. A notification is sent to a subscription ONLY if the subscriber has a config for the data type." }, "SwimLengthsData": { "id": "SwimLengthsData", "type": "object", "properties": { "interval": { "description": "Required. Observed interval.", "$ref": "ObservationTimeInterval" }, "swimStrokeType": { "enum": [ "SWIM_STROKE_TYPE_UNSPECIFIED", "FREESTYLE", "BACKSTROKE", "BREASTSTROKE", "BUTTERFLY" ], "description": "Required. Swim stroke type.", "enumDescriptions": [ "Swim stroke type is unspecified.", "Freestyle swim stroke type.", "Backstroke swim stroke type.", "Breaststroke swim stroke type.", "Butterfly swim stroke type." ], "type": "string" }, "strokeCount": { "type": "string", "format": "int64", "description": "Required. Number of strokes in the lap." } }, "description": "Swim lengths data over the time interval." }, "Altitude": { "properties": { "interval": { "description": "Required. Observed interval.", "$ref": "ObservationTimeInterval" }, "gainMillimeters": { "description": "Required. Altitude gain in millimeters over the observed interval.", "format": "int64", "type": "string" } }, "type": "object", "id": "Altitude", "description": "Captures the altitude gain (i.e. deltas), and not level above sea, for a user in millimeters." }, "DailyRespiratoryRate": { "id": "DailyRespiratoryRate", "type": "object", "properties": { "breathsPerMinute": { "format": "double", "type": "number", "description": "Required. The average number of breaths taken per minute." }, "date": { "description": "Required. The date on which the respiratory rate was measured.", "$ref": "Date" } }, "description": "A daily average respiratory rate (breaths per minute) for a day of the year. One data point per day calculated for the main sleep." }, "NutritionLogRollupValue": { "description": "Represents the result of the rollup of the nutrition log data type.", "type": "object", "properties": { "totalCarbohydrate": { "description": "Total carbohydrate rollup.", "$ref": "WeightQuantityRollup" }, "nutrients": { "items": { "$ref": "NutrientQuantityRollup" }, "type": "array", "description": "List of the nutrient roll-ups by the nutrient type." }, "energyFromFat": { "$ref": "EnergyQuantityRollup", "description": "Value Energy from fat rollup." }, "energy": { "$ref": "EnergyQuantityRollup", "description": "Energy rollup." }, "totalFat": { "description": "Total fat rollup.", "$ref": "WeightQuantityRollup" } }, "id": "NutritionLogRollupValue" }, "CreateSubscriberPayload": { "type": "object", "id": "CreateSubscriberPayload", "description": "Payload for creating a subscriber.", "properties": { "endpointUri": { "type": "string", "description": "Required. The full HTTPS URI where update notifications will be sent. The URI must be a valid URL and use HTTPS as the scheme. This endpoint will be verified during the `CreateSubscriber` call. See CreateSubscriber RPC documentation for verification details." }, "subscriberConfigs": { "type": "array", "description": "Optional. Configuration for the subscriber.", "items": { "$ref": "SubscriberConfig" } }, "endpointAuthorization": { "$ref": "EndpointAuthorization", "description": "Required. Authorization mechanism for the subscriber endpoint. The `secret` within this message is crucial for endpoint verification and for securing webhook notifications." } } }, "HeartRateRollupValue": { "description": "Represents the result of the rollup of the heart rate data type.", "properties": { "beatsPerMinuteMin": { "description": "The minimum heart rate value in the interval.", "type": "number", "format": "double" }, "beatsPerMinuteAvg": { "type": "number", "description": "The average heart rate value in the interval.", "format": "double" }, "beatsPerMinuteMax": { "description": "The maximum heart rate value in the interval.", "format": "double", "type": "number" } }, "type": "object", "id": "HeartRateRollupValue" }, "Height": { "type": "object", "id": "Height", "description": "Body height measurement.", "properties": { "heightMillimeters": { "type": "string", "format": "int64", "description": "Required. Height of the user in millimeters." }, "sampleTime": { "description": "Required. The time at which the height was recorded.", "$ref": "ObservationSampleTime" } } }, "AlertWindow": { "description": "An analysis window evaluated for AFib. Note: The current version of the algorithm will only produce alerts if all windows are positive. So anything returned from the API will always have the positive bit set to true. Internally, windows can be negative, however. We never save \"inconclusive\" windows (they aren't produced by the algorithm).", "id": "AlertWindow", "type": "object", "properties": { "startTime": { "format": "google-datetime", "description": "Required. Observed interval. The start time of the analysis window.", "type": "string" }, "endUtcOffset": { "format": "google-duration", "type": "string", "description": "Required. The UTC offset of the user's timezone when the analysis window ended." }, "startUtcOffset": { "type": "string", "format": "google-duration", "description": "Required. The UTC offset of the user's timezone when the analysis window started." }, "civilStartTime": { "description": "Output only. Observed interval start time in civil time in the timezone the subject is in at the start of the observed interval", "readOnly": true, "$ref": "CivilDateTime" }, "civilEndTime": { "readOnly": true, "description": "Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval", "$ref": "CivilDateTime" }, "positive": { "type": "boolean", "description": "Optional. Flag indicating whether the window was positive for AFib or not. A `true` value indicates that AFib was detected in this window. A `false` value means AFib was not detected, but does not guarantee the absence of AFib." }, "heartBeats": { "type": "array", "items": { "$ref": "HeartBeat" }, "description": "Optional. All heart beats in the interval contained in this analysis window." }, "endTime": { "format": "google-datetime", "type": "string", "description": "Required. The end time of the analysis window." } } }, "SessionTimeInterval": { "type": "object", "description": "Represents a time interval of session data point, which bundles multiple observed metrics together.", "id": "SessionTimeInterval", "properties": { "startTime": { "format": "google-datetime", "type": "string", "description": "Required. The start time of the observed session." }, "endTime": { "format": "google-datetime", "type": "string", "description": "Required. The end time of the observed session." }, "endUtcOffset": { "format": "google-duration", "type": "string", "description": "Required. The offset of the user's local time at the end of the session relative to the Coordinated Universal Time (UTC)." }, "civilEndTime": { "$ref": "CivilDateTime", "readOnly": true, "description": "Output only. Session end time in civil time in the timezone the subject is in at the end of the session." }, "startUtcOffset": { "format": "google-duration", "type": "string", "description": "Required. The offset of the user's local time at the start of the session relative to the Coordinated Universal Time (UTC)." }, "civilStartTime": { "$ref": "CivilDateTime", "description": "Output only. Session start time in civil time in the timezone the subject is in at the start of the session.", "readOnly": true } } }, "GoogleDevicesandservicesHealthV4WebhookNotificationCloudLog": { "id": "GoogleDevicesandservicesHealthV4WebhookNotificationCloudLog", "type": "object", "properties": { "httpResponse": { "description": "Required. Represents the HTTP response. This message includes the status code, reason phrase, headers, and body.", "$ref": "HttpResponse" } }, "description": "Log message for a webhook notification sent by the Google Health API to a subscriber's endpoint. Includes the HTTP response received from the endpoint." }, "HttpResponse": { "type": "object", "description": "Represents an HTTP response.", "properties": { "reason": { "type": "string", "description": "The HTTP reason phrase, such as \"OK\" or \"Not Found\"." }, "headers": { "type": "array", "description": "The HTTP response headers. The ordering of the headers is significant. Multiple headers with the same key may present for the response.", "items": { "$ref": "HttpHeader" } }, "body": { "format": "byte", "type": "string", "description": "The HTTP response body. If the body is not expected, it should be empty." }, "status": { "description": "The HTTP status code, such as 200 or 404.", "type": "integer", "format": "int32" } }, "id": "HttpResponse" }, "SleepStage": { "id": "SleepStage", "description": "Sleep stage segment.", "type": "object", "properties": { "type": { "enum": [ "SLEEP_STAGE_TYPE_UNSPECIFIED", "AWAKE", "LIGHT", "DEEP", "REM", "ASLEEP", "RESTLESS" ], "description": "Required. Sleep stage type: AWAKE, DEEP, REM, LIGHT etc.", "enumDescriptions": [ "The default unset value.", "Sleep stage AWAKE.", "Sleep stage LIGHT.", "Sleep stage DEEP.", "Sleep stage REM.", "Sleep stage ASLEEP.", "Sleep stage RESTLESS." ], "type": "string" }, "endTime": { "type": "string", "format": "google-datetime", "description": "Required. Sleep stage end time." }, "updateTime": { "type": "string", "format": "google-datetime", "readOnly": true, "description": "Output only. Last update time of this sleep stages segment." }, "createTime": { "readOnly": true, "description": "Output only. Creation time of this sleep stages segment.", "format": "google-datetime", "type": "string" }, "startUtcOffset": { "format": "google-duration", "description": "Required. The offset of the user's local time at the start of the sleep stage relative to the Coordinated Universal Time (UTC).", "type": "string" }, "startTime": { "format": "google-datetime", "type": "string", "description": "Required. Sleep stage start time." }, "endUtcOffset": { "description": "Required. The offset of the user's local time at the end of the sleep stage relative to the Coordinated Universal Time (UTC).", "format": "google-duration", "type": "string" } } }, "HeartRateZone": { "id": "HeartRateZone", "type": "object", "properties": { "heartRateZoneType": { "enumDescriptions": [ "Unspecified heart rate zone.", "The light heart rate zone.", "The moderate heart rate zone.", "The vigorous heart rate zone.", "The peak heart rate zone." ], "description": "Required. The heart rate zone type.", "type": "string", "enum": [ "HEART_RATE_ZONE_TYPE_UNSPECIFIED", "LIGHT", "MODERATE", "VIGOROUS", "PEAK" ] }, "maxBeatsPerMinute": { "description": "Required. Maximum heart rate for this zone in beats per minute.", "type": "string", "format": "int64" }, "minBeatsPerMinute": { "description": "Required. Minimum heart rate for this zone in beats per minute.", "format": "int64", "type": "string" } }, "description": "The heart rate zone." }, "HeartBeat": { "type": "object", "description": "A single heart beat measurement.", "id": "HeartBeat", "properties": { "physicalTime": { "type": "string", "description": "Required. The time of the heart beat measurement.", "format": "google-datetime" }, "beatsPerMinute": { "format": "int32", "description": "Required. The beats-per-minute value extrapolated from the time before the following heart beat. This is calculated as 60000 / rr, where rr is the gap between heart beats in milliseconds (IBI - Interbeat Interval).", "type": "integer" }, "civilTime": { "$ref": "CivilDateTime", "description": "Output only. The civil time in the timezone the subject is in at the time of the observation.", "readOnly": true }, "utcOffset": { "format": "google-duration", "type": "string", "description": "Required. The UTC offset of the user's timezone when the heart beat measurement occurred." } } }, "Moods": { "description": "Moods record.", "properties": { "moods": { "items": { "enum": [ "MOOD_UNSPECIFIED", "AMAZED", "AMUSED", "ANGRY", "ANNOYED", "ANXIOUS", "HAPPY", "CONTENT", "SAD", "WORRIED", "FRUSTRATED", "EXCITED", "CALM", "STRESSED", "ASHAMED", "BRAVE", "CONFIDENT", "DISAPPOINTED", "DISCOURAGED", "DISGUSTED", "DRAINED", "EMBARRASSED", "GRATEFUL", "GUILTY", "HOPEFUL", "HOPELESS", "INDIFFERENT", "IRRITATED", "JEALOUS", "JOYFUL", "LONELY", "OVERWHELMED", "PASSIONATE", "PEACEFUL", "PROUD", "RELIEVED", "SATISFIED", "SCARED", "SURPRISED", "ENERGIZED", "FATIGUED", "VERY_CALM", "VERY_STRESSED", "NEUTRAL", "AFRAID", "HURTING", "BORED", "BITTER", "ENVIOUS", "CONFUSED", "CURIOUS", "AWESTRUCK", "INSPIRED", "LONGING", "ACCOMPLISHED", "LOVING", "COMPASSIONATE" ], "type": "string", "enumDescriptions": [ "Unspecified mood.", "Amazed.", "Amused.", "Angry.", "Annoyed.", "Anxious.", "Happy.", "Content.", "Sad.", "Worried.", "Frustrated.", "Excited.", "Calm.", "Stressed.", "Ashamed.", "Brave.", "Confident.", "Disappointed.", "Discouraged.", "Disgusted.", "Drained.", "Embarrassed.", "Grateful.", "Guilty.", "Hopeful.", "Hopeless.", "Indifferent.", "Irritated.", "Jealous.", "Joyful.", "Lonely.", "Overwhelmed.", "Passionate.", "Peaceful.", "Proud.", "Relieved.", "Satisfied.", "Scared.", "Surprised.", "Energized.", "Fatigued.", "Very calm.", "Very stressed.", "Neutral.", "Afraid.", "Hurting.", "Bored.", "Bitter.", "Envious.", "Confused.", "Curious.", "Awestruck.", "Inspired.", "Longing.", "Accomplished.", "Loving.", "Compassionate." ] }, "description": "Required. The moods logged.", "type": "array" }, "sampleTime": { "description": "Required. The time at which moods were measured.", "$ref": "ObservationSampleTime" }, "valences": { "items": { "enum": [ "VALENCE_UNSPECIFIED", "UNPLEASANT", "BASELINE", "PLEASANT" ], "enumDescriptions": [ "Unspecified valence.", "Unpleasant.", "Baseline.", "Pleasant." ], "type": "string" }, "description": "Optional. The valences.", "type": "array" } }, "id": "Moods", "type": "object" }, "VolumeQuantity": { "properties": { "milliliters": { "format": "double", "description": "Required. Value representing the volume in milliliters.", "type": "number" }, "userProvidedUnit": { "type": "string", "enumDescriptions": [ "Unspecified volume unit.", "Cup (imperial)", "Cup (US)", "Fluid ounce (imperial)", "Fluid ounce (US)", "Liter", "Milliliter", "Pint (imperial)", "Pint (US)" ], "enum": [ "VOLUME_UNIT_UNSPECIFIED", "CUP_IMPERIAL", "CUP_US", "FLUID_OUNCE_IMPERIAL", "FLUID_OUNCE_US", "LITER", "MILLILITER", "PINT_IMPERIAL", "PINT_US" ], "description": "Optional. Value representing the user provided unit, used only for user-facing input and display purposes. In the API format, all volume quantities are converted to milliliters." } }, "id": "VolumeQuantity", "type": "object", "description": "Represents the volume quantity." }, "Status": { "id": "Status", "type": "object", "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "properties": { "message": { "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", "type": "string" }, "code": { "description": "The status code, which should be an enum value of google.rpc.Code.", "format": "int32", "type": "integer" }, "details": { "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", "items": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "type": "object" }, "type": "array" } } }, "HeartRateMetadata": { "properties": { "sensorLocation": { "enum": [ "SENSOR_LOCATION_UNSPECIFIED", "CHEST", "WRIST", "FINGER", "HAND", "EAR_LOBE", "FOOT" ], "description": "Optional. Indicates the location of the sensor that measured the heart rate.", "enumDescriptions": [ "The default value when no data is available.", "Chest sensor.", "Wrist sensor.", "Finger sensor.", "Hand sensor.", "Ear lobe sensor.", "Foot sensor." ], "type": "string" }, "motionContext": { "type": "string", "enumDescriptions": [ "The default value when no data is available.", "The user is active.", "The user is inactive." ], "enum": [ "MOTION_CONTEXT_UNSPECIFIED", "ACTIVE", "SEDENTARY" ], "description": "Optional. Indicates the user’s level of activity when the heart rate sample was measured" } }, "type": "object", "description": "Heart rate metadata.", "id": "HeartRateMetadata" }, "SleepMetadata": { "properties": { "stagesStatus": { "enumDescriptions": [ "Output only. Sleep stages status is unspecified.", "Output only. Sleep stages cannot be computed due to low RR coverage.", "Output only. Sleep stages cannot be computed due to the large middle gap (2h).", "Output only. Sleep stages cannot be computed due to the large start gap (1h).", "Output only. Sleep stages cannot be computed due to the large end gap (1h).", "Output only. Sleep stages cannot be computed because the sleep log is a nap (has \u003c 3h duration).", "Output only. Sleep stages cannot be computed because input data is not available (PPGV2, wake magnitude, etc).", "Output only. Sleep stages cannot be computed due to server timeout.", "Output only. Sleep stages successfully computed.", "Output only. Sleep stages cannot be computed due to server internal error." ], "description": "Output only. Sleep stages algorithm processing status.", "enum": [ "STAGES_STATE_UNSPECIFIED", "REJECTED_COVERAGE", "REJECTED_MAX_GAP", "REJECTED_START_GAP", "REJECTED_END_GAP", "REJECTED_NAP", "REJECTED_SERVER", "TIMEOUT", "SUCCEEDED", "PROCESSING_INTERNAL_ERROR" ], "readOnly": true, "type": "string" }, "externalId": { "description": "Optional. Sleep identifier relevant in the context of the data source.", "type": "string" }, "mainSleep": { "description": "Output only. `main_sleep`: the longest sleep session with stages within one day. If no sleep session has stages, then the longest sleep is the `main_sleep`. If there are multiple days of sleep in the response, there is one `main_sleep` per day.", "readOnly": true, "type": "boolean" }, "nap": { "type": "boolean", "description": "Output only. Naps are sleeps without stages and relatively short durations.", "readOnly": true }, "manuallyEdited": { "type": "boolean", "readOnly": true, "description": "Output only. Some sleeps autodetected by algorithms can be manually edited by users." }, "processed": { "description": "Output only. Sleep and sleep stages algorithms finished processing. A `true` value indicates whether all data processing for the session is complete. A `false` value means sleep period is detected but sleep stages is still processing.", "type": "boolean", "readOnly": true } }, "description": "Additional information about how the sleep was processed.", "type": "object", "id": "SleepMetadata" }, "RespiratoryRateSleepSummaryStatistics": { "id": "RespiratoryRateSleepSummaryStatistics", "type": "object", "properties": { "signalToNoise": { "description": "Optional. How trustworthy the data is for the computation.", "type": "number", "format": "double" }, "standardDeviation": { "format": "double", "description": "Optional. Standard deviation of the respiratory rate during sleep.", "type": "number" }, "breathsPerMinute": { "description": "Required. Average breaths per minute.", "format": "double", "type": "number" } }, "description": "Respiratory rate statistics for a given sleep stage." }, "GoogleDevicesandservicesHealthV4betaWebhookNotificationCloudLog": { "type": "object", "properties": { "httpResponse": { "description": "Required. Represents the HTTP response. This message includes the status code, reason phrase, headers, and body.", "$ref": "HttpResponse" } }, "description": "Log message for a webhook notification sent by the Google Health API to a subscriber's endpoint. Includes the HTTP response received from the endpoint.", "id": "GoogleDevicesandservicesHealthV4betaWebhookNotificationCloudLog" }, "FoodMeasurementUnit": { "id": "FoodMeasurementUnit", "description": "Represents a food measurement unit.", "type": "object", "properties": { "displayName": { "description": "Required. The display name of the food measurement unit (e.g., \"gram\", \"piece\").", "type": "string" }, "pluralDisplayName": { "description": "Optional. The plural display name of the food measurement unit (e.g., \"grams\", \"pieces\").", "type": "string" } } }, "BasalEnergyBurned": { "properties": { "interval": { "$ref": "ObservationTimeInterval", "description": "Required. Observed interval." }, "kcal": { "format": "double", "type": "number", "description": "Required. Number of calories burned due to basal metabolic rate in kilocalories over the observed interval." } }, "id": "BasalEnergyBurned", "type": "object", "description": "Number of calories burned due to basal metabolic rate (BMR) over a period of time." }, "DailyRollUpDataPointsResponse": { "type": "object", "description": "Response containing the list of rolled up data points.", "properties": { "rollupDataPoints": { "type": "array", "description": "Values for each aggregation time window.", "items": { "$ref": "DailyRollupDataPoint" } } }, "id": "DailyRollUpDataPointsResponse" }, "Distance": { "description": "Distance traveled over an interval of time.", "type": "object", "properties": { "interval": { "description": "Required. Observed interval.", "$ref": "ObservationTimeInterval" }, "millimeters": { "description": "Required. Distance in millimeters over the observed interval.", "format": "int64", "type": "string" } }, "id": "Distance" }, "Serving": { "description": "Represents different properties and information about the serving of a specific food.", "properties": { "amount": { "format": "double", "type": "number", "description": "Optional. The number of servings." }, "foodMeasurementUnit": { "type": "string", "description": "Required. Food measurement unit" }, "foodMeasurementUnitDisplayName": { "readOnly": true, "type": "string", "description": "Output only. Legacy measurement unit for serving size in singular form (e.g. \"piece\", \"gram\")." } }, "type": "object", "id": "Serving" }, "WeightRollupValue": { "id": "WeightRollupValue", "properties": { "weightGramsAvg": { "description": "Average weight in grams.", "type": "number", "format": "double" } }, "description": "Represents the result of the rollup of the weight data type.", "type": "object" }, "TimeInHeartRateZoneRollupValue": { "type": "object", "properties": { "timeInHeartRateZones": { "items": { "$ref": "TimeInHeartRateZoneValue" }, "description": "List of time spent in each heart rate zone.", "type": "array" } }, "id": "TimeInHeartRateZoneRollupValue", "description": "Represents the result of the rollup of the time in heart rate zone data type." }, "Settings": { "type": "object", "id": "Settings", "properties": { "autoStrideEnabled": { "description": "Optional. True if the user's stride length is determined automatically. Updates to this field are currently not supported.", "type": "boolean" }, "swimUnit": { "enumDescriptions": [ "Swim unit is not specified.", "Swim unit is meters.", "Swim unit is yards." ], "type": "string", "description": "Optional. The measurement unit defined in the user's account settings.", "enum": [ "SWIM_UNIT_UNSPECIFIED", "SWIM_UNIT_METERS", "SWIM_UNIT_YARDS" ] }, "utcOffset": { "type": "string", "description": "Optional. The user's timezone offset relative to UTC. Updates to this field are currently not supported.", "format": "google-duration" }, "waterUnit": { "enum": [ "WATER_UNIT_UNSPECIFIED", "WATER_UNIT_ML", "WATER_UNIT_FL_OZ", "WATER_UNIT_CUP" ], "enumDescriptions": [ "Water unit is not specified.", "Water unit is milliliters.", "Water unit is fluid ounces.", "Water unit is cups." ], "description": "Optional. The measurement unit defined in the user's account settings.", "type": "string" }, "languageLocale": { "description": "Optional. The locale defined in the user's account settings. Updates to this field are currently not supported.", "type": "string" }, "heightUnit": { "type": "string", "description": "Optional. The measurement unit defined in the user's account settings.", "enumDescriptions": [ "Height unit is not specified.", "Height unit is inches.", "Height unit is cm." ], "enum": [ "HEIGHT_UNIT_UNSPECIFIED", "HEIGHT_UNIT_INCHES", "HEIGHT_UNIT_CENTIMETERS" ] }, "timeZone": { "description": "Optional. The timezone defined in the user's account settings. This follows the IANA [Time Zone Database](https://www.iana.org/time-zones). Updates to this field are currently not supported.", "type": "string" }, "temperatureUnit": { "enum": [ "TEMPERATURE_UNIT_UNSPECIFIED", "TEMPERATURE_UNIT_CELSIUS", "TEMPERATURE_UNIT_FAHRENHEIT" ], "description": "Optional. The measurement unit defined in the user's account settings.", "enumDescriptions": [ "Temperature unit is not specified.", "Temperature unit is Celsius.", "Temperature unit is Fahrenheit." ], "type": "string" }, "weightUnit": { "type": "string", "description": "Optional. The measurement unit defined in the user's account settings.", "enum": [ "WEIGHT_UNIT_UNSPECIFIED", "WEIGHT_UNIT_POUNDS", "WEIGHT_UNIT_STONE", "WEIGHT_UNIT_KILOGRAMS" ], "enumDescriptions": [ "Weight unit is not specified.", "Weight unit is pounds.", "Weight unit is stones.", "Weight unit is kilograms." ] }, "strideLengthWalkingType": { "enum": [ "STRIDE_LENGTH_TYPE_UNSPECIFIED", "STRIDE_LENGTH_TYPE_DEFAULT", "STRIDE_LENGTH_TYPE_MANUAL", "STRIDE_LENGTH_TYPE_AUTO" ], "type": "string", "enumDescriptions": [ "Stride length type is not specified.", "Stride length type is computed based on the user's gender and height.", "Stride length type is manually set by the user.", "Stride length type is determined automatically." ], "description": "Optional. The stride length type defined in the user's account settings for walking. Updates to this field are currently not supported." }, "name": { "type": "string", "description": "Identifier. The resource name of this Settings resource. Format: `users/{user}/settings` Example: `users/1234567890/settings` or `users/me/settings` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user." }, "foodLanguageCode": { "type": "string", "description": "Output only. The food language code derived from the user's food database. Possible values: `'en-US'`, `'en-GB'`, `'de-DE'`, `'es-ES'`, `'fr-FR'`, `'zh-CN'`, `'zh-TW'`, `'ja-JP'`, `'en-AU'`, `'en-CA'`, `'it-IT'`, `'ko-KR'`, `'es-MX'`, `'en-IN'`, `'en-SG'`, `'en-PH'`, `'en-IE'`, `'fr-CA'`. Updates to this field are currently not supported.", "readOnly": true }, "glucoseUnit": { "description": "Optional. The measurement unit defined in the user's account settings.", "enumDescriptions": [ "Glucose unit is not specified.", "Glucose unit is mg/dL.", "Glucose unit is mmol/l." ], "type": "string", "enum": [ "GLUCOSE_UNIT_UNSPECIFIED", "GLUCOSE_UNIT_MG_DL", "GLUCOSE_UNIT_MMOL_L" ] }, "distanceUnit": { "enumDescriptions": [ "Distance unit is not specified.", "Distance unit is miles.", "Distance unit is kilometers." ], "type": "string", "enum": [ "DISTANCE_UNIT_UNSPECIFIED", "DISTANCE_UNIT_MILES", "DISTANCE_UNIT_KILOMETERS" ], "description": "Optional. The measurement unit defined in the user's account settings." }, "strideLengthRunningType": { "enum": [ "STRIDE_LENGTH_TYPE_UNSPECIFIED", "STRIDE_LENGTH_TYPE_DEFAULT", "STRIDE_LENGTH_TYPE_MANUAL", "STRIDE_LENGTH_TYPE_AUTO" ], "description": "Optional. The stride length type defined in the user's account settings for running. Updates to this field are currently not supported.", "type": "string", "enumDescriptions": [ "Stride length type is not specified.", "Stride length type is computed based on the user's gender and height.", "Stride length type is manually set by the user.", "Stride length type is determined automatically." ] } }, "description": "Settings details." }, "Floors": { "properties": { "interval": { "$ref": "ObservationTimeInterval", "description": "Required. Observed interval" }, "count": { "description": "Required. Number of floors in the recorded interval", "format": "int64", "type": "string" } }, "type": "object", "description": "Gained elevation measured in floors over the time interval", "id": "Floors" }, "TimeZone": { "id": "TimeZone", "description": "Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones).", "type": "object", "properties": { "id": { "description": "IANA Time Zone Database time zone. For example \"America/New_York\".", "type": "string" }, "version": { "description": "Optional. IANA Time Zone Database version number. For example \"2019a\".", "type": "string" } } }, "BodyFatRollupValue": { "type": "object", "properties": { "bodyFatPercentageAvg": { "description": "Average body fat percentage.", "format": "double", "type": "number" } }, "description": "Represents the result of the rollup of the body fat data type.", "id": "BodyFatRollupValue" }, "SwimLengthsDataRollupValue": { "description": "Represents the result of the rollup of the swim lengths data type.", "id": "SwimLengthsDataRollupValue", "properties": { "strokeCountSum": { "format": "int64", "type": "string", "description": "Total number of swim strokes in the interval." } }, "type": "object" }, "TimeInHeartRateZone": { "properties": { "heartRateZoneType": { "enumDescriptions": [ "Unspecified heart rate zone.", "The light heart rate zone.", "The moderate heart rate zone.", "The vigorous heart rate zone.", "The peak heart rate zone." ], "enum": [ "HEART_RATE_ZONE_TYPE_UNSPECIFIED", "LIGHT", "MODERATE", "VIGOROUS", "PEAK" ], "type": "string", "description": "Required. Heart rate zone type." }, "interval": { "description": "Required. Observed interval.", "$ref": "ObservationTimeInterval" } }, "id": "TimeInHeartRateZone", "description": "Time in heart rate zone record. It's an interval spent in specific heart rate zone.", "type": "object" }, "HydrationLog": { "properties": { "amountConsumed": { "$ref": "VolumeQuantity", "description": "Required. Amount of liquid (ex. water) consumed." }, "interval": { "description": "Required. Observed interval.", "$ref": "SessionTimeInterval" } }, "type": "object", "description": "Holds information about a user logged hydration.", "id": "HydrationLog" }, "HttpBody": { "type": "object", "properties": { "extensions": { "description": "Application specific response metadata. Must be set in the first response for streaming APIs.", "items": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "type": "object" }, "type": "array" }, "contentType": { "type": "string", "description": "The HTTP Content-Type header value specifying the content type of the body." }, "data": { "format": "byte", "type": "string", "description": "The HTTP request/response body as raw binary." } }, "id": "HttpBody", "description": "Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; } service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); } Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); } Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged." }, "DailyOxygenSaturation": { "properties": { "standardDeviationPercentage": { "type": "number", "description": "Optional. Standard deviation of the daily oxygen saturation averages from the past 7-30 days.", "format": "double" }, "averagePercentage": { "type": "number", "format": "double", "description": "Required. The average value of the oxygen saturation samples during the sleep." }, "lowerBoundPercentage": { "format": "double", "description": "Required. The lower bound of the confidence interval of oxygen saturation samples during sleep.", "type": "number" }, "date": { "$ref": "Date", "description": "Required. Date (in user's timezone) of the daily oxygen saturation record." }, "upperBoundPercentage": { "format": "double", "description": "Required. The upper bound of the confidence interval of oxygen saturation samples during sleep.", "type": "number" } }, "type": "object", "id": "DailyOxygenSaturation", "description": "A daily oxygen saturation (SpO2) record. Represents the user's daily oxygen saturation summary, typically calculated during sleep." }, "AltitudeRollupValue": { "description": "Represents the result of the rollup of the user's altitude.", "id": "AltitudeRollupValue", "type": "object", "properties": { "gainMillimetersSum": { "description": "Sum of the altitude gain in millimeters.", "type": "string", "format": "int64" } } }, "MobilityMetrics": { "properties": { "avgStrideLengthMillimeters": { "description": "Optional. Stride length is a measure of the distance covered by a single stride", "type": "string", "format": "int64" }, "avgCadenceStepsPerMinute": { "description": "Optional. Cadence is a measure of the frequency of your foot strikes. Steps / min in real time during workout.", "format": "double", "type": "number" }, "avgVerticalOscillationMillimeters": { "type": "string", "format": "int64", "description": "Optional. Distance off the ground your center of mass moves with each stride while running" }, "avgVerticalRatio": { "format": "double", "description": "Optional. Vertical oscillation/stride length between [5.0, 11.0].", "type": "number" }, "avgGroundContactTimeDuration": { "format": "google-duration", "type": "string", "description": "Optional. The ground contact time for a particular stride is the amount of time for which the foot was in contact with the ground on that stride" } }, "description": "Mobility workouts specific metrics", "type": "object", "id": "MobilityMetrics" }, "StepsRollupValue": { "id": "StepsRollupValue", "properties": { "countSum": { "description": "Total number of steps in the interval.", "format": "int64", "type": "string" } }, "type": "object", "description": "Represents the result of the rollup of the steps data type." }, "ObservationSampleTime": { "id": "ObservationSampleTime", "properties": { "physicalTime": { "type": "string", "description": "Required. The time of the observation.", "format": "google-datetime" }, "civilTime": { "readOnly": true, "description": "Output only. The civil time in the timezone the subject is in at the time of the observation.", "$ref": "CivilDateTime" }, "utcOffset": { "type": "string", "description": "Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC).", "format": "google-duration" } }, "type": "object", "description": "Represents a sample time of an observed data point." }, "ActivityLevel": { "type": "object", "id": "ActivityLevel", "description": "Internal type to capture activity level during a certain time interval.", "properties": { "interval": { "description": "Required. Observed interval.", "$ref": "ObservationTimeInterval" }, "activityLevelType": { "enumDescriptions": [ "Unspecified activity level type.", "Sedentary activity level.", "Lightly active activity level.", "Moderately active activity level.", "Very active activity level." ], "description": "Required. Activity level type in the given time interval.", "enum": [ "ACTIVITY_LEVEL_TYPE_UNSPECIFIED", "SEDENTARY", "LIGHTLY_ACTIVE", "MODERATELY_ACTIVE", "VERY_ACTIVE" ], "type": "string" } } }, "ActivityLevelRollupByActivityLevelType": { "id": "ActivityLevelRollupByActivityLevelType", "properties": { "activityLevelType": { "enum": [ "ACTIVITY_LEVEL_TYPE_UNSPECIFIED", "SEDENTARY", "LIGHTLY_ACTIVE", "MODERATELY_ACTIVE", "VERY_ACTIVE" ], "type": "string", "description": "Activity level type.", "enumDescriptions": [ "Unspecified activity level type.", "Sedentary activity level.", "Lightly active activity level.", "Moderately active activity level.", "Very active activity level." ] }, "totalDuration": { "type": "string", "format": "google-duration", "description": "Total duration in the activity level type." } }, "description": "Represents the total duration in a specific activity level type.", "type": "object" }, "ListSubscribersResponse": { "properties": { "subscribers": { "type": "array", "items": { "$ref": "Subscriber" }, "description": "Subscribers from the specified project." }, "totalSize": { "format": "int32", "description": "The total number of subscribers matching the request.", "type": "integer" }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } }, "type": "object", "id": "ListSubscribersResponse", "description": "Response message for ListSubscribers." }, "DailyVO2Max": { "properties": { "vo2MaxCovariance": { "format": "double", "description": "Optional. The covariance of the VO2 max value.", "type": "number" }, "date": { "$ref": "Date", "description": "Required. The date for which the Daily VO2 max was measured." }, "cardioFitnessLevel": { "enumDescriptions": [ "Unspecified cardio fitness level.", "Poor cardio fitness level.", "Fair cardio fitness level.", "Average cardio fitness level.", "Good cardio fitness level.", "Very good cardio fitness level.", "Excellent cardio fitness level." ], "type": "string", "description": "Optional. Represents the user's cardio fitness level based on their VO2 max.", "enum": [ "CARDIO_FITNESS_LEVEL_UNSPECIFIED", "POOR", "FAIR", "AVERAGE", "GOOD", "VERY_GOOD", "EXCELLENT" ] }, "vo2Max": { "type": "number", "format": "double", "description": "Required. Daily VO2 max value measured as in ml consumed oxygen / kg of body weight / min." }, "estimated": { "description": "Optional. An estimated field is added to indicate when the confidence has decreased sufficiently to consider the value an estimation.", "type": "boolean" } }, "id": "DailyVO2Max", "description": "Contains a daily summary of the user's VO2 max (cardio fitness score), which is the maximum rate of oxygen the body can use during exercise.", "type": "object" }, "NutrientQuantity": { "properties": { "quantity": { "$ref": "WeightQuantity", "description": "Required. The quantity of the nutrient, measured in grams." }, "nutrient": { "enum": [ "NUTRIENT_UNSPECIFIED", "BIOTIN", "CAFFEINE", "CALCIUM", "CHLORIDE", "CARBOHYDRATES", "CHOLESTEROL", "CHROMIUM", "COPPER", "DIETARY_FIBER", "FOLIC_ACID", "IODINE", "IRON", "MAGNESIUM", "MANGANESE", "MOLYBDENUM", "MONOUNSATURATED_FAT", "NIACIN", "PANTOTHENIC_ACID", "PHOSPHORUS", "POLYUNSATURATED_FAT", "POTASSIUM", "PROTEIN", "RIBOFLAVIN", "SATURATED_FAT", "SELENIUM", "SODIUM", "SUGAR", "THIAMIN", "TRANS_FAT", "UNSATURATED_FAT", "VITAMIN_A", "VITAMIN_B12", "VITAMIN_B6", "VITAMIN_C", "VITAMIN_D", "VITAMIN_E", "VITAMIN_K", "ZINC", "FOLATE" ], "description": "Required. The nutrient type.", "type": "string", "enumDescriptions": [ "Unspecified nutrient.", "Value representing biotin nutrient.", "Value representing caffeine nutrient.", "Value representing calcium nutrient.", "Value representing chloride nutrient.", "Value representing carbohydrates nutrient.", "Value representing cholesterol nutrient.", "Value representing chromium nutrient.", "Value representing copper nutrient.", "Value representing dietary fiber nutrient.", "Value representing folic acid nutrient.", "Value representing iodine nutrient.", "Value representing iron nutrient.", "Value representing magnesium nutrient.", "Value representing manganese nutrient.", "Value representing molybdenum nutrient.", "Value representing monounsaturated fat nutrient.", "Value representing niacin nutrient.", "Value representing pantothenic acid nutrient.", "Value representing phosphorus nutrient.", "Value representing polyunsaturated fat nutrient.", "Value representing potassium nutrient.", "Value representing protein nutrient.", "Value representing riboflavin nutrient.", "Value representing saturated fat nutrient.", "Value representing selenium nutrient.", "Value representing sodium nutrient.", "Value representing sugar nutrient.", "Value representing thiamin nutrient.", "Value representing trans fat nutrient.", "Value representing unsaturated fat nutrient.", "Value representing vitamin A nutrient.", "Value representing vitamin B12 nutrient.", "Value representing vitamin B6 nutrient.", "Value representing vitamin C nutrient.", "Value representing vitamin D nutrient.", "Value representing vitamin E nutrient.", "Value representing vitamin K nutrient.", "Value representing zinc nutrient.", "Value representing folate nutrient." ] } }, "id": "NutrientQuantity", "type": "object", "description": "Represents the quantity of a nutrient." }, "Application": { "type": "object", "description": "Optional metadata for the application that provided this data.", "id": "Application", "properties": { "googleWebClientId": { "readOnly": true, "description": "Output only. The Google OAuth 2.0 client ID of the web application or service that recorded the data. This is the client ID used during the Google OAuth flow to obtain user credentials. This field is system-populated when the data is uploaded from Google Web API.", "type": "string" }, "webClientId": { "type": "string", "readOnly": true, "description": "Output only. The client ID of the application that recorded the data. This ID is a legacy Fitbit API client ID, which is different from a Google OAuth client ID. Example format: `ABC123`. This field is system-populated and used for tracing data from legacy Fitbit API integrations. This field is system-populated when the data is uploaded from a legacy Fitbit API integration." }, "packageName": { "type": "string", "description": "Output only. A unique identifier for the mobile application that was the source of the data. This is typically the application's package name on Android (e.g., `com.google.fitbit`) or the bundle ID on iOS. This field is informational and helps trace data origin. This field is system-populated when the data is uploaded from the Fitbit mobile application, Health Connect or Health Kit.", "readOnly": true } } }, "ReconcileDataPointsResponse": { "description": "Response containing the list of reconciled DataPoints.", "type": "object", "properties": { "nextPageToken": { "type": "string", "description": "Next page token, empty if the response is complete" }, "dataPoints": { "description": "Data points matching the query", "type": "array", "items": { "$ref": "ReconciledDataPoint" } } }, "id": "ReconcileDataPointsResponse" }, "ReconciledDataPoint": { "id": "ReconciledDataPoint", "properties": { "coreBodyTemperature": { "$ref": "CoreBodyTemperature", "description": "Data for points in the `core-body-temperature` sample data type collection." }, "altitude": { "description": "Data for points in the `altitude` interval data type collection.", "$ref": "Altitude" }, "respiratoryRateSleepSummary": { "description": "Data for points in the `respiratory-rate-sleep-summary` sample data type collection.", "$ref": "RespiratoryRateSleepSummary" }, "hydrationLog": { "description": "Data for points in the `hydration-log` session data type collection.", "$ref": "HydrationLog" }, "dailySleepTemperatureDerivations": { "description": "Data for points in the `daily-sleep-temperature-derivations` daily data type collection.", "$ref": "DailySleepTemperatureDerivations" }, "sleep": { "description": "Data for points in the `sleep` session data type collection.", "$ref": "Sleep" }, "sedentaryPeriod": { "$ref": "SedentaryPeriod", "description": "Data for points in the `sedentary-period` interval data type collection." }, "oxygenSaturation": { "$ref": "OxygenSaturation", "description": "Data for points in the `oxygen-saturation` sample data type collection." }, "activeMinutes": { "description": "Data for points in the `active-minutes` interval data type collection.", "$ref": "ActiveMinutes" }, "vo2Max": { "description": "Data for points in the `vo2-max` sample data type collection.", "$ref": "VO2Max" }, "dailyOxygenSaturation": { "description": "Data for points in the `daily-oxygen-saturation` daily data type collection.", "$ref": "DailyOxygenSaturation" }, "activityLevel": { "$ref": "ActivityLevel", "description": "Data for points in the `activity-level` daily data type collection." }, "height": { "$ref": "Height", "description": "Data for points in the `height` sample data type collection." }, "heartRateVariability": { "description": "Data for points in the `heart-rate-variability` sample data type collection.", "$ref": "HeartRateVariability" }, "basalEnergyBurned": { "description": "Data for points in the `basal-energy-burned` interval data type collection.", "$ref": "BasalEnergyBurned" }, "exercise": { "$ref": "Exercise", "description": "Data for points in the `exercise` session data type collection." }, "dataPointName": { "description": "Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens.", "type": "string" }, "dailyRespiratoryRate": { "description": "Data for points in the `daily-respiratory-rate` daily data type collection.", "$ref": "DailyRespiratoryRate" }, "dailyVo2Max": { "$ref": "DailyVO2Max", "description": "Data for points in the `daily-vo2-max` daily data type collection." }, "timeInHeartRateZone": { "description": "Data for points in the `time-in-heart-rate-zone` interval data type collection.", "$ref": "TimeInHeartRateZone" }, "dailyRestingHeartRate": { "$ref": "DailyRestingHeartRate", "description": "Data for points in the `daily-resting-heart-rate` daily data type collection." }, "steps": { "description": "Data for points in the `steps` interval data type collection.", "$ref": "Steps" }, "heartRate": { "description": "Data for points in the `heart-rate` sample data type collection.", "$ref": "HeartRate" }, "dailyHeartRateVariability": { "$ref": "DailyHeartRateVariability", "description": "Data for points in the `daily-heart-rate-variability` daily data type collection." }, "activeZoneMinutes": { "description": "Data for points in the `active-zone-minutes` interval data type collection, measured in minutes.", "$ref": "ActiveZoneMinutes" }, "activeEnergyBurned": { "$ref": "ActiveEnergyBurned", "description": "Data for points in the `active-energy-burned` interval data type collection." }, "swimLengthsData": { "description": "Data for points in the `swim-lengths-data` interval data type collection.", "$ref": "SwimLengthsData" }, "weight": { "$ref": "Weight", "description": "Data for points in the `weight` sample data type collection." }, "bodyFat": { "description": "Data for points in the `body-fat` sample data type collection.", "$ref": "BodyFat" }, "distance": { "description": "Data for points in the `distance` interval data type collection.", "$ref": "Distance" }, "floors": { "description": "Data for points in the `floors` interval data type collection.", "$ref": "Floors" }, "runVo2Max": { "description": "Data for points in the `run-vo2-max` sample data type collection.", "$ref": "RunVO2Max" }, "bloodGlucose": { "$ref": "BloodGlucose", "description": "Data for points in the `blood-glucose` sample data type collection." }, "dailyHeartRateZones": { "$ref": "DailyHeartRateZones", "description": "Data for points in the `daily-heart-rate-zones` daily data type collection." }, "nutritionLog": { "description": "Data for points in the `nutrition-log` session data type collection.", "$ref": "NutritionLog" } }, "type": "object", "description": "A reconciled computed or recorded metric." }, "ActiveMinutesRollupByActivityLevel": { "type": "object", "id": "ActiveMinutesRollupByActivityLevel", "properties": { "activityLevel": { "description": "The level of activity.", "type": "string", "enumDescriptions": [ "Activity level is unspecified.", "Light activity level.", "Moderate activity level.", "Vigorous activity level." ], "enum": [ "ACTIVITY_LEVEL_UNSPECIFIED", "LIGHT", "MODERATE", "VIGOROUS" ] }, "activeMinutesSum": { "type": "string", "format": "int64", "description": "Number of whole minutes spent in activity." } }, "description": "Active minutes by activity level." }, "Interval": { "type": "object", "description": "Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time.", "id": "Interval", "properties": { "startTime": { "type": "string", "format": "google-datetime", "description": "Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start." }, "endTime": { "type": "string", "format": "google-datetime", "description": "Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end." } } }, "Exercise": { "id": "Exercise", "properties": { "notes": { "type": "string", "description": "Optional. Standard free-form notes captured at manual logging." }, "interval": { "$ref": "SessionTimeInterval", "description": "Required. Observed exercise interval" }, "exerciseEvents": { "description": "Optional. Exercise events that happen during an exercise, such as pause & restarts.", "type": "array", "items": { "$ref": "ExerciseEvent" } }, "splitSummaries": { "type": "array", "description": "Optional. Laps or splits recorded within an exercise. Laps could be split based on distance or other criteria (duration, etc.) Laps should not be overlapping with each other.", "items": { "$ref": "SplitSummary" } }, "displayName": { "description": "Required. The localized, human-readable name of the exercise. For all exercise types other than `OTHER`, the system ignores client input and overrides this field with a generated name based on `exercise_type` (e.g., \"Walking\" for `WALKING`). If `exercise_type` is `OTHER`, this field can contain the user's custom, free-form display name.", "type": "string" }, "activeDuration": { "description": "Optional. Duration excluding pauses.", "format": "google-duration", "type": "string" }, "metricsSummary": { "description": "Required. Summary metrics for this exercise ( )", "$ref": "MetricsSummary" }, "createTime": { "readOnly": true, "description": "Output only. Represents the timestamp of the creation of the exercise.", "type": "string", "format": "google-datetime" }, "updateTime": { "readOnly": true, "description": "Output only. This is the timestamp of the last update to the exercise.", "format": "google-datetime", "type": "string" }, "exerciseMetadata": { "description": "Optional. Additional exercise metadata.", "$ref": "ExerciseMetadata" }, "exerciseType": { "type": "string", "enum": [ "EXERCISE_TYPE_UNSPECIFIED", "AEROBIC_WORKOUT", "ARCHERY", "ASSAULT_BIKE", "BACKPACKING", "BADMINTON", "BALLET", "BALLROOM_DANCE", "BARRE_CLASS", "BASEBALL", "BASKETBALL", "BIKING", "BILLIARDS", "BODY_WEIGHT", "BOOTCAMP", "BOWLING", "BOXING", "BREAKDANCING", "CALISTHENICS", "CANOEING", "CARDIO_SCULPT", "CARDIO_WORKOUT", "CARPENTRY", "CHEERLEADING", "CIRCUIT_TRAINING", "CLEANING", "CLIMBING", "CORE_TRAINING", "CRICKET", "CROQUET", "CROSS_COUNTRY_SKI", "CROSS_TRAINING", "CROSSFIT", "CURLING", "DANCING", "DIVING", "ELECTRIC_BIKE", "ELECTRIC_SCOOTER", "ELLIPTICAL", "EQUESTRIAN_SPORTS", "EXERCISE_CLASS", "FENCING", "FIELD_HOCKEY", "FISHING", "FITNESS_GAMING", "FOILING", "FOOTBALL_AMERICAN", "FOOTBALL_AUSTRALIAN", "FREE_WEIGHTS", "FRISBEE_PLAYING_GENERAL", "FUNCTIONAL_STRENGTH_TRAINING", "GARDENING", "GOLF", "GYMNASTICS", "HANDBALL", "HAND_CYCLING", "HIIT", "HIKING", "HIP_HOP", "HOCKEY", "HOEING", "HOUSEHOLD_CHORES", "HUNTING", "ICE_SKATING", "INCLINE_RUN", "INCLINE_WALK", "INDOOR_CLIMBING", "INTERVAL_WORKOUT", "JAZZ_DANCE", "JIU_JITSU", "JUMPING_ROPE", "KARATE", "KAYAKING", "KICKBOXING", "KITESURFING", "LACROSSE", "MARTIAL_ARTS", "MEDITATE", "MODERN_DANCE", "MOTOCROSS", "MOTORCYCLE", "MOUNTAIN_BIKE", "MOWING_LAWN", "MUAY_THAI", "MULTISPORT", "MUSICAL_PERFORMANCE", "NORDIC_WALKING", "ORIENTEERING", "OTHER", "OUTDOOR_BIKE", "OUTDOOR_WORKOUT", "PADDLEBOARDING", "PADEL", "PAINTING", "PARAGLIDING", "PARKOUR", "PICKELBALL", "PILATES", "POLO", "POWERLIFTING", "POWER_WALKING", "RACKET_SPORTS", "RACQUETBALL", "RESISTANCE_BANDS", "ROCK_CLIMBING", "ROLLERBLADING", "ROLLER_SKATING", "ROWING", "ROWING_MACHINE", "RUCKING", "RUGBY", "RUNNING", "SAILING", "SCOOTERING", "SCUBA_DIVING", "SHOOTING", "SHOVELING", "SKATEBOARDING", "SKATING", "SKIING", "SKYDIVING", "SNORKELING", "SNOWBOARDING", "SNOWMOBILING", "SNOWSHOEING", "SNOW_SPORT", "SOCCER", "SOFTBALL", "SPEED_SKATING", "SPINNING", "SPORT", "SQUASH", "STAIRCLIMBER", "STATIONARY_BIKE", "STEP_TRAINING", "STRENGTH_TRAINING", "STRETCHING", "STROLLER_WALK", "SURFING", "SWIMMING", "SWIMMING_OPEN_WATER", "SWIMMING_POOL", "SYNCHRONIZED_SWIMMING", "TABATA_WORKOUT", "TABLE_TENNIS", "TAEKWONDO", "TAI_CHI", "TANGO", "TENNIS", "TRACK_AND_FIELD", "TRAIL_RUN", "TRAMPOLINE", "TREADMILL", "TREADMILL_WALK", "TRX", "ULTIMATE_FRISBEE", "UNICYCLING", "VOLLEYBALL", "VOLLEYBALL_BEACH", "WAKEBOARDING", "WALKING", "WALK_WITH_WEIGHTS", "WATER_AEROBICS", "WATER_JOGGING", "WATER_POLO", "WATER_SKIING", "WATER_SPORT", "WATER_VOLLEYBALL", "WEEDING", "WEIGHTLIFTING", "WEIGHT_MACHINES", "WEIGHTS", "WHEELCHAIR", "WINDSURFING", "WORKOUT", "WRESTLING", "YOGA", "YOGA_BIKRAM", "YOGA_HATHA", "YOGA_POWER", "YOGA_VINYASA", "ZUMBA" ], "enumDescriptions": [ "Exercise type is unspecified.", "Aerobic workout type.", "Archery type.", "Assault bike type.", "Backpacking type.", "Badminton type.", "Ballet type.", "Ballroom dance type.", "Barre class type.", "Baseball type.", "Basketball type.", "Biking type.", "Billiards type.", "Body weight type.", "Bootcamp type.", "Bowling type.", "Boxing type.", "Breakdancing type.", "Calisthenics type.", "Canoeing type.", "Cardio sculpt type.", "Cardio workout type.", "Carpentry type.", "Cheerleading type.", "Circuit training type.", "Cleaning type.", "Climbing type.", "Core training type.", "Cricket type.", "Croquet type.", "Cross country ski type.", "Cross training type.", "Crossfit type.", "Curling type.", "Dancing type.", "Diving type.", "Electric bike type.", "Electric scooter type.", "Elliptical type.", "Equestrian sports type.", "Exercise class type.", "Fencing type.", "Field hockey type.", "Fishing type.", "Fitness gaming type.", "Foiling type.", "Football american type.", "Football australian type.", "Free weights type.", "Frisbee playing general type.", "Functional strength training type.", "Gardening type.", "Golf type.", "Gymnastics type.", "Handball type.", "Hand cycling type.", "Hiit type.", "Hiking type.", "Hip hop type.", "Hockey type.", "Hoeing type.", "Household chores type.", "Hunting type.", "Ice skating type.", "Incline run type.", "Incline walk type.", "Indoor climbing type.", "Interval workout type.", "Jazz dance type.", "Jiu jitsu type.", "Jumping rope type.", "Karate type.", "Kayaking type.", "Kickboxing type.", "Kitesurfing type.", "Lacrosse type.", "Martial arts type.", "Meditate type.", "Modern dance type.", "Motocross type.", "Motorcycle type.", "Mountain bike type.", "Mowing lawn type.", "Muay thai type.", "Multisport type.", "Musical performance type.", "Nordic walking type.", "Orienteering type.", "Other type.", "Outdoor bike type.", "Outdoor workout type.", "Paddleboarding type.", "Padel type.", "Painting type.", "Paragliding type.", "Parkour type.", "Pickelball type.", "Pilates type.", "Polo type.", "Powerlifting type.", "Power walking type.", "Racket sports type.", "Racquetball type.", "Resistance bands type.", "Rock climbing type.", "Rollerblading type.", "Roller skating type.", "Rowing type.", "Rowing machine type.", "Rucking type.", "Rugby type.", "Running type.", "Sailing type.", "Scootering type.", "Scuba diving type.", "Shooting type.", "Shoveling type.", "Skateboarding type.", "Skating type.", "Skiing type.", "Skydiving type.", "Snorkeling type.", "Snowboarding type.", "Snowmobiling type.", "Snowshoeing type.", "Snow sport type.", "Soccer type.", "Softball type.", "Speed skating type.", "Spinning type.", "Sport type.", "Squash type.", "Stairclimber type.", "Stationary bike type.", "Step training type.", "Strength training type.", "Stretching type.", "Stroller walk type.", "Surfing type.", "Swimming type.", "Swimming open water type.", "Swimming pool type.", "Synchronized swimming type.", "Tabata workout type.", "Table tennis type.", "Taekwondo type.", "Tai chi type.", "Tango type.", "Tennis type.", "Track and field type.", "Trail run type.", "Trampoline type.", "Treadmill type.", "Treadmill walk type.", "Trx type.", "Ultimate frisbee type.", "Unicycling type.", "Volleyball type.", "Volleyball beach type.", "Wakeboarding type.", "Walking type.", "Walk with weights type.", "Water aerobics type.", "Water jogging type.", "Water polo type.", "Water skiing type.", "Water sport type.", "Water volleyball type.", "Weeding type.", "Weightlifting type.", "Weight machines type.", "Weights type.", "Wheelchair type.", "Windsurfing type.", "Workout type.", "Wrestling type.", "Yoga type.", "Yoga bikram type.", "Yoga hatha type.", "Yoga power type.", "Yoga vinyasa type.", "Zumba type." ], "description": "Required. The type of activity performed during an exercise." }, "splits": { "type": "array", "description": "Optional. The default split is 1 km or 1 mile. - if the movement distance is less than the default, then there are no splits - if the movement distance is greater than or equal to the default, then we have splits", "items": { "$ref": "SplitSummary" } } }, "description": "An exercise that stores information about a physical activity.", "type": "object" }, "IrnProfile": { "type": "object", "description": "Irregular Rhythm Notifications (IRN) Profile details. The Irregular Rhythm Notifications (IRN) feature checks for signs of atrial fibrillation (AFib). The IrnProfile details include information about the user's onboarding status, enrollment status, and the last update time of analyzable data for this feature.", "properties": { "updateTime": { "readOnly": true, "type": "string", "description": "Output only. The timestamp of the last piece of analyzable data synced by the user.", "format": "google-datetime" }, "onboardingStatus": { "type": "boolean", "description": "Required. Whether or not the user has onboarded onto the IRN feature." }, "name": { "description": "Identifier. The resource name of this IrnProfile resource. Format: `users/{user}/irnProfile` Example: `users/1234567890/irnProfile` or `users/me/irnProfile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user.", "type": "string" }, "enrollmentStatus": { "type": "boolean", "description": "Required. Whether or not the user is currently enrolled in having their data processed for IRN alerts." } }, "id": "IrnProfile" }, "OvulationTest": { "type": "object", "properties": { "sampleTime": { "$ref": "ObservationSampleTime", "description": "Required. The time at which ovulation test was measured." }, "result": { "type": "string", "enumDescriptions": [ "Unspecified result.", "Negative result.", "Luteinizing hormone surge.", "Estrogen surge.", "Positive result.", "Indeterminate result." ], "enum": [ "OVULATION_TEST_RESULT_UNSPECIFIED", "NEGATIVE", "LUTEINIZING_HORMONE_SURGE", "ESTROGEN_SURGE", "POSITIVE", "INDETERMINATE" ], "description": "Required. The result of the ovulation test." } }, "id": "OvulationTest", "description": "Ovulation test record." }, "HydrationLogRollupValue": { "description": "Represents the result of the rollup of the hydration log data type.", "type": "object", "id": "HydrationLogRollupValue", "properties": { "amountConsumed": { "description": "Rollup for amount consumed.", "$ref": "VolumeQuantityRollup" } } }, "CaloriesInHeartRateZoneValue": { "type": "object", "id": "CaloriesInHeartRateZoneValue", "properties": { "kcal": { "type": "number", "format": "double", "description": "The amount of kilocalories burned in the specified heart rate zone." }, "heartRateZone": { "enum": [ "HEART_RATE_ZONE_TYPE_UNSPECIFIED", "LIGHT", "MODERATE", "VIGOROUS", "PEAK" ], "enumDescriptions": [ "Unspecified heart rate zone.", "The light heart rate zone.", "The moderate heart rate zone.", "The vigorous heart rate zone.", "The peak heart rate zone." ], "description": "The heart rate zone.", "type": "string" } }, "description": "Represents the amount of kilocalories burned in a specific heart rate zone." }, "Steps": { "type": "object", "properties": { "count": { "format": "int64", "type": "string", "description": "Required. Number of steps in the recorded interval." }, "interval": { "description": "Required. Observed interval.", "$ref": "ObservationTimeInterval" } }, "description": "Step count over the time interval.", "id": "Steps" }, "ActivityLevelRollupValue": { "properties": { "activityLevelRollupsByActivityLevelType": { "description": "List of total durations in each activity level type.", "items": { "$ref": "ActivityLevelRollupByActivityLevelType" }, "type": "array" } }, "type": "object", "description": "Represents the result of the rollup of the activity level data type.", "id": "ActivityLevelRollupValue" }, "Subscriber": { "id": "Subscriber", "description": "-- Resource Messages -- A subscriber receives notifications from Google Health API.", "properties": { "updateTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. The time at which the subscriber was last updated." }, "endpointAuthorization": { "description": "Required. Authorization mechanism for a subscriber endpoint. This is required to ensure the endpoint can be verified.", "$ref": "EndpointAuthorization" }, "createTime": { "description": "Output only. The time at which the subscriber was created.", "format": "google-datetime", "type": "string", "readOnly": true }, "subscriberConfigs": { "type": "array", "description": "Optional. Configuration for the subscriber.", "items": { "$ref": "SubscriberConfig" } }, "endpointUri": { "description": "Required. The full HTTPS URI where update notifications will be sent. The URI must be a valid URL and use HTTPS as the scheme. This endpoint will be verified during CreateSubscriber and UpdateSubscriber calls. See RPC documentation for verification details.", "type": "string" }, "state": { "description": "Output only. The state of the subscriber.", "enumDescriptions": [ "Represents an unspecified subscriber state.", "Represents an unverified subscriber. This is the initial state of the subscriber when it is created. The backend will verify the subscriber's endpoint_uri.", "Represents an active subscriber. The endpoint has been verified.", "Represents an inactive subscriber." ], "enum": [ "STATE_UNSPECIFIED", "UNVERIFIED", "ACTIVE", "INACTIVE" ], "readOnly": true, "type": "string" }, "name": { "type": "string", "description": "Identifier. The resource name of the Subscriber. Format: projects/{project}/subscribers/{subscriber} The {project} ID is a Google Cloud Project ID or Project Number. The {subscriber} ID is user-settable (4-36 characters, matching /[a-z]([a-z0-9-]{2,34}[a-z0-9])/) if provided during creation, or system-generated otherwise (e.g., a UUID). Example (User-settable subscriber ID): projects/my-project/subscribers/my-sub-123 Example (System-generated subscriber ID): projects/my-project/subscribers/a1b2c3d4-e5f6-7890-1234-567890abcdef" } }, "type": "object" }, "ActiveZoneMinutes": { "type": "object", "properties": { "interval": { "description": "Required. Observed interval.", "$ref": "ObservationTimeInterval" }, "activeZoneMinutes": { "format": "int64", "type": "string", "description": "Required. Number of Active Zone Minutes earned in the given time interval. Note: active_zone_minutes equals to 1 for low intensity (fat burn) zones or 2 for high intensity zones (cardio, peak)." }, "heartRateZone": { "enum": [ "HEART_RATE_ZONE_UNSPECIFIED", "FAT_BURN", "CARDIO", "PEAK" ], "enumDescriptions": [ "Unspecified heart rate zone.", "The fat burn heart rate zone.", "The cardio heart rate zone.", "The peak heart rate zone." ], "type": "string", "description": "Required. Heart rate zone in which the active zone minutes have been earned, in the given time interval." } }, "id": "ActiveZoneMinutes", "description": "Record of active zone minutes in a given time interval." }, "BodyFat": { "id": "BodyFat", "description": "Body fat measurement.", "properties": { "sampleTime": { "description": "Required. The time at which body fat was measured.", "$ref": "ObservationSampleTime" }, "percentage": { "format": "double", "type": "number", "description": "Required. Body fat percentage, in range [0, 100]." } }, "type": "object" }, "SedentaryPeriod": { "id": "SedentaryPeriod", "properties": { "interval": { "$ref": "ObservationTimeInterval", "description": "Required. Observed interval." } }, "type": "object", "description": "SedentaryPeriod SedentaryPeriod data represents the periods of time that the user was sedentary (i.e. not moving while wearing the device)." }, "Date": { "type": "object", "properties": { "year": { "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.", "format": "int32", "type": "integer" }, "day": { "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.", "format": "int32", "type": "integer" }, "month": { "type": "integer", "format": "int32", "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day." } }, "description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp", "id": "Date" }, "ActiveMinutes": { "type": "object", "id": "ActiveMinutes", "description": "Record of active minutes in a given time interval.", "properties": { "interval": { "description": "Required. Observed interval.", "$ref": "ObservationTimeInterval" }, "activeMinutesByActivityLevel": { "items": { "$ref": "ActiveMinutesByActivityLevel" }, "description": "Required. Active minutes by activity level. At most one record per activity level is allowed.", "type": "array" } } }, "TimeInHeartRateZones": { "id": "TimeInHeartRateZones", "type": "object", "properties": { "vigorousTime": { "format": "google-duration", "type": "string", "description": "Optional. Time spent in vigorous heart rate zone." }, "moderateTime": { "format": "google-duration", "type": "string", "description": "Optional. Time spent in moderate heart rate zone." }, "lightTime": { "format": "google-duration", "type": "string", "description": "Optional. Time spent in light heart rate zone." }, "peakTime": { "description": "Optional. Time spent in peak heart rate zone.", "type": "string", "format": "google-duration" } }, "description": "Time spent in each heart rate zone." }, "SleepSummary": { "id": "SleepSummary", "description": " Sleep summary: metrics and stages summary.", "type": "object", "properties": { "minutesAfterWakeUp": { "readOnly": true, "format": "int64", "description": "Output only. Minutes after wake up calculated by restlessness algorithm.", "type": "string" }, "minutesAwake": { "format": "int64", "readOnly": true, "type": "string", "description": "Output only. Total number of minutes awake. It is a sum of all AWAKE stages." }, "stagesSummary": { "description": "Output only. List of summaries (total duration and segment count) per each sleep stage type.", "items": { "$ref": "StageSummary" }, "type": "array", "readOnly": true }, "minutesToFallAsleep": { "description": "Output only. Minutes to fall asleep calculated by restlessness algorithm.", "readOnly": true, "format": "int64", "type": "string" }, "minutesInSleepPeriod": { "format": "int64", "type": "string", "readOnly": true, "description": "Output only. Delta between wake time and bedtime. It is the sum of all stages." }, "minutesAsleep": { "readOnly": true, "format": "int64", "description": "Output only. Total number of minutes asleep. For classic sleep it is the sum of ASLEEP stages (excluding AWAKE and RESTLESS). For \"stages\" sleep it is the sum of LIGHT, REM and DEEP stages (excluding AWAKE).", "type": "string" } } }, "NutritionLog": { "type": "object", "description": "Holds information about food logged by a user. There are two ways of creating a nutrition log based on the food type: 1. Identified food: Using the food field, which is a reference to a Food resource. In this case fields `nutrients`, `energy`, `energy_from_fat`, `total_carbohydrate`, `total_fat`, `food_display_name` will be populated based on the referenced food. 2. Anonymous food: Using the `food_display_name` field and setting the `nutrients`, `energy`, `energy_from_fat`, `total_carbohydrate`, `total_fat` fields manually. The identified food is preferred over the anonymous food. Nutrition logs created from anonymous food are not editable.", "id": "NutritionLog", "properties": { "serving": { "description": "Optional. The serving information for the logged food.", "$ref": "Serving" }, "totalFat": { "$ref": "WeightQuantity", "description": "Optional. The total fat content, measured in grams." }, "energy": { "description": "Optional. The total energy of the food, measured in kilocalories (`kcal`).", "$ref": "EnergyQuantity" }, "food": { "description": "Optional. The resource name of the Food item. Required when creating a nutrition log from an identified food. For anonymous food logs, use the `food_display_name` field instead.", "type": "string" }, "mealType": { "enum": [ "MEAL_TYPE_UNSPECIFIED", "BEFORE_BREAKFAST", "BREAKFAST", "BEFORE_LUNCH", "LUNCH", "BEFORE_DINNER", "DINNER", "AFTER_DINNER", "SNACK", "ANYTIME" ], "description": "Optional. The meal category. One of `BREAKFAST`, `LUNCH`, `DINNER`, or `SNACK`.", "enumDescriptions": [ "Unspecified meal type.", "Value representing a meal before breakfast.", "Value representing a breakfast.", "Value representing a morning snack.", "Value representing a lunch.", "Value representing an afternoon snack.", "Value representing dinner.", "Value representing an evening snack.", "Value representing any meal outside of the usual three meals per day.", "Value representing any time (legacy NA)." ], "type": "string" }, "nutrients": { "description": "Optional. An array of individual nutrient values for the nutrition log.", "type": "array", "items": { "$ref": "NutrientQuantity" } }, "foodDisplayName": { "description": "The display name of the food. For identified food logs, this is populated automatically from the referenced food.", "type": "string" }, "energyFromFat": { "$ref": "EnergyQuantity", "description": "Optional. The energy from fat, measured in kilocalories (`kcal`)." }, "totalCarbohydrate": { "description": "Optional. The total carbohydrate content, measured in grams.", "$ref": "WeightQuantity" }, "interval": { "$ref": "SessionTimeInterval", "description": "Required. The time window when the food was logged." } } }, "VolumeQuantityRollup": { "description": "Rollup for volume quantity.", "properties": { "millilitersSum": { "format": "double", "description": "Required. The sum of volume in milliliters.", "type": "number" }, "userProvidedUnitLast": { "description": "Optional. The user provided unit on the last element.", "enum": [ "VOLUME_UNIT_UNSPECIFIED", "CUP_IMPERIAL", "CUP_US", "FLUID_OUNCE_IMPERIAL", "FLUID_OUNCE_US", "LITER", "MILLILITER", "PINT_IMPERIAL", "PINT_US" ], "enumDescriptions": [ "Unspecified volume unit.", "Cup (imperial)", "Cup (US)", "Fluid ounce (imperial)", "Fluid ounce (US)", "Liter", "Milliliter", "Pint (imperial)", "Pint (US)" ], "type": "string" } }, "id": "VolumeQuantityRollup", "type": "object" }, "HeartRateVariability": { "description": "Captures user's heart rate variability (HRV) as measured by the root mean square of successive differences (RMSSD) between normal heartbeats or by standard deviation of the inter-beat intervals (SDNN).", "type": "object", "id": "HeartRateVariability", "properties": { "metadata": { "$ref": "HeartRateVariabilityMetadata", "description": "Optional. Metadata used in 1P surfaces." }, "sampleTime": { "description": "Required. The time of the heart rate variability measurement.", "$ref": "ObservationSampleTime" }, "rootMeanSquareOfSuccessiveDifferencesMilliseconds": { "description": "Optional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health.", "type": "number", "format": "double" }, "standardDeviationMilliseconds": { "description": "Optional. The standard deviation of the heart rate variability measurement.", "format": "double", "type": "number" } } }, "EnergyQuantity": { "type": "object", "id": "EnergyQuantity", "properties": { "kcal": { "type": "number", "description": "Required. The energy value in kilocalories.", "format": "double" }, "userProvidedUnit": { "enumDescriptions": [ "Unspecified energy unit.", "Value representing joule.", "Value representing kilojoule.", "Value representing kilocalorie.", "Value representing small calorie.", "Value representing calorie." ], "enum": [ "ENERGY_UNIT_UNSPECIFIED", "JOULE", "KILOJOULE", "KILOCALORIE", "SMALL_CALORIE", "CALORIE" ], "description": "Optional. Value representing the user provided unit.", "type": "string" } }, "description": "Represents the energy quantity." }, "ObservationTimeInterval": { "description": "Represents a time interval of an observed data point.", "type": "object", "properties": { "civilEndTime": { "$ref": "CivilDateTime", "readOnly": true, "description": "Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval" }, "endUtcOffset": { "description": "Required. The offset of the user's local time at the end of the observation relative to the Coordinated Universal Time (UTC).", "format": "google-duration", "type": "string" }, "endTime": { "description": "Required. Observed interval end time.", "format": "google-datetime", "type": "string" }, "startTime": { "format": "google-datetime", "description": "Required. Observed interval start time.", "type": "string" }, "startUtcOffset": { "description": "Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC).", "format": "google-duration", "type": "string" }, "civilStartTime": { "description": "Output only. Observed interval start time in civil time in the timezone the subject is in at the start of the observed interval", "$ref": "CivilDateTime", "readOnly": true } }, "id": "ObservationTimeInterval" }, "CaloriesInHeartRateZoneRollupValue": { "type": "object", "description": "Represents the result of the rollup of the calories in heart rate zone data type.", "id": "CaloriesInHeartRateZoneRollupValue", "properties": { "caloriesInHeartRateZones": { "description": "List of calories burned in each heart rate zone.", "items": { "$ref": "CaloriesInHeartRateZoneValue" }, "type": "array" } } }, "RunVO2Max": { "type": "object", "id": "RunVO2Max", "properties": { "runVo2Max": { "description": "Required. Run VO2 max value in ml/kg/min.", "type": "number", "format": "double" }, "sampleTime": { "$ref": "ObservationSampleTime", "description": "Required. The time at which the metric was measured." } }, "description": "VO2 max value calculated based on the user's running activity. Value stored in ml/kg/min." }, "StageSummary": { "id": "StageSummary", "type": "object", "properties": { "type": { "description": "Output only. Sleep stage type: AWAKE, DEEP, REM, LIGHT etc.", "enumDescriptions": [ "The default unset value.", "Sleep stage AWAKE.", "Sleep stage LIGHT.", "Sleep stage DEEP.", "Sleep stage REM.", "Sleep stage ASLEEP.", "Sleep stage RESTLESS." ], "enum": [ "SLEEP_STAGE_TYPE_UNSPECIFIED", "AWAKE", "LIGHT", "DEEP", "REM", "ASLEEP", "RESTLESS" ], "type": "string", "readOnly": true }, "count": { "format": "int64", "description": "Output only. Number of sleep stages segments.", "type": "string", "readOnly": true }, "minutes": { "format": "int64", "readOnly": true, "type": "string", "description": "Output only. Total duration in minutes of a sleep stage." } }, "description": "Total duration and segment count for a stage." }, "CreateSubscriptionPayload": { "properties": { "user": { "description": "Required. Immutable. The resource name of the user for whom this subscription is active. Format: `users/{user}` where `{user}` is the public `healthUserId` as returned by the `GetIdentity` action in the profile PAPI (see `google.devicesandservices.health.v4main.HealthProfileService.GetIdentity`).", "type": "string" }, "dataTypes": { "type": "array", "items": { "type": "string" }, "description": "Optional. Data types subscribed to." } }, "id": "CreateSubscriptionPayload", "type": "object", "description": "Payload for creating a subscription." }, "Device": { "properties": { "manufacturer": { "type": "string", "description": "Optional. An optional manufacturer of the device." }, "formFactor": { "enumDescriptions": [ "The form factor is unspecified.", "The device is a fitness band.", "The device is a watch.", "The device is a phone.", "The device is a ring.", "The device is a chest strap.", "The device is a scale.", "The device is a tablet.", "The device is a head mounted device.", "The device is a smart display." ], "enum": [ "FORM_FACTOR_UNSPECIFIED", "FITNESS_BAND", "WATCH", "PHONE", "RING", "CHEST_STRAP", "SCALE", "TABLET", "HEAD_MOUNTED", "SMART_DISPLAY" ], "description": "Optional. Captures the form factor of the device.", "type": "string" }, "displayName": { "description": "Optional. An optional name for the device.", "type": "string" } }, "id": "Device", "description": "Captures metadata about the device that recorded the measurement.", "type": "object" }, "TimeInHeartRateZoneValue": { "id": "TimeInHeartRateZoneValue", "properties": { "heartRateZone": { "enum": [ "HEART_RATE_ZONE_TYPE_UNSPECIFIED", "LIGHT", "MODERATE", "VIGOROUS", "PEAK" ], "enumDescriptions": [ "Unspecified heart rate zone.", "The light heart rate zone.", "The moderate heart rate zone.", "The vigorous heart rate zone.", "The peak heart rate zone." ], "description": "The heart rate zone.", "type": "string" }, "duration": { "description": "The total time spent in the specified heart rate zone.", "format": "google-duration", "type": "string" } }, "description": "Represents the total time spent in a specific heart rate zone.", "type": "object" }, "DailyRestingHeartRateMetadata": { "type": "object", "properties": { "calculationMethod": { "enum": [ "CALCULATION_METHOD_UNSPECIFIED", "WITH_SLEEP", "ONLY_WITH_AWAKE_DATA" ], "enumDescriptions": [ "The calculation method is unspecified.", "The resting heart rate is calculated using the sleep data.", "The resting heart rate is calculated using only awake data." ], "description": "Required. The method used to calculate the resting heart rate.", "type": "string" } }, "id": "DailyRestingHeartRateMetadata", "description": "Metadata for the daily resting heart rate." }, "GoogleDevicesandservicesHealthV4betaUser": { "properties": { "name": { "description": "Identifier. The resource name of the user. The `{user}` ID is a system-generated identifier, as described in Identity.health_user_id. Format: `users/{user}`", "type": "string" } }, "description": "Represents a user in the Google Health API. It matches the parent resource of collections owned by the user. Clients currently do not need to interact with this resource directly.", "id": "GoogleDevicesandservicesHealthV4betaUser", "type": "object" }, "CivilTimeInterval": { "type": "object", "properties": { "end": { "description": "Required. The exclusive end of the range.", "$ref": "CivilDateTime" }, "start": { "description": "Required. The inclusive start of the range.", "$ref": "CivilDateTime" } }, "id": "CivilTimeInterval", "description": "Counterpart of google.type.Interval, but using CivilDateTime." }, "RollupDataPoint": { "properties": { "coreBodyTemperature": { "$ref": "CoreBodyTemperatureRollupValue", "description": "Returned by default when rolling up data points from the `core-body-temperature` data type, or when requested explicitly using the `core-body-temperature` rollup type identifier." }, "distance": { "description": "Returned by default when rolling up data points from the `distance` data type, or when requested explicitly using the `distance` rollup type identifier.", "$ref": "DistanceRollupValue" }, "hydrationLog": { "$ref": "HydrationLogRollupValue", "description": "Returned by default when rolling up data points from the `hydration-log` data type, or when requested explicitly using the `hydration-log` rollup type identifier." }, "runVo2Max": { "description": "Returned by default when rolling up data points from the `run-vo2-max` data type, or when requested explicitly using the `run-vo2-max` rollup type identifier.", "$ref": "RunVO2MaxRollupValue" }, "timeInHeartRateZone": { "$ref": "TimeInHeartRateZoneRollupValue", "description": "Returned by default when rolling up data points from the `time-in-heart-rate-zone` data type, or when requested explicitly using the `time-in-heart-rate-zone` rollup type identifier." }, "sedentaryPeriod": { "description": "Returned by default when rolling up data points from the `sedentary-period` data type, or when requested explicitly using the `sedentary-period` rollup type identifier.", "$ref": "SedentaryPeriodRollupValue" }, "endTime": { "type": "string", "format": "google-datetime", "description": "End time of the window this value aggregates over" }, "caloriesInHeartRateZone": { "description": "Returned by default when rolling up data points from the `calories-in-heart-rate-zone` data type, or when requested explicitly using the `calories-in-heart-rate-zone` rollup type identifier.", "$ref": "CaloriesInHeartRateZoneRollupValue" }, "activeMinutes": { "$ref": "ActiveMinutesRollupValue", "description": "Returned by default when rolling up data points from the `active-minutes` data type, or when requested explicitly using the `active-minutes` rollup type identifier." }, "activeZoneMinutes": { "$ref": "ActiveZoneMinutesRollupValue", "description": "Returned by default when rolling up data points from the `active-zone-minutes` data type, or when requested explicitly using the `active-zone-minutes` rollup type identifier." }, "totalCalories": { "description": "Returned by default when rolling up data points from the `total-calories` data type, or when requested explicitly using the `total-calories` rollup type identifier.", "$ref": "TotalCaloriesRollupValue" }, "steps": { "description": "Returned by default when rolling up data points from the `steps` data type, or when requested explicitly using the `steps` rollup type identifier.", "$ref": "StepsRollupValue" }, "startTime": { "format": "google-datetime", "description": "Start time of the window this value aggregates over", "type": "string" }, "floors": { "$ref": "FloorsRollupValue", "description": "Returned by default when rolling up data points from the `floors` data type, or when requested explicitly using the `floors` rollup type identifier." }, "altitude": { "$ref": "AltitudeRollupValue", "description": "Returned by default when rolling up data points from the `altitude` data type, or when requested explicitly using the `altitude` rollup type identifier." }, "bodyFat": { "description": "Returned by default when rolling up data points from the `body-fat` data type, or when requested explicitly using the `body-fat` rollup type identifier.", "$ref": "BodyFatRollupValue" }, "heartRate": { "$ref": "HeartRateRollupValue", "description": "Returned by default when rolling up data points from the `heart-rate` data type, or when requested explicitly using the `heart-rate` rollup type identifier." }, "weight": { "$ref": "WeightRollupValue", "description": "Returned by default when rolling up data points from the `weight` data type, or when requested explicitly using the `weight` rollup type identifier." }, "activeEnergyBurned": { "description": "Returned by default when rolling up data points from the `active-energy-burned` data type.", "$ref": "ActiveEnergyBurnedRollupValue" }, "activityLevel": { "description": "Returned by default when rolling up data points from the `activity-level` data type, or when requested explicitly using the `activity-level` rollup type identifier.", "$ref": "ActivityLevelRollupValue" }, "bloodGlucose": { "$ref": "BloodGlucoseRollupValue", "description": "Returned by default when rolling up data points from the `blood-glucose` data type." }, "nutritionLog": { "description": "Returned by default when rolling up data points from the `nutrition-log` data type, or when requested explicitly using the `nutrition-log` rollup type identifier.", "$ref": "NutritionLogRollupValue" }, "swimLengthsData": { "$ref": "SwimLengthsDataRollupValue", "description": "Returned by default when rolling up data points from the `swim-lengths-data` data type, or when requested explicitly using the `swim-lengths-data` rollup type identifier." } }, "type": "object", "id": "RollupDataPoint", "description": "Value of a rollup for a single physical time interval (aggregation window) of reconciled data points from all data sources, excluding those data points that are identified as recorded by wearables in intervals when they were not actually worn." }, "DailyRestingHeartRate": { "type": "object", "description": "Measures the daily resting heart rate for a user, calculated using the all day heart rate measurements.", "properties": { "dailyRestingHeartRateMetadata": { "description": "Optional. Metadata for the daily resting heart rate.", "$ref": "DailyRestingHeartRateMetadata" }, "beatsPerMinute": { "description": "Required. The resting heart rate value in beats per minute.", "type": "string", "format": "int64" }, "date": { "description": "Required. Date (in the user's timezone) of the resting heart rate measurement.", "$ref": "Date" } }, "id": "DailyRestingHeartRate" }, "Sleep": { "type": "object", "description": "A sleep session possibly including stages.", "properties": { "updateTime": { "description": "Output only. Last update time of this sleep observation.", "readOnly": true, "format": "google-datetime", "type": "string" }, "createTime": { "type": "string", "description": "Output only. Creation time of this sleep observation.", "format": "google-datetime", "readOnly": true }, "interval": { "description": "Required. Observed sleep interval.", "$ref": "SessionTimeInterval" }, "shortAwakenings": { "items": { "$ref": "SleepStage" }, "type": "array", "description": "Output only. List of short awake segments (under a set threshold) that are part of the sleep session. These can overlap with sleep stages.", "readOnly": true }, "type": { "description": "Optional. SleepType: classic or stages.", "type": "string", "enumDescriptions": [ "Sleep type is unspecified.", "Classic sleep is a sleep with 3 stages types: AWAKE, RESTLESS and ASLEEP.", "On top of \"classic\" sleep stages an additional processing pass can calculate stages more precisely, overwriting the prior stages with AWAKE, LIGHT, REM and DEEP." ], "enum": [ "SLEEP_TYPE_UNSPECIFIED", "CLASSIC", "STAGES" ] }, "summary": { "description": "Output only. Sleep summary: metrics and stages summary.", "readOnly": true, "$ref": "SleepSummary" }, "outOfBedSegments": { "items": { "$ref": "OutOfBedSegment" }, "type": "array", "description": "Optional. “Out of bed” segments that can overlap with sleep stages." }, "metadata": { "description": "Optional. Sleep metadata: `processed`, `main_sleep`, `manually_edited`, and `stages_status`.", "$ref": "SleepMetadata" }, "stages": { "type": "array", "items": { "$ref": "SleepStage" }, "description": "Optional. List of non-overlapping contiguous sleep stage segments that cover the sleep period." } }, "id": "Sleep" }, "ActiveMinutesRollupValue": { "id": "ActiveMinutesRollupValue", "type": "object", "properties": { "activeMinutesRollupByActivityLevel": { "items": { "$ref": "ActiveMinutesRollupByActivityLevel" }, "description": "Active minutes by activity level. At most one record per activity level is allowed.", "type": "array" } }, "description": "Represents the result of the rollup of the active minutes data type." }, "RollUpDataPointsRequest": { "id": "RollUpDataPointsRequest", "description": "Request to roll up data points by physical time intervals.", "properties": { "range": { "description": "Required. Closed-open range of data points that will be rolled up. The maximum range for `calories-in-heart-rate-zone`, `heart-rate`, `active-minutes` and `total-calories` is 14 days. The maximum range for all other data types is 90 days.", "$ref": "Interval" }, "pageSize": { "description": "Optional. The maximum number of data points to return. If unspecified, at most 1440 data points will be returned. The maximum page size is 10000; values above that will be truncated accordingly.", "format": "int32", "type": "integer" }, "pageToken": { "type": "string", "description": "Optional. The next_page_token from a previous request, if any. All other request fields need to be the same as in the initial request when the page token is specified." }, "dataSourceFamily": { "type": "string", "description": "Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect." }, "windowSize": { "type": "string", "format": "google-duration", "description": "Required. The size of the time window to group data points into before applying the aggregation functions. Must be at least 1 second. If the requested range is not an exact multiple of `window_size`, the final bucket chronologically will be truncated at the upper endpoint of the range and will cover a duration shorter than `window_size`." } }, "type": "object" }, "DailyHeartRateVariability": { "type": "object", "id": "DailyHeartRateVariability", "properties": { "deepSleepRootMeanSquareOfSuccessiveDifferencesMilliseconds": { "type": "number", "format": "double", "description": "Optional. The root mean square of successive differences (RMSSD) value during deep sleep." }, "entropy": { "description": "Optional. The Shanon entropy of heartbeat intervals. Entropy quantifies randomness or disorder in a system. High entropy indicates high HRV. Entropy is measured from the histogram of time interval between successive heart beats values measured during sleep.", "format": "double", "type": "number" }, "averageHeartRateVariabilityMilliseconds": { "format": "double", "type": "number", "description": "Optional. A user's average heart rate variability calculated using the root mean square of successive differences (RMSSD) in times between heartbeats." }, "date": { "description": "Required. Date (in the user's timezone) of heart rate variability measurement.", "$ref": "Date" }, "nonRemHeartRateBeatsPerMinute": { "format": "int64", "description": "Optional. Non-REM heart rate", "type": "string" } }, "description": "Represents the daily heart rate variability data type. At least one of the following fields must be set: - `average_heart_rate_variability_milliseconds` - `non_rem_heart_rate_beats_per_minute` - `entropy` - `deep_sleep_root_mean_square_of_successive_differences_milliseconds`" }, "EnergyQuantityRollup": { "properties": { "userProvidedUnitLast": { "enumDescriptions": [ "Unspecified energy unit.", "Value representing joule.", "Value representing kilojoule.", "Value representing kilocalorie.", "Value representing small calorie.", "Value representing calorie." ], "description": "Optional. The user provided unit on the last element.", "type": "string", "enum": [ "ENERGY_UNIT_UNSPECIFIED", "JOULE", "KILOJOULE", "KILOCALORIE", "SMALL_CALORIE", "CALORIE" ] }, "kcalSum": { "format": "double", "type": "number", "description": "Required. The sum of the energy in kilocalories." } }, "description": "Rollup for the energy quantity.", "id": "EnergyQuantityRollup", "type": "object" }, "DataSource": { "type": "object", "properties": { "recordingMethod": { "type": "string", "description": "Optional. Captures how the data was recorded.", "enumDescriptions": [ "The recording method is unspecified.", "The data was manually entered by the user.", "The data was passively measured by a device.", "The data was derived from other data, e.g., by an algorithm in the backend.", "The data was actively measured by a device.", "The recording method is unknown. This is set when the data is uploaded from a third party app that does not provide this information." ], "enum": [ "RECORDING_METHOD_UNSPECIFIED", "MANUAL", "PASSIVELY_MEASURED", "DERIVED", "ACTIVELY_MEASURED", "UNKNOWN" ] }, "device": { "description": "Optional. Captures metadata for raw data points originating from devices. We expect this data source to be used for data points written on device sync.", "$ref": "Device" }, "platform": { "enumDescriptions": [ "The platform is unspecified.", "The data was uploaded from Fitbit.", "The data was uploaded from Health Connect.", "The data was uploaded from Health Kit.", "The data was uploaded from Google Fit.", "The data was uploaded from Fitbit legacy Web API.", "The data was uploaded from Nest devices.", "The data was uploaded from Google Health API.", "The data was uploaded from Google Partner Integrations." ], "enum": [ "PLATFORM_UNSPECIFIED", "FITBIT", "HEALTH_CONNECT", "HEALTH_KIT", "FIT", "FITBIT_WEB_API", "NEST", "GOOGLE_WEB_API", "GOOGLE_PARTNER_INTEGRATION" ], "description": "Output only. Captures the platform that uploaded the data.", "readOnly": true, "type": "string" }, "application": { "description": "Output only. Captures metadata for the application that provided this data.", "$ref": "Application", "readOnly": true } }, "description": "Data Source definition to track the origin of data. Each health data point, regardless of the complexity or data model (whether a simple step count or a detailed sleep session) must retain information about its source of origin (e.g. the device or app that collected it).", "id": "DataSource" }, "IrregularRhythmNotification": { "properties": { "interval": { "description": "Required. Observed interval.", "$ref": "SessionTimeInterval" }, "medicalDeviceInfo": { "description": "Output only. The meta information for the compatible device used to conduct the measurement. Irregular Rhythm Notification measurements typically populate `algorithm_version`, `service_version`, and `device_model`.", "readOnly": true, "$ref": "MedicalDeviceInfo" }, "alertWindows": { "type": "array", "items": { "$ref": "AlertWindow" }, "description": "Optional. The overlapping analysis windows that were used to evaluate rhythm for potential AFib, containing specific information about the user's heart rhythm." } }, "description": "Represents an Irregular Rhythm Notification alert, indicating a potential sign of atrial fibrillation (AFib). This data type is based on SaMD feature and any changes to it may require additional review.", "type": "object", "id": "IrregularRhythmNotification" }, "EndpointAuthorization": { "properties": { "secretSet": { "description": "Output only. Whether the secret is set.", "type": "boolean", "readOnly": true }, "secret": { "description": "Required. Input only. Provides a client-provided secret that will be sent with each notification to the subscriber endpoint using the \"Authorization\" header. The value must include the authorization scheme, e.g., \"Bearer \" or \"Basic \", as it will be used as the full Authorization header value. This secret is used by the API to test the endpoint during `CreateSubscriber` and `UpdateSubscriber` calls, and will be sent in the `Authorization` header for all subsequent webhook notifications to this endpoint.", "type": "string" } }, "description": "Authorization mechanism for a subscriber endpoint. For all requests sent by the Webhooks service, the JSON payload is cryptographically signed. The signature is delivered in the `GOOGLE-HEALTH-API-SIGNATURE` HTTP header. This is an ECDSA (NIST P256) signature of the JSON payload. Clients must verify this signature using Google Health API's public key to confirm the payload was sent by the Health API.", "type": "object", "id": "EndpointAuthorization" }, "WeightQuantityRollup": { "type": "object", "id": "WeightQuantityRollup", "properties": { "gramsSum": { "description": "Required. The sum of the weight in grams.", "format": "double", "type": "number" }, "userProvidedUnitLast": { "type": "string", "description": "Optional. The user provided unit on the last element.", "enumDescriptions": [ "Unspecified weight unit.", "Value representing gram.", "Value representing kilogram.", "Value representing ounce.", "Value representing pound.", "Value representing stone.", "Value representing milligram.", "Value representing microgram.", "Value representing nanogram." ], "enum": [ "WEIGHT_UNIT_UNSPECIFIED", "GRAM", "KILOGRAM", "OUNCE", "POUND", "STONE", "MILLIGRAM", "MICROGRAM", "NANOGRAM" ] } }, "description": "Rollup for the weight." }, "HeartRateVariabilityMetadata": { "description": "Metadata for HeartRateVariability.", "type": "object", "id": "HeartRateVariabilityMetadata", "properties": { "highFrequencyPower": { "type": "number", "description": "Optional. The power in interbeat interval fluctuations within the high frequency band (0.15 Hz - 0.4 Hz).", "format": "double" }, "lowFrequencyPower": { "description": "Optional. The power in interbeat interval fluctuations within the low frequency band (0.04 Hz - 0.15 Hz).", "type": "number", "format": "double" } } }, "ExerciseMetadata": { "properties": { "poolLengthMillimeters": { "format": "int64", "description": "Optional. Pool length in millimeters. Only present in the swimming exercises.", "type": "string" }, "hasGps": { "description": "Optional. Whether the exercise had GPS tracking.", "type": "boolean" } }, "type": "object", "description": "Additional exercise metadata.", "id": "ExerciseMetadata" }, "HttpHeader": { "type": "object", "properties": { "key": { "description": "The HTTP header key. It is case insensitive.", "type": "string" }, "value": { "description": "The HTTP header value.", "type": "string" } }, "description": "Represents an HTTP header.", "id": "HttpHeader" }, "OutOfBedSegment": { "id": "OutOfBedSegment", "description": "A time interval to represent an out-of-bed segment.", "properties": { "startTime": { "description": "Required. Segment tart time.", "format": "google-datetime", "type": "string" }, "endTime": { "format": "google-datetime", "type": "string", "description": "Required. Segment end time." }, "endUtcOffset": { "format": "google-duration", "type": "string", "description": "Required. The offset of the user's local time at the end of the segment relative to the Coordinated Universal Time (UTC)." }, "startUtcOffset": { "type": "string", "description": "Required. The offset of the user's local time at the start of the segment relative to the Coordinated Universal Time (UTC).", "format": "google-duration" } }, "type": "object" }, "Operation": { "id": "Operation", "description": "This resource represents a long-running operation that is the result of a network API call.", "type": "object", "properties": { "metadata": { "type": "object", "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any." }, "name": { "type": "string", "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`." }, "done": { "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.", "type": "boolean" }, "error": { "description": "The error result of the operation in case of failure or cancellation.", "$ref": "Status" }, "response": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "type": "object", "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`." } } }, "ListPairedDevicesResponse": { "properties": { "pairedDevices": { "type": "array", "description": "The paired devices of the user.", "items": { "$ref": "PairedDevice" } }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } }, "id": "ListPairedDevicesResponse", "type": "object", "description": "Response message for ListPairedDevices." }, "SedentaryPeriodRollupValue": { "id": "SedentaryPeriodRollupValue", "type": "object", "properties": { "durationSum": { "format": "google-duration", "type": "string", "description": "The total time user spent sedentary during the interval." } }, "description": "Represents the result of the rollup of the user's sedentary periods." }, "PairedDevice": { "properties": { "name": { "description": "Identifier. The resource name of this Device resource. Format: `users/{user}/pairedDevices/{paired_device}` Example: `users/1234567890/pairedDevices/123` or `users/me/pairedDevices/123`", "type": "string" }, "lastSyncTime": { "format": "google-datetime", "readOnly": true, "type": "string", "description": "Output only. The time of last sync with the Fitbit mobile application." }, "deviceVersion": { "readOnly": true, "type": "string", "description": "Output only. The product name of the device" }, "features": { "readOnly": true, "description": "Output only. Lists of unique features supported by the device. Comprehensive list of supported features: **Fitness Tracking** - `ACTIVE_MINUTES`: Legacy active minutes. - `AUTOSTRIDE`: Automatic stride length calculation. - `BIKE_ONBOARDING`: Cycling UI support. - `CALORIES`: Daily burned calories. - `DISTANCE`: Daily distance tracking. - `ELEVATION`: Floors climbed. - `INACTIVITY_ALERTS`: Reminders to move. - `SEDENTARY_TIME`: Tracks inactive time. - `STEPS`: Daily steps. - `SWIM`: Swim tracking (laps/strokes). - `AUTORUN`: Automatic run detection. - `ACTIVE_ZONE_MINUTES`: Active Zone Minutes (AZM). **Heart Rate & Health** - `HEART_RATE`: Continuous heart rate (PPG). - `BAT_SIGNAL`: High/Low Heart Rate Alerts. **Advanced Sensors** - `SPO2`: Blood oxygen saturation. - `NIGHTTIME_OXYGEN_SATURATION`: Sleep SpO2. - `ESTIMATED_OXYGEN_VARIATION`: Estimated Oxygen Variation. - `EDA`: Electrodermal Activity (stress). - `SKIN_TEMPERATURE`: Skin temperature variation. - `INTERNAL_DEVICE_TEMPERATURE`: Internal device temperature. **Sleep & Wellness** - `SLEEP`: Basic sleep tracking. - `SMART_SLEEP`: Advanced sleep tracking (stages/score). - `BEDTIME_REMINDER`: Bedtime reminders. - `SOUNDSCAPE`: Snore and noise detection. **Advanced Workouts** - `WB`: Custom Workout Builder. - `AUTOCUES`: Auto Cues / Auto Lap. - `DWR_RUN`: Daily Run Recommendations. - `ADVANCED_RUNNING`: Advanced Running Dynamics (e.g., GCT, VO). **GPS & Location** - `GPS`: Built-in GPS. - `CONNECTED_GPS`: Connected GPS (uses phone). - `LOCATION_HINT`: Location helper. **Payments & NFC** - `PAYMENTS`: NFC payments (Fitbit Pay/Google Wallet). - `FELICA`: FeliCa support (Japan payments/transit). **Activity Detection** - `GROK`: SmartTrack automatic activity detection. - `RETRO_AR`: Retroactive Activity Recognition prompts. **Smart Features & UI** - `ALARMS`: Silent alarms. - `BLE_MUSIC_CONTROL`: BLE music control. - `MUSIC`: Direct music storage/control. - `YOUTUBE_MUSIC_SUPPORTED`: YouTube Music support. - `GALLERY`: App Gallery. - `TUTORIAL_SUPPORTED`: On-screen tutorials. - `SMILEY_EMOTE`: Legacy Zip face. - `MOBILE_TO_DEVICE_DEEPLINK`: Mobile to device settings deep link. - `HIDE_GALLERY`: Option to hide Gallery. - `HIDE_GOAL_SELECTION`: Option to hide goal selection. - `DIGITAL_WARRANTY_SUPPORTED`: Digital warranty display. - `DIRECT_DEVICE_SETTINGS_SUPPORTED`: Direct device settings management. **Gym HR Broadcasting** - `ASPEN_SUPPORTED`: Broadcast HR to gym equipment. - `ASPEN_REMOTE_UI_SUPPORTED`: Remote UI for HR sharing. **Privacy & Security** - `FINITE_IMPROBABILITY`: BLE Resolvable Private Address (RPA) privacy. - `DOMAIN_KEY_SYNC`: Domain key synchronization. **BLE Protocol** - `BONDING`: Secure BLE bonding. - `ADVERTISES_SERIAL`: Advertises serial number. - `STATUS_CHARACTERISTIC`: BLE Status Characteristic. - `TRACKER_CHANNEL_CHARACTERISTIC`: BLE Tracker Channel Characteristic. - `PING_CHARACTERISTIC`: BLE Ping Characteristic. **Cellular & Wi-Fi** - `MOBILE_DATA`: LTE cellular support. - `SINGLE_AP_WIFI`: Single AP Wi-Fi. - `MULTI_AP_WIFI`: Multi AP Wi-Fi. - `WIFI_FWUP`: Firmware updates over Wi-Fi. **Data Sync & Transfer** - `APP_SYNC`: Background app sync. - `LIVE_DATA`: Real-time data streaming. - `EVENT_BASED_SYNC_SUPPORTED`: Event-based sync. - `TIME_SERVICE`: Time synchronization service. - `REMOTE_FILE_PROVIDER`: Remote file transfer. - `DIRECT_COMMS_ALARMS`: Direct communication for alarms. - `DIRECT_COMMS_EXERCISE`: Direct communication for exercise. - `DIRECT_COMMS_BATTERY_ALERTS`: Direct communication for battery alerts. **Google Integrations** - `PARROT_TREE_SUPPORTED`: Find My Device support.", "items": { "type": "string" }, "type": "array" }, "deviceType": { "enumDescriptions": [ "Device type is not specified.", "Device type is tracker.", "Device type is scale." ], "description": "Output only. The device type. Supported: TRACKER | SCALE", "readOnly": true, "type": "string", "enum": [ "DEVICE_TYPE_UNSPECIFIED", "TRACKER", "SCALE" ] }, "batteryLevel": { "format": "int32", "type": "integer", "description": "Output only. The battery level of the device.", "readOnly": true }, "batteryStatus": { "description": "Output only. The battery status of the device. Supported: High | Medium | Low | Empty", "readOnly": true, "type": "string" }, "macAddress": { "type": "string", "description": "Output only. Mac ID number of the device.", "readOnly": true } }, "description": "User's Paired 1P Device The PairedDevice details include information about the device type, battery status, battery level, last sync time, device version, mac address, and features.", "type": "object", "id": "PairedDevice" }, "DateTime": { "properties": { "nanos": { "format": "int32", "description": "Optional. Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999, defaults to 0.", "type": "integer" }, "minutes": { "type": "integer", "format": "int32", "description": "Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0." }, "seconds": { "type": "integer", "description": "Optional. Seconds of minutes of the time. Must normally be from 0 to 59, defaults to 0. An API may allow the value 60 if it allows leap-seconds.", "format": "int32" }, "hours": { "type": "integer", "format": "int32", "description": "Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults to 0 (midnight). An API may choose to allow the value \"24:00:00\" for scenarios like business closing time." }, "year": { "format": "int32", "type": "integer", "description": "Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a datetime without a year." }, "month": { "description": "Optional. Month of year. Must be from 1 to 12, or 0 if specifying a datetime without a month.", "type": "integer", "format": "int32" }, "day": { "format": "int32", "description": "Optional. Day of month. Must be from 1 to 31 and valid for the year and month, or 0 if specifying a datetime without a day.", "type": "integer" }, "utcOffset": { "description": "UTC offset. Must be whole seconds, between -18 hours and +18 hours. For example, a UTC offset of -4:00 would be represented as { seconds: -14400 }.", "format": "google-duration", "type": "string" }, "timeZone": { "description": "Time zone.", "$ref": "TimeZone" } }, "id": "DateTime", "description": "Represents civil time (or occasionally physical time). This type can represent a civil time in one of a few possible ways: * When utc_offset is set and time_zone is unset: a civil time on a calendar day with a particular offset from UTC. * When time_zone is set and utc_offset is unset: a civil time on a calendar day in a particular time zone. * When neither time_zone nor utc_offset is set: a civil time on a calendar day in local time. The date is relative to the Proleptic Gregorian Calendar. If year, month, or day are 0, the DateTime is considered not to have a specific year, month, or day respectively. This type may also be used to represent a physical time if all the date and time fields are set and either case of the `time_offset` oneof is set. Consider using `Timestamp` message for physical time instead. If your use case also would like to store the user's timezone, that can be done in another field. This type is more flexible than some applications may want. Make sure to document and validate your application's limitations.", "type": "object" }, "HeartRate": { "description": "A heart rate measurement.", "type": "object", "id": "HeartRate", "properties": { "beatsPerMinute": { "format": "int64", "description": "Required. The heart rate value in beats per minute.", "type": "string" }, "metadata": { "description": "Optional. Metadata about the heart rate sample.", "$ref": "HeartRateMetadata" }, "sampleTime": { "description": "Required. Observation time", "$ref": "ObservationSampleTime" } } }, "WeightQuantity": { "id": "WeightQuantity", "description": "Represents the weight quantity.", "type": "object", "properties": { "grams": { "type": "number", "format": "double", "description": "Required. The weight value in grams." }, "userProvidedUnit": { "enum": [ "WEIGHT_UNIT_UNSPECIFIED", "GRAM", "KILOGRAM", "OUNCE", "POUND", "STONE", "MILLIGRAM", "MICROGRAM", "NANOGRAM" ], "enumDescriptions": [ "Unspecified weight unit.", "Value representing gram.", "Value representing kilogram.", "Value representing ounce.", "Value representing pound.", "Value representing stone.", "Value representing milligram.", "Value representing microgram.", "Value representing nanogram." ], "type": "string", "description": "Optional. Value representing the user provided unit." } } }, "Profile": { "description": "Profile details.", "id": "Profile", "type": "object", "properties": { "autoWalkingStrideLengthMm": { "type": "integer", "format": "int32", "description": "Output only. The automatically calculated walking stride length, in millimeters. The user must consent to one of the following access scopes to access this field: - `https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly` - `https://www.googleapis.com/auth/googlehealth.activity_and_fitness`", "readOnly": true }, "age": { "type": "integer", "description": "Optional. The age in years based on the user's birth date. Updates to this field are currently not supported.", "format": "int32" }, "membershipStartDate": { "description": "Output only. The date the user created their account. Updates to this field are currently not supported.", "readOnly": true, "$ref": "Date" }, "userConfiguredWalkingStrideLengthMm": { "format": "int32", "description": "Optional. The user's user configured walking stride length, in millimeters. The user must consent to one of the following access scopes to access this field: - `https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly` - `https://www.googleapis.com/auth/googlehealth.activity_and_fitness`", "type": "integer" }, "autoRunningStrideLengthMm": { "type": "integer", "format": "int32", "readOnly": true, "description": "Output only. The automatically calculated running stride length, in millimeters. The user must consent to one of the following access scopes to access this field: - `https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly` - `https://www.googleapis.com/auth/googlehealth.activity_and_fitness`" }, "userConfiguredRunningStrideLengthMm": { "format": "int32", "description": "Optional. The user's user configured running stride length, in millimeters. The user must consent to one of the following access scopes to access this field: - `https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly` - `https://www.googleapis.com/auth/googlehealth.activity_and_fitness`", "type": "integer" }, "name": { "type": "string", "description": "Identifier. The resource name of this Profile resource. Format: `users/{user}/profile` Example: `users/1234567890/profile` or `users/me/profile` The {user} ID is a system-generated Google Health API user ID, a string of 1-63 characters consisting of lowercase and uppercase letters, numbers, and hyphens. The literal `me` can also be used to refer to the authenticated user." } } }, "Subscription": { "id": "Subscription", "type": "object", "properties": { "name": { "description": "Identifier. The resource name of the Subscription. Format: `projects/{project}/subscribers/{subscriber}/subscriptions/{subscription}` Example: `projects/my-project/subscribers/my-subscriber-123/subscriptions/my-subscription-456` The {project} ID is mandatory (6-30 characters, matching /a-z{6,30}/) The {subscriber} ID is user-settable (4-36 characters, matching /[a-z]([a-z0-9-]{2,34}[a-z0-9])/) if provided during creation, or system-generated otherwise. The {subscription} ID is user-settable (4-36 chars, matching /[a-z]([a-z0-9-]{2,34}[a-z0-9])/) or system-generated otherwise.", "type": "string" }, "user": { "description": "Immutable. The resource name of the user for whom this subscription is active. Format: `users/{user}` where `{user}` is the public `healthUserId` as returned by the `GetIdentity` action in the profile PAPI (see `google.devicesandservices.health.v4main.HealthProfileService.GetIdentity`).", "type": "string" }, "dataTypes": { "items": { "type": "string" }, "type": "array", "description": "Optional. Data types subscribed to. A subscriber will only receive notifications for data types that are declared here. A subscription can only subscribe to the data types of the subscriber. The values should be in the format \"users/{health_user_id}/dataTypes/{data_type}\" where `{data_type}` is one of \"altitude\", \"distance\", \"floors\", \"sleep\", \"steps\", \"weight\"." } }, "description": "A subscription to a data collection for a specific user, to be delivered to a subscriber." }, "RollUpDataPointsResponse": { "description": "Response containing the list of rolled up data points.", "properties": { "rollupDataPoints": { "description": "Values for each aggregation time window.", "type": "array", "items": { "$ref": "RollupDataPoint" } }, "nextPageToken": { "type": "string", "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages." } }, "id": "RollUpDataPointsResponse", "type": "object" }, "Weight": { "id": "Weight", "description": "Body weight measurement.", "properties": { "notes": { "description": "Optional. Standard free-form notes captured at manual logging.", "type": "string" }, "sampleTime": { "$ref": "ObservationSampleTime", "description": "Required. The time at which the weight was measured" }, "weightGrams": { "format": "double", "type": "number", "description": "Required. Weight of a user in grams." } }, "type": "object" }, "ManifestParams": { "id": "ManifestParams", "type": "object", "properties": { "passcode": { "description": "Optional. ", "type": "string" }, "recipient": { "description": "Required. A string describing the recipient (e.g.,the name of an organization or person) suitable for display to the Receiving User", "type": "string" }, "embeddedLengthMax": { "format": "int32", "description": "Optional. Integer upper bound on the length of embedded payloads", "type": "integer" } }, "description": "Represents the POST body contained in a GetShlManifestRequest This message is nested to represent that See https://build.fhir.org/ig/HL7/smart-health-cards-and-links/links-specification.html#smart-health-link-manifest-request" }, "DailyHeartRateZones": { "id": "DailyHeartRateZones", "properties": { "heartRateZones": { "type": "array", "description": "Required. The heart rate zones.", "items": { "$ref": "HeartRateZone" } }, "date": { "$ref": "Date", "description": "Required. Date (in user's timezone) of the heart rate zones record." } }, "description": "User's heart rate zone thresholds based on the Karvonen algorithm for a specific day.", "type": "object" }, "ActiveZoneMinutesRollupValue": { "id": "ActiveZoneMinutesRollupValue", "description": "Represents the result of the rollup of the active zone minutes data type.", "properties": { "sumInPeakHeartZone": { "type": "string", "description": "Active zone minutes in `HeartRateZone.PEAK`.", "format": "int64" }, "sumInCardioHeartZone": { "description": "Active zone minutes in `HeartRateZone.CARDIO`.", "format": "int64", "type": "string" }, "sumInFatBurnHeartZone": { "description": "Active zone minutes in `HeartRateZone.FAT_BURN`.", "type": "string", "format": "int64" } }, "type": "object" }, "RestingHeartRatePersonalRangeRollupValue": { "type": "object", "id": "RestingHeartRatePersonalRangeRollupValue", "description": "Represents the rollup value for the daily resting heart rate data type.", "properties": { "beatsPerMinuteMin": { "format": "double", "description": "The lower bound of the user's daily resting heart rate personal range.", "type": "number" }, "beatsPerMinuteMax": { "type": "number", "description": "The upper bound of the user's daily resting heart rate personal range.", "format": "double" } } }, "CoreBodyTemperatureRollupValue": { "id": "CoreBodyTemperatureRollupValue", "description": "Represents the result of the rollup of the core body temperature data type.", "type": "object", "properties": { "temperatureCelsiusAvg": { "format": "double", "description": "Average core body temperature in Celsius.", "type": "number" }, "temperatureCelsiusMax": { "format": "double", "type": "number", "description": "Maximum core body temperature in Celsius." }, "temperatureCelsiusMin": { "description": "Minimum core body temperature in Celsius.", "format": "double", "type": "number" } } }, "Symptoms": { "id": "Symptoms", "description": "Symptoms logged by the user.", "type": "object", "properties": { "symptoms": { "type": "array", "description": "Required. List of symptoms experienced.", "items": { "type": "string", "enum": [ "SYMPTOM_VALUE_UNSPECIFIED", "CRAMPS", "HEADACHE", "TENDER_BREASTS", "ACNE", "SICK", "BLOATED", "HOT_FLASHES", "PMS", "COUGH", "FEVER", "DIFFICULTY_BREATHING", "BACK_PAIN", "SHAKINESS", "HUNGER", "SWEATING", "ANXIETY", "THIRST", "FREQUENT_URINATION", "BLURRED_VISION", "OTHER", "SEX_DRIVE_HIGH", "SEX_DRIVE_MEDIUM", "SEX_DRIVE_LOW", "HEART_PALPITATIONS", "FAINTING", "CHEST_PAIN", "FATIGUE", "CONFUSION", "DIZZINESS", "ABDOMINAL_PAIN", "BLADDER_LEAKS", "BLEEDING_GUMS", "BRAIN_FOG", "BURNING_MOUTH", "CONSTIPATION", "CRAVINGS", "DECREASED_APPETITE", "DIARRHEA", "DRAWING_PAIN", "DRY_EYES", "DRY_HAIR", "DRY_SKIN", "EXHAUSTION", "FEEL_GOOD", "FOOD_AVERSIONS", "HAIR_LOSS", "HEARTBURN", "HYPERPIGMENTATION", "INCREASED_APPETITE", "INCREASED_APPETITE_V2", "INSOMNIA", "JOINT_PAIN", "LEG_CRAMPS", "MILKY_NIPPLE_DISCHARGE", "NAUSEA", "NIGHT_SWEATS", "NORMAL_DIGESTION", "NORMAL_STOOL", "PERINEUM_PAIN", "SLEEPINESS", "STRETCH_MARKS", "SWELLING", "VAGINAL_DRYNESS", "VAGINAL_ITCHING", "VOMITING" ], "enumDescriptions": [ "Unspecified symptom value.", "Abdominal cramps.", "Headache.", "Tender breasts.", "Acne.", "Feeling sick or unwell.", "Bloating or abdominal swelling.", "Hot flashes.", "Premenstrual syndrome symptoms.", "Coughing.", "Fever or elevated body temperature.", "Difficulty breathing or shortness of breath.", "Back pain.", "Shakiness or tremors.", "Excessive hunger.", "Excessive sweating.", "Anxiety or nervousness.", "Excessive thirst.", "Frequent urination.", "Blurred vision.", "Other symptoms.", "High sex drive.", "Medium sex drive.", "Low sex drive.", "Heart palpitations or racing heart.", "Fainting or loss of consciousness.", "Chest pain or discomfort.", "Fatigue or extreme tiredness.", "Confusion or mental fogginess.", "Dizziness or lightheadedness.", "Abdominal pain.", "Bladder leaks.", "Bleeding gums.", "Brain fog.", "Burning mouth.", "Constipation.", "Food cravings.", "Decreased appetite.", "Diarrhea.", "Drawing pain.", "Dry eyes.", "Dry hair.", "Dry skin.", "Exhaustion.", "Feeling good or well.", "Food aversions.", "Hair loss.", "Heartburn.", "Hyperpigmentation.", "Increased appetite.", "Increased appetite V2.", "Insomnia or difficulty sleeping.", "Joint pain.", "Leg cramps.", "Milky nipple discharge.", "Nausea.", "Night sweats.", "Normal digestion.", "Normal stool.", "Perineum pain.", "Sleepiness or drowsiness.", "Stretch marks.", "Swelling.", "Vaginal dryness.", "Vaginal itching.", "Vomiting." ] } }, "sampleTime": { "description": "Required. Time when the symptoms were logged.", "$ref": "ObservationSampleTime" } } }, "ActiveEnergyBurnedRollupValue": { "type": "object", "id": "ActiveEnergyBurnedRollupValue", "description": "Represents the result of the rollup of active energy burned.", "properties": { "kcalSum": { "type": "number", "format": "double", "description": "Output only. Sum of the active energy burned in kilocalories.", "readOnly": true } } }, "GoogleDevicesandservicesHealthV4User": { "type": "object", "properties": { "name": { "type": "string", "description": "Identifier. The resource name of the user. The `{user}` ID is a system-generated identifier, as described in Identity.health_user_id. Format: `users/{user}`" } }, "description": "Represents a user in the Google Health API. It matches the parent resource of collections owned by the user. Clients currently do not need to interact with this resource directly.", "id": "GoogleDevicesandservicesHealthV4User" }, "ExportExerciseTcxResponse": { "type": "object", "id": "ExportExerciseTcxResponse", "properties": { "tcxData": { "type": "string", "description": "Contains the exported TCX data. This field is intended for gRPC clients, as media download integration is not supported for gRPC. HTTP clients should instead use the `alt=media` query parameter to download the raw binary TCX file." } }, "description": "Represents a Response for exporting exercise data in TCX format." }, "Electrocardiogram": { "id": "Electrocardiogram", "type": "object", "description": "Represents an Electrocardiogram (ECG) measurement session. This data type is based on SaMD feature and any changes to it may require additional review.", "properties": { "resultClassification": { "type": "string", "enumDescriptions": [ "Unspecified result classification.", "Heart rhythm appears normal. Corresponds to result \"Normal Sinus Rhythm\".", "Signs of Atrial Fibrillation detected. Corresponds to result \"Atrial Fibrillation\".", "The reading is inconclusive as it could not be classified. Corresponds to result \"Inconclusive\".", "The reading is inconclusive as it could not be classified because heart rate is high (\u003e120bpm). Corresponds to result \"Inconclusive: High heart rate\".", "The reading is inconclusive as it could not be classified because heart rate is low (\u003c50bpm). Corresponds to result \"Inconclusive: Low heart rate\".", "The reading is unreadable.", "The reading was not analyzed." ], "description": "Optional. The result classification of the ECG reading.", "enum": [ "RESULT_CLASSIFICATION_UNSPECIFIED", "NORMAL_SINUS_RHYTHM", "ATRIAL_FIBRILLATION", "INCONCLUSIVE", "INCONCLUSIVE_HIGH_HEART_RATE", "INCONCLUSIVE_LOW_HEART_RATE", "UNREADABLE", "NOT_ANALYZED" ] }, "millivoltsScalingFactor": { "type": "integer", "format": "int32", "description": "Optional. The factor by which to divide waveform samples to get voltage in millivolts: millivolts = waveform_sample / millivolts_scaling_factor." }, "samplingFrequencyHertz": { "description": "Optional. The sampling frequency of waveform samples in hertz.", "format": "int32", "type": "integer" }, "waveformSamples": { "items": { "format": "int32", "type": "integer" }, "description": "Optional. An array of voltage values representing lead I ECG values. Each sample represents voltage difference in ECG graph. The first value in array corresponds to the start of the reading.", "type": "array" }, "medicalDeviceInfo": { "readOnly": true, "description": "Output only. The meta information for the compatible device used to conduct the measurement. ECG measurements typically populate `firmware_version`, `feature_version`, and `device_model`.", "$ref": "MedicalDeviceInfo" }, "interval": { "description": "Required. Observed interval. NOTE: Historical ECG data lacks timezone offsets, so `start_utc_offset` and `end_utc_offset` will be missing or default to zero. As a result, the civil time fields within this interval will default to UTC. It is recommended to use physical time fields instead for accurate time referencing. NOTE: The `start_time` and `end_time` of the interval are equal, representing the reading time.", "$ref": "SessionTimeInterval" }, "beatsPerMinuteAvg": { "type": "string", "format": "int64", "description": "Optional. Average heart rate recorded during ECG reading in beats per minute." }, "leadNumber": { "format": "int32", "type": "integer", "description": "Optional. The number of leads used for ECG reading." } } }, "DailySleepTemperatureDerivations": { "id": "DailySleepTemperatureDerivations", "properties": { "nightlyTemperatureCelsius": { "format": "double", "type": "number", "description": "Required. The user's nightly skin temperature. It is the mean of skin temperature samples taken from the user’s sleep." }, "date": { "description": "Required. Date for which the sleep temperature derivations are calculated.", "$ref": "Date" }, "relativeNightlyStddev30dCelsius": { "type": "number", "description": "Optional. The standard deviation of the user’s relative nightly skin temperature (temperature - baseline) over the past 30 days.", "format": "double" }, "baselineTemperatureCelsius": { "format": "double", "description": "Optional. The user's baseline skin temperature. It is the median of the user's nightly skin temperature over the past 30 days.", "type": "number" } }, "type": "object", "description": "Provides derived sleep temperature values, calculated from skin or internal device temperature readings during sleep." }, "MetricsSummary": { "properties": { "totalSwimLengths": { "description": "Optional. Number of full pool lengths completed during the exercise. Only present in the swimming exercises at the top level as in the summary of the whole exercise.", "type": "number", "format": "double" }, "steps": { "format": "int64", "description": "Optional. Total steps taken during the exercise.", "type": "string" }, "elevationGainMillimeters": { "type": "number", "format": "double", "description": "Optional. Total elevation gain during the exercise." }, "heartRateZoneDurations": { "description": "Optional. Time spent in each heart rate zone.", "$ref": "TimeInHeartRateZones" }, "caloriesKcal": { "description": "Optional. Total calories burned by the user during the exercise.", "type": "number", "format": "double" }, "runVo2Max": { "format": "double", "type": "number", "description": "Optional. Run VO2 max value for the exercise. Only present in the running exercises at the top level as in the summary of the whole exercise." }, "averageHeartRateBeatsPerMinute": { "type": "string", "description": "Optional. Average heart rate during the exercise.", "format": "int64" }, "averagePaceSecondsPerMeter": { "description": "Optional. Average pace in seconds per meter.", "format": "double", "type": "number" }, "activeZoneMinutes": { "description": "Optional. Total active zone minutes for the exercise.", "format": "int64", "type": "string" }, "distanceMillimeters": { "format": "double", "description": "Optional. Total distance covered by the user during the exercise.", "type": "number" }, "averageSpeedMillimetersPerSecond": { "format": "double", "description": "Optional. Average speed in millimeters per second.", "type": "number" }, "mobilityMetrics": { "$ref": "MobilityMetrics", "description": "Optional. Mobility workouts specific metrics. Only present in the advanced running exercises." } }, "description": "Summary metrics for an exercise.", "type": "object", "id": "MetricsSummary" }, "GoogleDevicesandservicesHealthV4betaDataType": { "type": "object", "id": "GoogleDevicesandservicesHealthV4betaDataType", "description": "Represents a type of health data a user can have data points recorded for. It matches the parent resource of collection containing data points of the given type. Clients currently do not need to interact with this resource directly.", "properties": { "name": { "description": "Identifier. The resource name of the data type. Format: `users/{user}/dataTypes/{data_type}` See DataPoint.name for examples and possible values.", "type": "string" } } }, "DailyRollUpDataPointsRequest": { "description": "Request to roll up data points by civil time intervals.", "properties": { "range": { "$ref": "CivilTimeInterval", "description": "Required. Closed-open range of data points that will be rolled up. The start time must be aligned with the aggregation window. The maximum range for `calories-in-heart-rate-zone`, `heart-rate`, `active-minutes` and `total-calories` is 14 days. The maximum range for all other data types is 90 days." }, "windowSizeDays": { "description": "Optional. Aggregation window size, in number of days. Defaults to 1 if not specified. If the requested range is not an exact multiple of `window_size_days`, the final bucket chronologically will be truncated at the upper endpoint of the range and will cover a duration shorter than `window_size_days`.", "type": "integer", "format": "int32" }, "dataSourceFamily": { "description": "Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect.", "type": "string" }, "pageToken": { "description": "Optional. The `next_page_token` from a previous request, if any. All other request fields need to be the same as in the initial request when the page token is specified.", "type": "string" }, "pageSize": { "format": "int32", "type": "integer", "description": "Optional. The maximum number of data points to return. If unspecified, at most 1440 data points will be returned. The maximum page size is 10000; values above that will be truncated accordingly." } }, "id": "DailyRollUpDataPointsRequest", "type": "object" }, "BloodGlucoseRollupValue": { "description": "Represents the result of the rollup of the blood glucose data type. LINT: LEGACY_NAMES", "type": "object", "properties": { "bloodGlucoseMilligramsPerDeciliterAvg": { "format": "double", "type": "number", "description": "Average blood glucose level in mg/dL." } }, "id": "BloodGlucoseRollupValue" }, "ActiveEnergyBurned": { "properties": { "interval": { "description": "Required. Observed interval", "$ref": "ObservationTimeInterval" }, "kcal": { "format": "double", "description": "Required. Energy burned during an activity, measured in kilocalories.", "type": "number" } }, "type": "object", "id": "ActiveEnergyBurned", "description": "Energy burned as part of an activity, excluding the basal energy burn." }, "HeartRateVariabilityPersonalRangeRollupValue": { "id": "HeartRateVariabilityPersonalRangeRollupValue", "description": "Represents the result of the rollup of the user's daily heart rate variability personal range.", "type": "object", "properties": { "averageHeartRateVariabilityMillisecondsMin": { "description": "The lower bound of the user's average heart rate variability personal range.", "format": "double", "type": "number" }, "averageHeartRateVariabilityMillisecondsMax": { "type": "number", "format": "double", "description": "The upper bound of the user's average heart rate variability personal range." } } }, "Empty": { "id": "Empty", "type": "object", "properties": {}, "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }" }, "Identity": { "description": "Represents details about the Google user's identity.", "id": "Identity", "type": "object", "properties": { "legacyUserId": { "description": "Output only. The legacy Fitbit User identifier. This is the Fitbit ID used in the legacy Fitbit APIs (v1-v3). It can be referenced by clients migrating from the legacy Fitbit APIs to map their existing identifiers to the new Google user ID. It **must not** be used for any other purpose. It is not of any use for new clients using only the Google Health APIs. Valid values are strings of 1-63 characters, and valid characters are lowercase and uppercase letters, numbers, and hyphens.", "type": "string", "readOnly": true }, "name": { "description": "Identifier. The resource name of this Identity resource. Format: `users/me/identity`", "type": "string" }, "healthUserId": { "description": "Output only. The Google User Identifier in the Google Health APIs. It matches the `{user}` resource ID segment in the resource name paths, e.g. `users/{user}/dataTypes/steps`. Valid values are strings of 1-63 characters, and valid characters are lowercase and uppercase letters, numbers, and hyphens.", "readOnly": true, "type": "string" } } } }, "description": "The Google Health API lets you view and manage health and fitness metrics and measurement data.", "documentationLink": "https://developers.google.com/health", "baseUrl": "https://health.googleapis.com/", "version": "v4beta", "ownerDomain": "google.com", "fullyEncodeReservedExpansion": true, "canonicalName": "Google Health API", "kind": "discovery#restDescription", "discoveryVersion": "v1", "ownerName": "Google", "protocol": "rest", "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/googlehealth.settings.writeonly": { "description": "Add settings data to Google Health, and edit or delete the data it adds." }, "https://www.googleapis.com/auth/googlehealth.sleep.writeonly": { "description": "Add sleep data to Google Health, and edit or delete the data it adds." }, "https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly": { "description": "Add activity and fitness data to Google Health, and edit or delete the data it adds." }, "https://www.googleapis.com/auth/googlehealth.mindfulness.readonly": { "description": "See your Google Health mindfulness data" }, "https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly": { "description": "See your Google Health activity and fitness data" }, "https://www.googleapis.com/auth/cloud-platform": { "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." }, "https://www.googleapis.com/auth/googlehealth.settings.readonly": { "description": "See your Google Health settings" }, "https://www.googleapis.com/auth/googlehealth.irn.readonly": { "description": "See your Google Health Irregular Rhythm Notifications data" }, "https://www.googleapis.com/auth/googlehealth.reproductive_health.writeonly": { "description": "Add reproductive health data to Google Health, and edit or delete the data it adds" }, "https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.writeonly": { "description": "Add health metric and measurements data to Google Health, and edit or delete the data it adds." }, "https://www.googleapis.com/auth/googlehealth.profile.writeonly": { "description": "Add profile data to Google Health, and edit or delete the data it adds." }, "https://www.googleapis.com/auth/googlehealth.mindfulness.writeonly": { "description": "Add mindfulness data to Google Health, and edit or delete the data it adds" }, "https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonly": { "description": "See your Google Health health metrics and measurement data" }, "https://www.googleapis.com/auth/googlehealth.profile.readonly": { "description": "See your Google Health profile data" }, "https://www.googleapis.com/auth/googlehealth.nutrition.writeonly": { "description": "Add nutrition data to Google Health, and edit or delete the data it adds." }, "https://www.googleapis.com/auth/googlehealth.location.readonly": { "description": "See exercise GPS location data in Google Health" }, "https://www.googleapis.com/auth/googlehealth.sleep.readonly": { "description": "See your Google Health sleep data" }, "https://www.googleapis.com/auth/googlehealth.ecg.readonly": { "description": "See your Google Health ECG data" }, "https://www.googleapis.com/auth/googlehealth.logged_symptoms.readonly": { "description": "See your Google Health logged symptoms data" }, "https://www.googleapis.com/auth/googlehealth.logged_symptoms.writeonly": { "description": "Add logged symptoms data to Google Health, and edit or delete the data it adds" }, "https://www.googleapis.com/auth/googlehealth.reproductive_health.readonly": { "description": "See your Google Health reproductive health data" } } } }, "parameters": { "alt": { "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "location": "query", "type": "string", "enum": [ "json", "media", "proto" ], "default": "json", "description": "Data format for response." }, "$.xgafv": { "location": "query", "enumDescriptions": [ "v1 error format", "v2 error format" ], "type": "string", "enum": [ "1", "2" ], "description": "V1 error format." }, "oauth_token": { "description": "OAuth 2.0 token for the current user.", "location": "query", "type": "string" }, "access_token": { "location": "query", "description": "OAuth access token.", "type": "string" }, "upload_protocol": { "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "location": "query", "type": "string" }, "quotaUser": { "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", "type": "string", "location": "query" }, "prettyPrint": { "default": "true", "description": "Returns response with indentations and line breaks.", "type": "boolean", "location": "query" }, "uploadType": { "type": "string", "location": "query", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\")." }, "key": { "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", "location": "query", "type": "string" }, "fields": { "type": "string", "location": "query", "description": "Selector specifying which fields to include in a partial response." }, "callback": { "type": "string", "location": "query", "description": "JSONP" } }, "title": "Google Health API", "name": "health", "servicePath": "" }