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

Class PropertiesService

允許指令碼將簡單資料儲存在鍵/值組合中，範圍限定為一個指令碼、一個指令碼的使用者，或使用外掛程式的一個文件。屬性無法在指令碼間共用。如要進一步瞭解何時使用每種屬性類型，請參閱「屬性」服務指南。

// Sets three properties of different types.
const documentProperties = PropertiesService.getDocumentProperties();
const scriptProperties = PropertiesService.getScriptProperties();
const userProperties = PropertiesService.getUserProperties();

documentProperties.setProperty('DAYS_TO_FETCH', '5');
scriptProperties.setProperty(
    'SERVER_URL',
    'http://www.example.com/MyWeatherService/',
);
userProperties.setProperty('DISPLAY_UNITS', 'metric');

方法

方法	傳回類型	簡短說明
`getDocumentProperties()`	`Properties`	取得屬性儲存庫 (僅限此指令碼)，所有使用者都能在開啟的文件、試算表或表單中存取。
`getScriptProperties()`	`Properties`	取得所有使用者都能存取的資源儲存庫，但僅限於這個指令碼。
`getUserProperties()`	`Properties`	取得只有目前使用者可存取的屬性儲存庫，且只能在這個指令碼中存取。

內容詳盡的說明文件

`getDocumentProperties()`

取得屬性儲存庫 (僅限此指令碼)，所有使用者都能在開啟的文件、試算表或表單中存取。只有在指令碼以外掛程式形式發布及執行，或繫結至 Google 檔案類型時，才能使用這項功能。如果無法取得文件屬性，這個方法會傳回 null。指令碼建立的文件屬性無法在該指令碼之外存取，即使是其他指令碼存取相同文件也一樣。

回攻員

Properties：這個指令碼專用的屬性儲存庫，目前文件的所有使用者都能存取；如果指令碼不是外掛程式，或未繫結至 Google Workspace 檔案，則為 null

`getScriptProperties()`

取得所有使用者都能存取的資源儲存庫，但僅限於這個指令碼。

回攻員

Properties：所有指令碼使用者都能存取的屬性儲存庫

`getUserProperties()`

取得只有目前使用者可存取的屬性儲存庫，且只能在這個指令碼中存取。

回攻員

Properties：只有指令碼的目前使用者才能存取的屬性儲存庫