UserProperties
已淘汰。這個類別已淘汰,不應用於新的指令碼。
使用者屬性是個別使用者的鍵/值組合。以使用者為範圍指定使用者屬性;任何 在使用者身分下執行的指令碼,只能存取該使用者的使用者屬性。
已淘汰的方法
方法 | 傳回類型 | 簡短說明 |
---|---|---|
|
| 刪除所有屬性。 |
|
| 使用指定鍵刪除屬性。 |
| String[] | 取得所有可用的金鑰。 |
| Object | 一次取得所有可用的屬性。 |
| String | 傳回與所提供鍵相關聯的值;如果沒有這些值,則傳回空值。 |
|
| 大量設定從指定物件取得的所有屬性。 |
|
| 大量設定從指定物件取得的所有屬性。 |
|
| 使用提供的鍵保留指定值中的指定值。 |
已淘汰的方法
deleteAllProperties()
deleteAllProperties()
已淘汰。這個函式已淘汰,不應用於新的指令碼。
刪除所有屬性。
UserProperties.deleteAllProperties();
回攻員
:這個物件,用於鏈結UserProperties
另請參閱
deleteProperty(key)
deleteProperty(key)
已淘汰。這個函式已淘汰,不應用於新的指令碼。
使用指定鍵刪除屬性。
UserProperties.deleteProperty('special');
參數
名稱 | 類型 | 說明 |
---|---|---|
key | String | 待刪除屬性的鍵 |
回攻員
:這個物件,用於鏈結UserProperties
另請參閱
getKeys()
getKeys()
已淘汰。這個函式已淘汰,不應用於新的指令碼。
取得所有可用的金鑰。
回攻員
String[]
getProperties()
getProperties()
已淘汰。這個函式已淘汰,不應用於新的指令碼。
一次取得所有可用的屬性。
這會提供副本,而非即時檢視畫面,因此變更傳回物件的屬性時並不會 然後在儲存空間中更新文件,反之亦然。
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. var animalSounds = UserProperties.getProperties(); // Logs: // A chicken goes cluck! // A cow goes moo! // A sheep goes baa! for(var kind in animalSounds) { Logger.log("A %s goes %s!", kind, animalSounds[kind]); }
回攻員
Object
:包含鍵/值組合的屬性副本
getProperty(key)
getProperty(key)
已淘汰。這個函式已淘汰,不應用於新的指令碼。
傳回與所提供鍵相關聯的值;如果沒有這些值,則傳回空值。
var specialValue = UserProperties.getProperty('special');
參數
名稱 | 類型 | 說明 |
---|---|---|
key | String | 待擷取值的鍵 |
回攻員
String
:與鍵相關聯的值
另請參閱
setProperties(properties)
setProperties(properties)
已淘汰。這個函式已淘汰,不應用於新的指令碼。
大量設定從指定物件取得的所有屬性。
UserProperties.setProperties({special: 'sauce', 'meaning': 42});
參數
名稱 | 類型 | 說明 |
---|---|---|
properties | Object | 包含要設定屬性的物件。 |
回攻員
:這個物件,用於鏈結UserProperties
另請參閱
setProperties(properties, deleteAllOthers)
setProperties(properties, deleteAllOthers)
已淘汰。這個函式已淘汰,不應用於新的指令碼。
大量設定從指定物件取得的所有屬性。
// This deletes all other properties UserProperties.setProperties({special: 'sauce', 'meaning': 42}, true);
參數
名稱 | 類型 | 說明 |
---|---|---|
properties | Object | 包含要設定屬性的物件。 |
deleteAllOthers | Boolean | 是否要刪除所有現有的資源 |
回攻員
:這個物件,用於鏈結UserProperties
另請參閱
setProperty(key, value)
setProperty(key, value)
已淘汰。這個函式已淘汰,不應用於新的指令碼。
使用提供的鍵保留指定值中的指定值。與這個項目相關聯的任何現有值 鍵。
UserProperties.setProperty('special', 'sauce');
參數
名稱 | 類型 | 說明 |
---|---|---|
key | String | 屬性鍵 |
value | String | 要與鍵建立關聯的值 |
回攻員
:這個物件,用於鏈結UserProperties