April 2023 Newsletter: Samsung Health Stack 1.0 revealed before official release and other latest news

Connection Design Guide

connection design guide samsung health's partner apps can connect to samsung health with samsung health sdk for android a partner app needs to inform samsung health users that the app connects with samsung health and that it shares data the connection design guide provides connection flows with unified look and feel for partner apps notification of samsung health connection menu for connecting to samsung health permission setting menu samsung health name and icon notification of samsung health connection the launch screen of a partner app, event pop-up, or information space is a good approach to notify users of connecting with samsung health a partner app needs to inform users with as concrete description and information as possible do show explicitly a notification of working with samsung health as a partner app the app's launch screen is recommended do include a concrete description of the data synced with samsung health do show the "samsung health" name or its icon see the naming and icon guide do add a ui flow to show the data permission pop-up after the notification message menu for connecting to samsung health a partner app should provide a menu with a convenient interface for the user to change the data sync setting with samsung health do create a menu to set the samsung health's data permission do use a straightforward menu name like "connect to samsung health" recommended contents in "connect to samsung health" are benefits available through samsung health connection and the data synced with samsung health link to samsung health do add an option to install samsung health through "connect to samsung health" if it is not installed do show a samsung health's data permission popup through the menu do place "connect to samsung health" where the user can find it easily do not place "connect to samsung health" under multiple layers that are difficult for the user to find samsung health name & icon samsung health's name and its icon in a partner app should be used properly samsung health name - "samsung health" do use the name "samsung health" do not modify the official name, “samsung health” examples of what to avoid are shealth shealth s health s-health samsunghealth samsung health's icon do use the latest icon you can get it here its official icon is samsung health's icon april 11th, 2019 185kb do not modify the icon do not use any other resource images of samsung health except its icon do not use the samsung health's icon or similar icon for your own application

Overview

notefor android 11 targetsdkversion 30 , please add a <queries> element for the samsung health app in your app manifest see hello health data for more details samsung health sdk for android samsung health sdk for android enables sharing health data between samsung health running on android phones and partner apps samsung health's partner apps can provide their users with additional services with samsung health sdk for android the sdk provides secure access to samsung health data with applicable data types data sharing, however, is enabled only after the user's explicit consent the user can select detailed data sharing settings including which partner app will access the user's data, and which data type will be read or written samsung health sdk for android provides the health data features health data health data has the following features health data store samsung health sdk for android keeps users' health data secured the health data store handles the service connection it facilitates reading samsung health's data or writing the partner's health data to samsung health health data type it provides useful data types each data type is designed to contain a given health data type's information it is used to access the data in health data store permissions and user controls the user's health data are sensitive information handling data with the sdk is only available with the user's explicit consent health data provides a unified user interface and gives the user control of the data sharing settings easily for each data type partner apps program partner app program is an exclusive service for samsung health that allows users to discover engaging health and fitness applications notewe are currently going through an update to better support our partners for that reason, we will not be accepting any applications for the partner apps program at this time sdk download after having a partnership with samsung health, download samsung health sdk for android and create your app samsung health sdk for android | data v1 5 1 dec 5, 2024 1 49mb connection design guide samsung health's partner apps connect to samsung health with samsung health sdk for android unified interfaces in partner apps seamlessly connect with samsung health to provide uninterrupted user experience to the users for the best result, please see connection design guide notification of samsung health connection the launch screen of a partner app, event pop-up, or information space is a good approach to notify users of connecting with samsung health a partner app needs to inform users with as concrete description and information as possible menu for connecting to samsung health a partner app should provide a menu with a convenient interface for the user to change the data sync setting with samsung health samsung health name & icon samsung health's name and its icon should be used properly in a partner app restrictions samsung health android sdk requires samsung health installation the latest sdk works with samsung health 6 28 or above see the sdk and samsung health’s compatible versions here samsung health runs on devices with android 10 api level 29 or above it is available on all samsung smartphones and also non-samsung android smartphones the sdk provides apis to check whether the device supports the sdk see faq for more information

Introduction

programming guide samsung health sdk for android helps samsung health's partners to share health data safely and to create useful health applications samsung health has a health data store where its data can be shared with other partner apps after the user's consent it supports android devices with marshmallow 6 0 including non-samsung devices refer to the following table terms for samsung health sdk for android term description health data framework it provides useful features to handle the user's health data it is included in samsung health and its interface is provided with samsung health sdk for android an app that uses the sdk works with samsung health samsung health an application that helps monitor the user's activities and helps the users to have a healthier life through monitoring walking steps, exercise, heart rate, and etc it can be downloaded from the app market like google play or galaxy apps the term is italicized to be easily distinguished health data framework the health data framework of samsung health sdk for android has the following features health data store handling the connection to samsung health inserting, reading, updating, or deleting health data storing data based on unified units see api reference's descriptions for each data type health data type platform-defined and custom data type privacy granting permission based on the user's consent to read or write the specific data type architecture the sdk's health data framework is designed to provide safe access of its data and to have a seamless health service to the user the following figure shows the health data framework's architecture health data framework the health data framework is included in samsung health applications can access the user's data that are stored in samsung health through the sdk it keeps the user's health data safely health data from various source devices having pedometer, accelerator, or heart rate sensors are inserted to the health data framework with the unified data unit the data can be read by the sdk updating or deleting data is available if the app inserted the data the figure above shows the class and interface relationships in health data detailed descriptions for each class and interface are in the api reference healthdatastore it handles the connection to the data storage of the device it receives its connection result with healthdatastore connectionlistener most requests require the connection to the health data store healthdataresolver the health data framework provides classes and interfaces to insert, read, update, or delete the data healthdataresolver is a central class to handle the health data it sends a data request with related request interfaces the query result can be received immediately with healthdataholder baseresult, healthdataresolver readresult or healthdataresolver aggregateresult or it can be received asynchronously with healthresultholder resultlistener see health data store for more information application developers can use platform-defined data types that samsung health sdk for android provides see health data type for more information especially healthconstants common, the base interface of predefined data types, contains the following mandatory properties for health data unique id of health data created and updated time of health data application package name device that provides health data the health data can be accessed with the user's consent the following figure shows the relationship between classes and interfaces related to healthpermissionmanager it requests permissions to the user with healthpermissionmanager permissionkey to read or write for the specific health data type the permission result can be received synchronous or asynchronously see privacy for more information the sdk's health data library provides the following package com samsung android sdk healthdata main interfaces and classes in the library are described in the following table see the api reference for details interface / class description healthconnectionerrorresult this class handles errors for connection failure to the health data store healthconstants this class defines constants of health data and contains interfaces for various kinds such as the step count or exercise healthdata this class is an object for a health data type, e g the blood pressure or weight quantitative and qualitative values can be defined for the specific health data type based on its data structure definition it is used to manage health data with healthdataresolver healthdataobserver this class defines an observer to handle health data changes healthdataresolver this class accesses health data to insert, read, update, and delete with the filter and aggregate functions healthdatastore this class handles the connection to the data store in the device healthdataunit this class provides unified units for the health data store healthdatautil this class provides useful utility apis healthdevice this class contains detailed device information that provides health data healthdevicemanager this class manages devices related health data healthpermissionmanager this class requests permission to read or write health data for the specific health data type healthresultholder this interface represents the result of invoking method healthuserprofile this class provides the user information

API Reference

overviewpackageclasstreedeprecatedindex samsung health sdk for android - data api reference 1 5 1 health data this document describes com samsung android sdk healthdata apis in samsung health sdk for android see description packages package description com samsung android sdk healthdata this package provides classes and interfaces for the health data framework in samsung health sdk for android health data this document describes com samsung android sdk healthdata apis in samsung health sdk for android the health data package contains classes and interfaces which enable you to create applications with the following functionalities health data store a partner app that uses samsung health sdk for android can write its health data to samsung health or read samsung health's data through the health data store connection see health data store for more information health data type the sdk provides useful predefined and custom data types see health data types for more information privacy data permission acquisition is required to access a specific data type see permission manager for more information for more information related to the development environment, fundamentals, features and sample descriptions, see programming guide compatible version of samsung health samsung health sdk for android works with samsung health the sdk's data library works properly with the specific samsung health version sdk's heath data library version samsung health compatible version 1 5 1 6 28 or above 1 5 0 6 12 or above 1 4 0 6 2 or above 1 3 0 5 11 or above 1 2 0 5 10 or above 1 0 0 4 0 or above e g if you create your app with the health data library 1 5 0, it requires to install samsung health 6 12 or above in the device if the sdk and samsung health's version is not matched, the sdk gives an error old_version_platform you can resolve the error simply and induce the users to update samsung health to the latest version here is a guide to prevent the related error connect to the health data store see healthdatastore connectservice private healthdatastore mstore; @override public void oncreate bundle savedinstancestate { // create a healthdatastore instance and set its listener mstore = new healthdatastore this, mconnectionlistener ; // request the connection to the health data store mstore connectservice ; } if it fails, check healthconnectionerrorresult onconnectionfailed private final healthdatastore connectionlistener mconnectionlistener = new healthdatastore connectionlistener { // @override public void onconnectionfailed healthconnectionerrorresult error { // } if the error is old_version_platform, it means that samsung health needs to be updated to the latest version show a proper message to the user @override public void onconnectionfailed healthconnectionerrorresult error { if error geterrorcode == healthconnectionerrorresult old_version_platform { // show a message to the user to update samsung health } } check a resolution for the error with healthconnectionerrorresult hasresolution if it gives true, resolve the error with healthconnectionerrorresult resolve if error hasresolution { // if there is a solution, resolve it error resolve mainactivity this ; } the samsung health platform leads to upgrade samsung health on the app market see its example exception handing

Process

development process after checking prerequisites and downloading the sdk, you're ready to create your application through the following steps partnership with samsung health partner app program is an exclusive service for samsung health that allows users to discover engaging health and fitness applications an application that uses the sdk will work properly with samsung health after the partner app approval partnership with samsung health team is requires before using the sdk note we are currently going through an update to better support our partners for that reason, we will not be accepting any applications for the partner apps program at this time connection design guide it provides the user interface guidelines for its partner apps to unify the entry point for the connection to samsung health and related interfaces read connection design guide and apply them to your application an application that doesn't follow the guidelines can be rejected for the partner application data synchronization design the partner app of samsung health needs to synchronize the health data the sdk enables your app to read samsung health's data and write your app's data to samsung health see data types for the available data types main data types that represent your application should be contained for data integration the synchronized data between your application and samsung health needs to give a natural flow to the users e g in case of the nutrition app, the user thinks nutrition data would be shared with samsung health without doubt creating an application create an app project and develop your app see hello health data for a quick start testing your application the app that uses the sdk works with samsung health after the partner app approval it needs to be tested fully before applying for the partner app the sdk provides the following environments samsung health‘s developer mode sdk's dataviewer checklist for samsung health’s partner app note samsung health sdk for android doesn't support the emulator test android 6 0 marshmallow api level 23 device or above is required to test your app samsung health's developer mode you can use developer mode to test or debug your app dataviewer dataviewer reads saved health data in samsung health for each data see data viewer for more information checklist for samsung health's partner app samsung health sdk for android provides a checklist that includes basic test items for the app test download the checklist and check your app before applying for partner app on the developer site it helps you save time on the samsung health's registration process publishing your application if your app is approved as a samsung health's partner, package and publish your app on the application market such as google play

Enviroment

development environment check prerequisites first and follow all steps below to create a samsung health’s partner app prerequisites check following prerequisites before downloading samsung health sdk for android android version android 8 0 oreo api level 26 or above available devices android smartphones including non-samsung devices samsung health version a partner app runs with samsung health 4 0 or higher downloading samsung health sdk for android the sdk can be downloaded on the samsung developer site folder in sdk description docs api reference describes the sdk's health data apis programming guide contains development information to create a samsung health's partner app with health data access libs samsung-health-data-va b c aar health data library of samsung health sdk for android samples simplehealth sample application that demonstrates how to read step count data stepdiary sample application that demonstrates how to read step count and daily step count trend data foodnote sample application to check daily calorie intake tools dataviewer apk a test tool for the connection between your app and samsung health that works via the samsung health's developer mode it reads samsung health's saved data

HealthDeviceManager

overviewpackageclasstreedeprecatedindex com samsung android sdk healthdata class healthdevicemanager java lang object com samsung android sdk healthdata healthdevicemanager public class healthdevicemanager extends object this class provides device information that is registered in the data framework and is able to register a new source device that provides health data if a new data is saved to samsung health and its source device is new, the source device is registered to the health data framework automatically a device with samsung health installed is recognized as the local device registering a new source device separately is availble with healthdevice builder build and registerdevice healthdevice the user's device that installed your application can meet many environments like changing a phone and synchronizing samsung health data with the user's samsung account all data in the old phone are moved to the new one using an accessory such as galaxy watch with the phone a data query need to be requested with varied considerations for your application and target devices if you want to make that the query result contains only data your intended devices, set data's source devices for the data query such as with setsourcedevices of healthdataresolver readrequest builder otherwise, the query result can contain unintentional data of registered other accessories to samsung health getting current device information the current device that samsung health runs is registered as the local device in the health data framework if your application runs the current device and adds a new data to samsung health, set the data's source device as the local device the following example shows how to get the current device information public class heathdataexample { // the state of connection private healthdatastore mstore; void createhealthdata { healthdata data = new healthdata ; // sets required properties // sets source device's uuid data setsourcedevice new healthdevicemanager mstore getlocaldevice getuuid ; // adds new data to samsung health healthdataresolver resolver = new healthdataresolver mstore, null ; insertrequest request = new insertrequest builder setdatatype nutrition health_data_type build ; request addhealthdata data ; } } getting all registered devices' information samsung health works with accessories such as galaxy watch by the user's registration and can save the registered accessory's health data also your application can work with a linked accessory and inserts its measured data to samsung health you can get all registered devices to samsung health with getalldevices and figure out other devices beside the current device that samsung health runs as the following example //gets the current device healthdevicemanager devicemanager = new healthdevicemanager mstore ; string localuuid = devicemanager getlocaldevice getuuid ; // gets all registered devices list<healthdevice> healthdevices = new healthdevicemanager mstore getalldevices ; // checks registered devices beside the current device for healthdevice device healthdevices { if !device getuuid equals localuuid { log d app_tag, "accessory's uuid " + device getuuid ; } } registering device to samsung health if you add data to samsung health and the data's source device is not registered yet on samsung health, register the data's source device before to adding data with registerdevice healthdevice since 1 0 0 constructor summary constructors constructor and description healthdevicemanager healthdatastore store constructs and initializes an instance of healthdevicemanager method summary all methods instance methods concrete methods modifier and type method and description boolean changecustomname string uuid, string name changes a custom name of the health device for a given device id list<healthdevice> getalldevices gets a list of all source devices in samsung health's saved data healthdevice getdevicebyseed string seed gets a health device specified by a seed healthdevice getdevicebyuuid string uuid gets a health device specified by an uuid list<string> getdeviceuuidsbycustomname string name gets uuids of health devices for a given custom name list<string> getdeviceuuidsbygroup int group gets uuids of devices for a given group list<string> getdeviceuuidsbymanufacturer string manufacturer gets uuids of health devices for a given manufacturer list<string> getdeviceuuidsbymodel string model gets uuids of health devices for a given device model healthdevice getlocaldevice gets a healthdevice object of the current device string registerdevice healthdevice device registers a new source device that provides health data to the health data framework constructor detail healthdevicemanager public healthdevicemanager healthdatastore store constructs and initializes an instance of healthdevicemanager parameters store - a connection with the health data store since 1 0 0 method detail getlocaldevice public healthdevice getlocaldevice gets a healthdevice object of the current device samsung health sdk for android registers the current device where samsung health is installed returns the health device object throws illegalstateexception - if the connection to the health data store is invalid or a remote-invocation error occurs on the connection since 1 0 0 getalldevices public list<healthdevice> getalldevices gets a list of all source devices in samsung health's saved data it's different with getting all connected devices with samsung health if a connected device didn't save its data to samsung health, the device is not included in this api's return because this api gives only all device ids based on the saved data an accessory that the user removes from samsung health's accessory list can be contained in its result if the accessory's data is saved in samsung health returns a list of registered all health device objects throws illegalstateexception - if the connection to the health data store is invalid or a remote-invocation error occurs on the connection since 1 0 0 registerdevice public string registerdevice healthdevice device registers a new source device that provides health data to the health data framework parameters device - the health device object to register returns the registered device's id throws illegalargumentexception - if the argument is null illegalstateexception - if the connection to the health data store is invalid or a remote-invocation error occurs on the connection since 1 0 0 see also healthdevice builder build getdevicebyseed public healthdevice getdevicebyseed string seed gets a health device specified by a seed parameters seed - the unique value that identifies the device it can be a wi-fi mac address, bluetooth address, or device's serial number returns a health device object for the seed throws illegalargumentexception - if the argument is null illegalstateexception - if the connection to the health data store is invalid or a remote-invocation error occurs on the connection since 1 0 0 getdevicebyuuid public healthdevice getdevicebyuuid string uuid gets a health device specified by an uuid parameters uuid - the uuid that represents the device returns a health device object for the uuid throws illegalargumentexception - if the argument is null illegalstateexception - if the connection to the health data store is invalid or a remote-invocation error occurs on the connection since 1 0 0 getdeviceuuidsbygroup public list<string> getdeviceuuidsbygroup int group gets uuids of devices for a given group parameters group - the device group it can be the following value healthdevice group_unknown healthdevice group_mobile healthdevice group_external healthdevice group_companion returns a list of uuids for devices that are specified with the group throws illegalstateexception - if the connection to the health data store is invalid or a remote-invocation error occurs on the connection since 1 0 0 getdeviceuuidsbycustomname public list<string> getdeviceuuidsbycustomname string name gets uuids of health devices for a given custom name parameters name - the custom name returns a list of uuids for devices that are specified with the custom name throws illegalargumentexception - if the argument is null illegalstateexception - if the connection to the health data store is invalid or a remote-invocation error occurs on the connection since 1 0 0 getdeviceuuidsbymodel public list<string> getdeviceuuidsbymodel string model gets uuids of health devices for a given device model parameters model - the model name returns a list of uuids for devices that are specified with the model name throws illegalargumentexception - if the argument is null illegalstateexception - if the connection to the health data store is invalid or a remote-invocation error occurs on the connection since 1 0 0 getdeviceuuidsbymanufacturer public list<string> getdeviceuuidsbymanufacturer string manufacturer gets uuids of health devices for a given manufacturer parameters manufacturer - the manufacturer name returns a list of uuids for devices that are specified with the manufacturer throws illegalargumentexception - if the argument is null illegalstateexception - if the connection to the health data store is invalid or a remote-invocation error occurs on the connection since 1 0 0 changecustomname public boolean changecustomname string uuid, string name changes a custom name of the health device for a given device id parameters uuid - the device id name - the new custom name of the device returns true if the change is successful, or false if otherwise throws illegalargumentexception - if the argument is null illegalstateexception - if the connection to the health data store is invalid or a remote-invocation error occurs on the connection securityexception - only an application that has created a device profile can change the custom name of the device if other applications try to change the device's custom name, this exception occurs since 1 0 0

SubGNB

[{"title":"overview","url":"/health/data"},{"title":"documentation","url":"/health/data/overview.html","access_profile":""}] [{"title":"overview","url":"/health/sensor"},{"title":"documentation","url":"/health/sensor/overview.html","access_profile":""}] [{"title":"overview","url":"/health/accessory"},{"title":"documentation","url":"/health/accessory/overview.html","access_profile":""}] [{"title":"overview","url":"/health/research"},{"title":"documentation","url":"/health/research/overview.html","access_profile":""}] [{"title":"documentation","url":"/health/android/overview.html","access_profile":""},{"title":"api reference","url":"/health/android/data/api-reference/overview.html"}]

HealthData

overviewpackageclasstreedeprecatedindex com samsung android sdk healthdata class healthdata java lang object com samsung android sdk healthdata healthdata all implemented interfaces parcelable public final class healthdata extends object implements parcelable this class presents a health data object for a specified health data type, e g the blood pressure or weight handling health data quantitative and qualitative values of health data can be specified through this class set each property value of health data based on its data type definition and manage it with healthdataresolver the data type definitions are described in samsung health's data types example see inserting health data since 1 0 0 constructor summary constructors constructor and description healthdata creates a health data instance method summary all methods instance methods concrete methods modifier and type method and description void clear clears values of all properties in the health data object byte[] getblob string key gets a blob value associated with a given property double getdouble string key gets a double value associated with a given property float getfloat string key gets a float value associated with a given property inputstream getinputstream string key gets an inputstream associated with a given property int getint string key gets an integer value associated with a given property long getlong string key gets a long value associated with a given property string getsourcedevice gets the source device which provides health data string getstring string key gets a text value associated with a given property string getuuid gets the unique id of the object void putblob string key, byte[] value inserts a blob value into a given property of the health data object void putdouble string key, double value puts a double value into the given property of the health data object void putfloat string key, float value puts a float value into a given property of the health data object void putinputstream string key, inputstream value inserts an inputstream into a given property of the health data object void putint string key, int value puts an integer value into a given property of the health data object void putlong string key, long value puts a long value into a given property of the health data object void putnull string key inserts a null value into a given property of the health data object void putstring string key, string value puts a text value into a given property of the health data object void setsourcedevice string deviceuuid sets the source device which provides health data constructor detail healthdata public healthdata creates a health data instance since 1 0 0 method detail getuuid public string getuuid gets the unique id of the object use getstring to get the data's uuid from a result in healthdataresolver aggregateresult healthdataresolver readresult returns the unique id contained in the object throws unsupportedoperationexception - if the health data is in healthdataresolver aggregateresult or healthdataresolver readresult since 1 0 0 getsourcedevice public string getsourcedevice gets the source device which provides health data returns the id of the source device which provides health data since 1 0 0 setsourcedevice public void setsourcedevice string deviceuuid sets the source device which provides health data it's mandatory to set the source device for created health data parameters deviceuuid - the source device id which provides health data since 1 0 0 getstring public string getstring string key gets a text value associated with a given property parameters key - the specific property name of health data that its value type is text e g healthconstants exercise comment returns the text value, or null if the health data object does not have the given property since 1 0 0 getfloat public float getfloat string key gets a float value associated with a given property parameters key - the specific property name of health data that its value type is float e g healthconstants exercise distance returns the float value, or 0 0f if the health data object does not have the given property since 1 0 0 getdouble public double getdouble string key gets a double value associated with a given property parameters key - the specific property name of health data that its value type is double returns the double value, or 0 0d if the desired type does not exist for the given property since 1 0 0 getlong public long getlong string key gets a long value associated with a given property parameters key - the specific property name of health data that its value type is long e g healthconstants exercise duration returns the long value, or 0l if the desired type does not exist for the given property since 1 0 0 getint public int getint string key gets an integer value associated with a given property parameters key - the specific property name of health data that its value type is integer e g healthconstants bloodglucose measurement_type returns the integer value, or 0 if the desired type does not exist for the given property since 1 0 0 getblob public byte[] getblob string key gets a blob value associated with a given property parameters key - the specific property name of health data that its value type is blob e g healthconstants exercise live_data returns the blob value, or null if the desired type does not exist for the given property since 1 0 0 getinputstream public inputstream getinputstream string key gets an inputstream associated with a given property parameters key - the specific property name of health data that its value type is file e g healthconstants healthdocument document returns the inputstream object, or null if the desired type does not exist for the given property since 1 3 0 putint public void putint string key, int value puts an integer value into a given property of the health data object the existing value for the property is replaced parameters key - the health data's specific property name that its value type is integer e g healthconstants bloodglucose measurement_type value - the integer value for the given property since 1 0 0 putlong public void putlong string key, long value puts a long value into a given property of the health data object the existing value for the property is replaced parameters key - the health data's specific property name that its value type is long e g healthconstants exercise duration value - the long value for the given property since 1 0 0 putfloat public void putfloat string key, float value puts a float value into a given property of the health data object the existing value for the property is replaced parameters key - the health data's specific property name that its value type is float e g healthconstants exercise distance value - the float value for the given property since 1 0 0 putdouble public void putdouble string key, double value puts a double value into the given property of the health data object the existing value for the property is replaced parameters key - the health data's specific property name that its value type is double value - the double value for the given property since 1 0 0 putstring public void putstring string key, string value puts a text value into a given property of the health data object the existing value for the property is replaced parameters key - the health data's specific property name that its value type is text e g healthconstants exercise comment value - the text value for the given property since 1 0 0 putblob public void putblob string key, byte[] value inserts a blob value into a given property of the health data object the existing value for the property is replaced parameters key - the health data's specific property name that its value type is blob e g healthconstants exercise live_data value - the blob value for the given property since 1 0 0 putinputstream public void putinputstream string key, inputstream value inserts an inputstream into a given property of the health data object the existing value for the property is replaced parameters key - the health data's specific property name that its value type is file e g healthconstants healthdocument document value - the inputstream object for the given property since 1 3 0 putnull public void putnull string key inserts a null value into a given property of the health data object the existing value for the property is replaced parameters key - the health data's specific property name since 1 1 0 clear public void clear clears values of all properties in the health data object since 1 0 0