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 - 僅適用於這個指令碼的屬性儲存空間，目前文件的所有使用者都能存取，或 null (如果指令碼不是外掛程式，也不是繫結至 Google Workspace 檔案)。

---

getScriptProperties()

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

回攻員

Properties：指令碼的所有使用者都能存取的屬性存放區。

---

getUserProperties()

取得只有目前或有效使用者可以存取的屬性儲存區，且僅限於這個指令碼。

回攻員

Properties：屬性商店，只有指令碼的現任或有效使用者可以存取。