Class UserProperties
Page Summary
This class is deprecated and should not be used in new scripts.
User Properties are key-value pairs unique to a user.
User Properties are scoped per user, meaning a script can only access properties for the user running the script.
Deprecated. This class is deprecated and should not be used in new scripts.
User Properties are key-value pairs unique to a user. User Properties are scoped per user; anyscript running under the identity of a user can access User Properties for that user only.
Deprecated methods
| Method | Return type | Brief description |
|---|---|---|
| | Deletes all properties. |
| | Deletes the property with the given key. |
| String[] | Get all of the available keys. |
| Object | Get all of the available properties at once. |
| String | Returns the value associated with the provided key, or null if there is no such value. |
| | Bulk-sets all the properties drawn from the given object. |
| | Bulk-sets all the properties drawn from the given object. |
| | Persists the specified in value with the provided key. |
Deprecated methods
deleteAllProperties()
deleteAllProperties() Deprecated. This function is deprecated and should not be used in new scripts.
Deletes all properties.
UserProperties .deleteAllProperties();
Return
User
See also
deleteProperty(key)
deleteProperty(key) Deprecated. This function is deprecated and should not be used in new scripts.
Deletes the property with the given key.
UserProperties .deleteProperty('special');
Parameters
| Name | Type | Description |
|---|---|---|
key | String | key for property to delete |
Return
User
See also
getKeys()
getKeys() Deprecated. This function is deprecated and should not be used in new scripts.
Get all of the available keys.
Return
String[]
getProperties()
getProperties() Deprecated. This function is deprecated and should not be used in new scripts.
Get all of the available properties at once.
This gives a copy, not a live view, so changing the properties on the returned object won'tupdate them in storage and vice versa.
UserProperties .setProperties({"cow":"moo","sheep":"baa","chicken":"cluck"});// Logs "A cow goes: moo"Logger.log("A cow goes: %s",UserProperties.getProperty("cow"));// This makes a copy. Any changes that happen here will not// be written back to properties.varanimalSounds=UserProperties.getProperties();// Logs:// A chicken goes cluck!// A cow goes moo!// A sheep goes baa!for(varkindinanimalSounds){Logger.log("A %s goes %s!",kind,animalSounds[kind]);}
Return
Object — a copy of the properties containing key-value pairs
getProperty(key)
getProperty(key) Deprecated. This function is deprecated and should not be used in new scripts.
Returns the value associated with the provided key, or null if there is no such value.
constspecialValue=UserProperties.getProperty('special');
Parameters
| Name | Type | Description |
|---|---|---|
key | String | key for the value to retrieve |
Return
String — the value associated with the key
See also
setProperties(properties)
setProperties(properties) Deprecated. This function is deprecated and should not be used in new scripts.
Bulk-sets all the properties drawn from the given object.
UserProperties .setProperties({special:'sauce','meaning':42});
Parameters
| Name | Type | Description |
|---|---|---|
properties | Object | an object containing the properties to set. |
Return
User
See also
setProperties(properties, deleteAllOthers)
setProperties(properties, deleteAllOthers) Deprecated. This function is deprecated and should not be used in new scripts.
Bulk-sets all the properties drawn from the given object.
// This deletes all other propertiesUserProperties.setProperties({special:'sauce','meaning':42},true);
Parameters
| Name | Type | Description |
|---|---|---|
properties | Object | an object containing the properties to set. |
delete | Boolean | whether to delete all existing properties. |
Return
User
See also
setProperty(key, value)
setProperty(key, value) Deprecated. This function is deprecated and should not be used in new scripts.
Persists the specified in value with the provided key. Any existing value associated with thiskey will be overwritten.
UserProperties .setProperty('special','sauce');
Parameters
| Name | Type | Description |
|---|---|---|
key | String | key for property |
value | String | value to associate with the key |
Return
User
See also
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-12-11 UTC.