paired_devices

Creates, updates, deletes, gets or lists a paired_devices resource.

Overview

Name	paired_devices
Type	Resource
Id	google.health.paired_devices

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
name	string	Identifier. The resource name of this Device resource. Format: users/{user}/pairedDevices/{paired_device} Example: users/1234567890/pairedDevices/123 or users/me/pairedDevices/123
batteryLevel	integer (int32)	Output only. The battery level of the device.
batteryStatus	string	Output only. The battery status of the device. Supported: High | Medium | Low | Empty
deviceType	string	Output only. The device type. Supported: TRACKER | SCALE (DEVICE_TYPE_UNSPECIFIED, TRACKER, SCALE)
deviceVersion	string	Output only. The product name of the device
features	array	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.
lastSyncTime	string (google-datetime)	Output only. The time of last sync with the Fitbit mobile application.
macAddress	string	Output only. Mac ID number of the device.

list

Name	Datatype	Description
name	string	Identifier. The resource name of this Device resource. Format: users/{user}/pairedDevices/{paired_device} Example: users/1234567890/pairedDevices/123 or users/me/pairedDevices/123
batteryLevel	integer (int32)	Output only. The battery level of the device.
batteryStatus	string	Output only. The battery status of the device. Supported: High | Medium | Low | Empty
deviceType	string	Output only. The device type. Supported: TRACKER | SCALE (DEVICE_TYPE_UNSPECIFIED, TRACKER, SCALE)
deviceVersion	string	Output only. The product name of the device
features	array	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.
lastSyncTime	string (google-datetime)	Output only. The time of last sync with the Fitbit mobile application.
macAddress	string	Output only. Mac ID number of the device.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	usersId, pairedDevicesId		Returns user's Device.
list	select	usersId	pageSize, pageToken	Returns the user's list of paired 1P trackers and smartwatches.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
pairedDevicesId	string
usersId	string
pageSize	integer (int32)
pageToken	string

SELECT examples

get

Returns user's Device.

SELECT
name,
batteryLevel,
batteryStatus,
deviceType,
deviceVersion,
features,
lastSyncTime,
macAddress
FROM google.health.paired_devices
WHERE usersId = '{{ usersId }}' -- required
AND pairedDevicesId = '{{ pairedDevicesId }}' -- required
;

list

Returns the user's list of paired 1P trackers and smartwatches.

SELECT
name,
batteryLevel,
batteryStatus,
deviceType,
deviceVersion,
features,
lastSyncTime,
macAddress
FROM google.health.paired_devices
WHERE usersId = '{{ usersId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
;