Class ScriptProperties
Stay organized with collections
Save and categorize content based on your preferences.
AI-generated Key Takeaways
-
The ScriptProperties class is deprecated and should not be used in new scripts.
-
Script Properties store key-value pairs persistently for a script, independent of the user running it.
-
Deprecated methods include functions to delete, get, and set properties.
Deprecated. This class is deprecated and should not be used in new scripts.
Script Properties are key-value pairs stored by a script in a persistent store. Script Properties are scoped per script, regardless of which user runs the script.
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.
ScriptProperties .deleteAllProperties();
Return
(削除) Script
See also
-
(削除) deleteProperty(key) (削除ここまで)
(削除) deleteProperty(key) (削除ここまで)
deleteProperty(key) (削除ここまで)Deprecated. This function is deprecated and should not be used in new scripts.
Deletes the property with the given key.
ScriptProperties .deleteProperty('special');
Parameters
| Name | Type | Description |
|---|---|---|
key | String | key for property to delete |
Return
(削除) Script
See also
-
(削除) deleteAll (削除ここまで)Properties()
(削除) 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't update them in storage and vice versa.
ScriptProperties .setProperties({ "cow":"moo", "sheep":"baa", "chicken":"cluck" }); // Logs "A cow goes: moo" Logger.log("A cow goes: %s",ScriptProperties.getProperty("cow")); // This makes a copy. Any changes that happen here will not // be written back to properties. varanimalSounds=ScriptProperties.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=ScriptProperties.getProperty('special');
Parameters
| Name | Type | Description |
|---|---|---|
key | String | key for the value to retrieve |
Return
String — the value associated with the key
See also
-
(削除) setProperty(key, value) (削除ここまで)
(削除) 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.
ScriptProperties .setProperties({special:'sauce','meaning':42});
Parameters
| Name | Type | Description |
|---|---|---|
properties | Object | an object containing the properties to set. |
Return
(削除) Script
See also
-
(削除) setProperty(key, value) (削除ここまで)
(削除) 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 properties ScriptProperties.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
(削除) Script
See also
-
(削除) setProperty(key, value) (削除ここまで)
(削除) 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 this key will be overwritten.
ScriptProperties .setProperty('special','sauce');
Parameters
| Name | Type | Description |
|---|---|---|
key | String | key for property |
value | String | value to associate with the key |
Return
(削除) Script
See also
-
(削除) getProperty(key) (削除ここまで)