本頁面由 Cloud Translation API 翻譯而成。

Class ScriptProperties

已淘汰。這個類別已淘汰，不應用於新的指令碼。

「指令碼屬性」是指令碼在永久儲存空間中儲存的鍵/值組合。指令碼屬性無論執行指令碼的是哪個使用者，每個指令碼都會限定範圍。

已淘汰的方法

方法	傳回類型	簡短說明
`deleteAllProperties()`	`ScriptProperties`	刪除所有屬性。
`deleteProperty(key)`	`ScriptProperties`	使用指定鍵刪除屬性。
`getKeys()`	`String[]`	取得所有可用的金鑰。
`getProperties()`	`Object`	一次取得所有可用的屬性。
`getProperty(key)`	`String`	傳回與所提供鍵相關聯的值；如果沒有這些值，則傳回空值。
`setProperties(properties)`	`ScriptProperties`	大量設定從指定物件取得的所有屬性。
`setProperties(properties, deleteAllOthers)`	`ScriptProperties`	大量設定從指定物件取得的所有屬性。
`setProperty(key, value)`	`ScriptProperties`	使用提供的鍵保留指定值中的指定值。

已淘汰的方法

`deleteAllProperties()`

已淘汰。這個函式已淘汰，不應用於新的指令碼。

刪除所有屬性。

ScriptProperties.deleteAllProperties();

回攻員

ScriptProperties：這個物件，用於鏈結

另請參閱

deleteProperty(key)

`deleteProperty(key)`

已淘汰。這個函式已淘汰，不應用於新的指令碼。

使用指定鍵刪除屬性。

ScriptProperties.deleteProperty('special');

參數

名稱	類型	說明
`key`	`String`	待刪除屬性的鍵

回攻員

ScriptProperties：這個物件，用於鏈結

另請參閱

deleteAllProperties()

`getKeys()`

已淘汰。這個函式已淘汰，不應用於新的指令碼。

取得所有可用的金鑰。

回攻員

String[]

`getProperties()`

已淘汰。這個函式已淘汰，不應用於新的指令碼。

一次取得所有可用的屬性。

這會提供副本，而非即時檢視畫面，因此變更傳回物件的屬性時並不會然後在儲存空間中更新文件，反之亦然。

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.
var animalSounds = ScriptProperties.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)`

已淘汰。這個函式已淘汰，不應用於新的指令碼。

傳回與所提供鍵相關聯的值；如果沒有這些值，則傳回空值。

var specialValue = ScriptProperties.getProperty('special');

參數

名稱	類型	說明
`key`	`String`	待擷取值的鍵

回攻員

String：與鍵相關聯的值

另請參閱

setProperty(key, value)

`setProperties(properties)`

已淘汰。這個函式已淘汰，不應用於新的指令碼。

大量設定從指定物件取得的所有屬性。

ScriptProperties.setProperties({special: 'sauce', 'meaning': 42});

參數

名稱	類型	說明
`properties`	`Object`	包含要設定屬性的物件。

回攻員

ScriptProperties：這個物件，用於鏈結

另請參閱

setProperty(key, value)

`setProperties(properties, deleteAllOthers)`

已淘汰。這個函式已淘汰，不應用於新的指令碼。

大量設定從指定物件取得的所有屬性。

// This deletes all other properties
ScriptProperties.setProperties({special: 'sauce', 'meaning': 42}, true);

參數

名稱	類型	說明
`properties`	`Object`	包含要設定屬性的物件。
`deleteAllOthers`	`Boolean`	是否要刪除所有現有的資源

回攻員

ScriptProperties：這個物件，用於鏈結

另請參閱

setProperty(key, value)

`setProperty(key, value)`

已淘汰。這個函式已淘汰，不應用於新的指令碼。

使用提供的鍵保留指定值中的指定值。與這個項目相關聯的任何現有值鍵。

ScriptProperties.setProperty('special', 'sauce');

參數

名稱	類型	說明
`key`	`String`	屬性鍵
`value`	`String`	要與鍵建立關聯的值

回攻員

ScriptProperties：這個物件，用於鏈結

另請參閱

getProperty(key)